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 Packaging для получения дополнительной информации.

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

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