Зачем нужен __all__

В файле __init__.py используется список __all__ для определения, какие элементы будут экспортироваться при использовании конструкции from package import *.

Он ограничивает набор имён, которые считаются «публичным» интерфейсом пакета при звёздочном импорте.

Список __all__ в файле __init__.py управляет тем, какие имена пакета попадут в пространство имён импортирующего модуля при использовании конструкции from package import *.

Если __all__ определён, при звёздочном импорте будут экспортированы только имена, перечисленные в этом списке, остальные объекты пакета при таком импорте не попадут в пространство имён.

Если список __all__ не задан, Python по умолчанию импортирует все имена, не начинающиеся с подчёркивания, что может «засорять» пространство имён и раскрывать внутренние детали реализации.

Важно, что __all__ влияет только на поведение конструкции from package import * и не мешает явно импортировать любые другие объекты через import package.module или from package.module import name.