distutils
— Створення та встановлення модулів Python¶
distutils
не підтримується, планується видалення для Python 3.12. Перегляньте запис Що нового для отримання додаткової інформації.
Пакет distutils
забезпечує підтримку створення та встановлення додаткових модулів у інсталяцію Python. Нові модулі можуть бути або 100%-pure Python, або можуть бути модулями розширення, написаними на C, або можуть бути колекціями пакетів Python, які включають модулі, закодовані як на Python, так і на C.
Більшість користувачів Python не захочуть використовувати цей модуль напряму, натомість скористаються крос-версійними інструментами, які підтримує Python Packaging Authority. Зокрема, setuptools є вдосконаленою альтернативою distutils
, яка забезпечує:
підтримка оголошення залежностей проекту
додаткові механізми для конфігурації файлів, які слід включати в вихідні версії (включаючи плагіни для інтеграції з системами контролю версій)
можливість оголошувати «точки входу» проекту, які можна використовувати як основу для систем плагінів додатків
можливість автоматично генерувати виконувані файли командного рядка Windows під час встановлення замість необхідності їх попереднього збирання
узгоджена поведінка в усіх підтримуваних версіях Python
Рекомендований інсталятор pip запускає всі сценарії setup.py
з setuptools
, навіть якщо сам сценарій імпортує лише distutils
. Для отримання додаткової інформації зверніться до Посібника користувача з пакування Python.
Для переваг авторів інструментів пакування та користувачів, які прагнуть глибшого розуміння деталей поточної системи пакування та розповсюдження, документація користувача на основі distutils
та посилання на API залишаються доступними: