Introducción:
Hola compañeros de Internet, sean bienvenidos a Mi Diario Python, el mejor blog para Aprender Python.
En el día de hoy veremos un tema muy interesante y dispensable para los programadores Python. Veremos el empaquetamiento de nuestros módulos para que otros puedan utilizarlos.
Empaquetamiento:
En Python, el término empaquetamiento se refiere a poner módulos que has escrito en un formato estándar, para que así otros programadores puedan instalarlo y utilizarlo con facilidad. Esto involucra el uso de los módulos setuptools y distutils.
El primer paso en el empaquetamiento es organizar correctamente los archivos existentes. Debemos ubicar todos los archivo que queremos en una biblioteca en el mismo directorio principal. Este directorio también debe contener un archivo llamado __init__.py, que puede estar en blanco pero debe estar presente en el directorio.
Este directorio va con otro directorio que contiene el léeme y la licencia, como también un archivo de suma importancia llamado setup.py.
A continuación te mostrare un ejemplo de la estrutura de los archivos:
PyPackage/ LICENSE.txt README.txt setup.py package/ __init__.py script.py script2.py
En la carpeta "package" irán todos los archivos del modulo. Los archivos con las clases y métodos.
Lo siguiente es escribir el archivo setup.py. Este contiene la información necesaria para ensamblar el paquete para así subirlo a PyPi e instalarlo con pip.
A continuación te mostrare un ejemplo de como podrías escribir tu archivo setup.py.
from distutils.core import setup # Importamos setup setup( name="Package", # Nombre del paquete version="0.1dev", # Version del modulo packages=['package'], # Carpeta con los archivos del módulo license="MIT", long_description=open('README.txt').read(), # Descripción. Utilizamos el archivo 'README' )
Esto es como podríamos escribir la información del modulo.
Luego de crear el setup.py debemos crear una distribución binaria. Esto lo logramos ejecutando el comando py setup.py bdist_wininst. Al finalizar utilizamos el comando py setup.py install para instalar el modulo y poder utilizarlo en cualquier archivo y directorio.
Puedes probar importando tu modulo:
import package
Bueno, cree que eso es todo por ahora.
¿Alguna duda? No olvides dejar tu comentario.
Mi nombre es Luis, y fue un placer compartir mis conocimientos con todos ustedes.