Документация Python неофициальный перевод

28.1. distutils – Сборка и установка модулей Pythondistutils – Building and installing Python modules

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

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

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

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

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