¿No se requiere __init__.py para los paquetes en Python 3.3+

Estoy usando Python 3.5.1. Leí el documento y la sección del paquete aquí: https://docs.python.org/3/tutorial/modules.html#packages

Ahora, tengo la siguiente estructura:

/home/wujek/Playground/a/b/module.py

module.py:

class Foo:
    def __init__(self):
        print('initializing Foo')

Ahora, mientras que en /home/wujek/Playground:

~/Playground $ python3
>>> import a.b.module
>>> a.b.module.Foo()
initializing Foo
<a.b.module.Foo object at 0x100a8f0b8>

Del mismo modo, ahora en casa, supercarpeta de Playground:

~ $ PYTHONPATH=Playground python3
>>> import a.b.module
>>> a.b.module.Foo()
initializing Foo
<a.b.module.Foo object at 0x10a5fee10>

En realidad, puedo hacer todo tipo de cosas:

~ $ PYTHONPATH=Playground python3
>>> import a
>>> import a.b
>>> import Playground.a.b

¿Por qué funciona esto? Pensé que tenía que haber __init__.pyarchivos (los vacíos funcionarían) en ambos ay bpara module.pypoder ser importados cuando la ruta de Python apunta a la Playgroundcarpeta.

Esto parece haber cambiado desde Python 2.7:

~ $ PYTHONPATH=Playground python
>>> import a
ImportError: No module named a
>>> import a.b
ImportError: No module named a.b
>>> import a.b.module
ImportError: No module named a.b.module

Con __init__.pyen ambos ~/Playground/ay ~/Playground/a/bfunciona bien.

Python 3.3+ tiene paquetes de espacio de nombres implícitos que le permiten crear paquetes sin un __init__.pyarchivo.

Permitir paquetes de espacio de nombres implícitos significa que el requisito de proporcionar un __init__.pyarchivo puede eliminarse por completo y verse afectado ....

La antigua manera con __init__.pyarchivos todavía funciona como en Python 2.

IMPORTANTE

La respuesta de @ Mike es correcta pero demasiado imprecisa. Es cierto que Python 3.3+ admite paquetes de espacio de nombres implícitos que le permite crear un paquete sin un __init__.pyarchivo.

Sin embargo, esto SOLO se aplica a los archivos VACÍOS__init__.py . Por lo tanto, los archivos VACÍOS__init__.py ya no son necesarios y pueden omitirse. Si desea ejecutar un script de inicialización particular cuando se importa el paquete o cualquiera de sus módulos o subpaquetes, aún necesita un __init__.pyarchivo. Esta es una excelente respuesta de Stack Overflow para __init__.pysaber por qué desea utilizar un archivo para realizar una inicialización adicional en caso de que se pregunte por qué esto es de alguna manera útil.

Ejemplo de estructura de directorio:

  parent_package/
     __init__.py            <- EMPTY, NOT NECESSARY in Python 3.3+
     child_package/
          __init__.py       <- STILL REQUIRED if you want to run an initialization script
          child1.py
          child2.py
          child3.py

parent_package/child_package/__init__.py:

print("from parent")

EJEMPLOS

Los siguientes ejemplos demuestran cómo se ejecuta el script de inicialización cuando child_packagese importa uno o sus módulos.

Ejemplo 1 :

from parent_package import child_package  # prints "from parent"

Ejemplo 2 :

from parent_package.child_package import child1  # prints "from parent"

Si tiene setup.pyen su proyecto y lo usa find_packages()dentro de él, es necesario tener un __init__.pyarchivo en cada directorio para que los paquetes se encuentren automáticamente.

Los paquetes solo se reconocen si incluyen un __init__.pyarchivo

UPD : si desea usar paquetes de espacio de nombres implícitos sin __init__.pytener que usarlos find_namespace_packages()en su lugar

Docs

Yo diría que uno debería omitir el __init__.pyúnico si quiere tener el paquete de espacio de nombres implícito . Si no sabe lo que significa, probablemente no lo quiera y, por lo tanto, debe continuar utilizando el __init__.pypar en Python 3.