distutils — Установка и создание модулей Python

distutils устарела, и её удаление запланировано для Python 3.12. См. запись Что нового для получения дополнительной информации.

Пакет distutils предоставляет поддержку для создания и установки дополнительных модулей в установку Python. Новые модули могут быть 100%-чистыми модулями Python, или расширенными модулями, написанными на C, или коллекциями пакетов Python, которые включают модули, написанные как на Python, так и на C.

Большинство пользователей Python не захотят использовать этот модуль напрямую, а вместо этого воспользуются инструментами кросс-версионной поддержки, поддерживаемыми Python Packaging Authority. В частности, setuptools — это улучшенная альтернатива distutils, которая предоставляет:

• поддержку объявления зависимостей проекта
• дополнительные механизмы для настройки файлов, которые нужно включить в выпуск исходного кода (включая плагины для интеграции с системами управления версиями)
• возможность объявления «точек входа» проекта, которые могут использоваться в качестве основы для систем плагинов приложения
• возможность автоматического генерации исполняемых файлов командной строки Windows во время установки, вместо необходимости предварительного их построения
• согласованное поведение во всех поддерживаемых версиях Python

Рекомендуемый установщик pip запускает все setup.py скрипты с setuptools, даже если сам скрипт только импортирует distutils. Обратитесь к Руководству пользователя по пакетам Python для получения дополнительной информации.

Для пользы авторов инструментов пакетирования и пользователей, желающих глубже понять детали текущей системы пакетирования и распространения, остаётся доступной документация и справочник API по устаревшему distutils:

• Установка модулей Python (старая версия)
• Распространение модулей Python (старая версия)