Чи не потрібен __init__.py для пакетів в Python 3.3+

Я використовую Python 3.5.1. Я читав документ і розділ пакета тут: https://docs.python.org/3/tutorial/modules.html#packages

Тепер у мене є така структура:

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

module.py:

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

Зараз, перебуваючи в /home/wujek/Playground:

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

Аналогічно, зараз удома, суперпапка Playground:

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

Насправді я можу робити всілякі речі:

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

Чому це працює? Я хоч повинні були бути __init__.pyфайли (порожні працюватимуть) і в, aі bдля того, module.pyщоб вони були важливими, коли шлях Python вказує на Playgroundпапку?

Здається, це змінилося з 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

І __init__.pyв обох, ~/Playground/aі ~/Playground/a/bце чудово працює.

У Python 3.3+ є непрямі пакети просторів імен, які дозволяють створювати пакунки без __init__.pyфайлу.

Дозволення неявних пакетів простору імен означає, що вимога надати __init__.pyфайл може бути повністю відхилена та постраждала.

Старий спосіб з __init__.pyфайлами як і раніше працює, як у Python 2.

ВАЖЛИВО

@ Відповідь Майка правильна, але занадто неточна. Це правда, що Python 3.3+ підтримує непрямі пакети просторів імен, що дозволяє йому створювати пакет без __init__.pyфайлу.

Це, однак, застосовується ТОЛЬКО__init__.py до файлів EMPTY . Отже файли EMPTY__init__.py більше не потрібні і їх можна опустити. Якщо ви хочете запустити певний сценарій ініціалізації, коли пакет або будь-який з його модулів або підпакетів імпортується, вам все одно потрібен __init__.pyфайл. Це чудова відповідь переповнення стека, чому ви хочете використовувати __init__.pyфайл для подальшої ініціалізації, якщо вам цікаво, чому це в будь-якому разі корисно.

Приклад структури каталогів:

  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")

ПРИКЛАДИ

Наведені нижче приклади демонструють, як виконується сценарій ініціалізації при child_packageімпорті або одного з його модулів.

Приклад 1 :

from parent_package import child_package  # prints "from parent"

Приклад 2 :

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

Якщо у вас є setup.pyпроект і ви використовуєте find_packages()в ньому, необхідно мати __init__.pyфайл у кожному каталозі, щоб пакунки могли бути автоматично знайдені.

Пакети розпізнаються лише у тому випадку, якщо вони містять __init__.pyфайл

UPD : Якщо ви хочете використовувати неявні пакети простору імен без __init__.pyвас просто використовувати find_namespace_packages()замість

Документи

Я б сказав, що слід опустити __init__.pyєдиний, якщо хочеться мати пакет неявного простору імен . Якщо ви не знаєте, що це означає, ви, мабуть, цього не хочете, і тому вам слід продовжувати використовувати __init__.pyнавіть у Python 3.