distutils — Сборка и установка Python модулей


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

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

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

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

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