В Python, какова цель переменной `__all__` в модуле и как она контролирует, что импортируется при использовании `from module import *`?

Что такое __all__

__all__ — это список, определённый на уровне модуля, который явно контролирует, какие имена экспортируются при выполнении from module import *.

Как это работает

Когда __all__ определён, при wildcard импорте импортируются только имена, указанные в этом списке. Любое имя, не включённое в __all__, рассматривается как приватное и будет проигнорировано.

При выполнении from mymodule import * импортируются только public_func и PublicClass.

Что происходит без __all__

Если __all__ не определён, Python по умолчанию экспортирует все имена, которые не начинаются с подчёркивания. Это делает публичный API модуля менее предсказуемым и сложнее поддерживаемым.

Ключевые моменты

• __all__ — это хорошая практика для определения чёткого и явного публичного API
• Он защищает внутренние вспомогательные функции от случайного импорта
• Он не влияет на прямые импорты вроде from module import _helper
• Он улучшает читаемость и поддерживаемость больших модулей