API пакета в Python. В __ init __. py? [закрытый]

Наиболее распространенный выбор - использовать __ init __. Py - стоит переходить к отдельному модулю (или более), только если он достаточно сложен, чтобы это оправдать (тогда это будет не так уж и много фасада ;-) или, что более важно, если вы предоставите альтернативные API (например, упрощенный с ограниченной функциональностью, но с большей простотой использования, и более богатый / сложный, например), в котором случай с использованием отдельных модулей позволяет лучше организовать вещи.

Чтобы сообщить пользователям пакета, что они не должны напрямую импортировать другие модули, не забудьте указать свои «частные внутренние модули реализации» с начальным подчеркиванием : _core.py , а не core.py и так далее. Это соглашение всегда используется в Python для отделения общедоступных API-интерфейсов от деталей внутренней реализации, и оно стоит (действительно небольших) усилий по его реализации!