¿Como funciona __init__.py?

[hielasangre]

Cuando empiezas a desarrollar proyectos más grandes en Python, es común encontrarse con un archivo llamado __init__.py. Este pequeño archivo cumple un papel importante en cómo Python estructura y organiza paquetes.

¿Qué es __init__.py?

Es un archivo especial que se coloca dentro de un directorio para indicar que dicho directorio debe ser tratado como un paquete de Python. Antes de Python 3.3, su presencia era obligatoria para que Python pudiera importar correctamente los módulos dentro del directorio.

A partir de Python 3.3, se introdujeron los namespace packages, y el archivo dejó de ser obligatorio. Sin embargo, aún se recomienda su uso para mantener el orden, compatibilidad y control del comportamiento de un paquete.

¿Para qué sirve?

El archivo __init__.py puede usarse para:

• Inicializar código: Ejecutar instrucciones cuando se importa el paquete.
• Exponer funciones o clases específicas: Para importar directamente sin acceder a submódulos.
• Definir la interfaz pública del paquete: A través de la variable __all__.

Ejemplo práctico

Estructura del paquete:

Código: [Seleccionar]

mi_paquete/
│
├── __init__.py
├── modulo1.py
└── modulo2.py

Contenido de __init__.py:

Código: (python) [Seleccionar]

from .modulo1 import funcion1
from .modulo2 import funcion2

Esto permite importar directamente desde el paquete:

Código: (python) [Seleccionar]

from mi_paquete import funcion1, funcion2

¿Debería usarlo siempre?

Aunque ya no es estrictamente necesario desde Python 3.3, se recomienda incluir __init__.py si:

• Quieres ejecutar código al importar el paquete.
• Deseas controlar qué módulos o funciones estarán disponibles.
• Buscas compatibilidad con versiones anteriores.

Conclusión

El archivo __init__.py es fundamental para crear paquetes modulares y organizados. Comprender su propósito te permitirá estructurar tus proyectos de forma más clara y profesional.

Esto es recomendable especialmente para desarrollos que impliquen modificaciones constantes. Como ejemplo se puede desarrollar una herramienta a la cual se le agregue un dominio, y los módulos tengan diferentes comportamientos, como por ejemplo, uno haga un scaneo con nmap, el otro liste directorios, etc, el limite es lo que quieras desarrollar.