distutils
— Сборка и установка Python модулей
Пакет distutils
обеспечивает поддержку сборки и установки дополнительных
модулей в Python установку. Новые модули могут быть либо на 100% чистым Python,
либо могут быть модулями расширения, написанными на C, либо могут быть
коллекциями пакетов Python, которые включают модули, закодированные как на
Python, так и на C.
Большинство пользователей Python захотят использовать данный модуль напрямую,
но вместо этого будут использовать инструменты для работы с разными версиями,
поддерживаемые Управлением упаковки Python. В частности, setuptools является расширенной
альтернативой distutils
, которая обеспечивает:
- поддержку объявления зависимостей проекта
- дополнительные механизмы для настройки того, какие файлы включать в релизы исходников (включая плагины для интеграции с системами контроля версий)
- возможность объявлять «точки входа» проекта, которые можно использовать в качестве основы для систем плагинов приложений
- возможность автоматически генерировать исполняемые файлы командной строки Windows во время установки вместо необходимости их предварительной сборки
- согласованное поведение во всех поддерживаемых версиях Python
Рекомендуемый установщик pip запускает все сценарии
setup.py
с setuptools
, даже если сам сценарий импортирует только
distutils
. Обратитесь к Руководство пользователя по упаковке Python для получения дополнительной информации.
Для удобства авторов и пользователей инструментов упаковки, стремящихся глубже
понять детали текущей системы упаковки и распространения, устаревшая
пользовательская документация на основе distutils
и справочник по API
остаются доступными: