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


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

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

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

Рекомендуемая программа установки pip запускает все сценарии setup.py из setuptools, даже если сам сценарий импортирует только distutils. Дополнительные сведения см. в разделе Пакетизация Python. Руководство пользователя.

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