Tutorial Python: Crear módulos y paquetes

En Python, un módulo es simplemente un archivo .py que contiene definiciones de funciones, clases y variables. Los paquetes son una forma de organizar módulos relacionados en un directorio, con un fichero especial llamado __init__.py.

Crear un módulo

Crear un módulo es muy sencillo. Solo hace falta escribir algunas funciones o clases en un archivo .py. Por ejemplo, podría crearse un archivo llamado saludo.py con la siguiente función:

# saludo.py

def hola(nombre):
    print(f'Hola, {nombre}')

Puede usarse este módulo en otro archivo Python usando import. Por ejemplo:

# main.py

import saludo

saludo.hola('Mundo')  # Imprime: 'Hola, Mundo'

Crear un paquete

Crear un paquete es un poco más complicado. Será necesario crear un directorio y colocar varios módulos en él. También será necesario crear un archivo __init__.py en el directorio. Este archivo puede estar vacío, pero debe estar presente para que Python reconozca el directorio como un paquete.

Por ejemplo, se puede tener una estructura de directorio como esta:

mi_paquete/
    __init__.py
    saludo.py
    despedida.py

El archivo saludo.py podría ser como este:

# saludo.py

def hola(nombre):
    print(f'Hola, {nombre}')

Y el archivo despedida.py podría ser algo así:

# despedida.py

def adios(nombre):
    print(f'Adiós, {nombre}')

Luego, pueden importarse las funciones del paquete de la siguiente manera:

# main.py

from mi_paquete import saludo, despedida

saludo.hola('Mundo')     # Imprime: 'Hola, Mundo'
despedida.adios('Mundo')  # Imprime: 'Adiós, Mundo'

init.py y la importación de paquetes

El archivo __init__.py es un archivo especial que se ejecuta cuando se importa el paquete. Puede ser usado para inicializar el estado del paquete o para realizar comprobaciones.

También puede usarse para simplificar la forma en que se importan las funciones del paquete. Por ejemplo, podría modificarse el __init__.py de mi_paquete para que sea así:

# __init__.py

from .saludo import hola
from .despedida import adios

Entonces se podrían importar las funciones directamente desde mi_paquete, en lugar de desde los módulos individuales:

# main.py

from mi_paquete import hola, adios

hola('Mundo')  # Imprime: 'Hola, Mundo'
adios('Mundo') # Imprime: 'Adiós, Mundo'

En resumen, los módulos y paquetes son una forma poderosa de organizar el código en Python. Los módulos son útiles para separar las funciones y las clases en archivos individuales, mientras que los paquetes son útiles para organizar conjuntos relacionados de módulos.