Как работает пакетирование библиотек в Python?

Пакеты в Python – это каталоги, содержащие модули (файлы .py) и специальный файл __init__.py. Файл __init__.py сигнализирует Python, что каталог следует рассматривать как пакет. Он может быть пустым или содержать код для инициализации пакета, который выполнится при первом импорте пакета.

Структура пакета:

пакет_примеров/
    __init__.py
    модуль_1.py
    модуль_2.py
    подпакет/
        __init__.py
        модуль_3.py

Импорт осуществляется с использованием точечной нотации:

# Импорт всего пакета
import пакет_примеров

# Импорт конкретного модуля из пакета
import пакет_примеров.модуль_1

# Импорт конкретного объекта из модуля
from пакет_примеров.модуль_1 import класс_или_функция

# Импорт всего содержимого модуля (не рекомендуется для продакшена)
from пакет_примеров.модуль_1 import *

При импорте Python ищет пакеты и модули в каталогах, перечисленных в sys.path.

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

# Внутри пакет_примеров/__init__.py
__all__ = ["модуль_1", "подпакет"]
# При "from пакет_примеров import *", импортируются только модуль_1 и подпакет

При импорте подпакета выполняется __init__.py как основного пакета, так и подпакета.

Пакеты позволяют организовывать код в логические единицы, избегать конфликтов имен и упрощать повторное использование кода.