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 залишаються доступними: