8. Справочник команд¶
Примечание
Этот документ сохраняется исключительно до тех пор, пока документация setuptools на сайте https://setuptools.readthedocs.io/en/latest/setuptools.html не будет независимо охватывать всю соответствующую информацию, включенную сюда в настоящее время.
8.1. Установка модулей: семейство команд install¶
Команда install гарантирует, что команды сборки были выполнены, а затем запускает подкоманды install_lib, install_data и install_scripts.
8.1.1. install_data¶
Эта команда устанавливает все файлы данных, поставляемые с дистрибутивом.
8.1.2. install_scripts¶
Эта команда устанавливает все (Python) скрипты в дистрибутиве.
8.2. Создание исходного дистрибутива: команда sdist¶
Команды шаблона манифеста следующие:
Команда |
Описание |
|---|---|
include pat1 pat2 ... |
включить все файлы, соответствующие любому из перечисленных шаблонов |
exclude pat1 pat2 ... |
исключить все файлы, соответствующие любому из перечисленных шаблонов |
recursive-include dir pat1 pat2 ... |
включить все файлы в dir, соответствующие любому из перечисленных шаблонов |
recursive-exclude dir pat1 pat2 ... |
исключить все файлы в dir, соответствующие любому из перечисленных шаблонов |
global-include pat1 pat2 ... |
включать все файлы в любом месте дерева исходников, соответствующие — и любому из перечисленных шаблонов |
global-exclude pat1 pat2 ... |
исключить все файлы в любом месте дерева источника, соответствующие — и любому из перечисленных шаблонов |
prune dir |
исключить все файлы из dir |
graft dir |
включить все файлы в dir |
Шаблоны здесь - это шаблоны «glob» в стиле Unix: * соответствует любой последовательности регулярных символов имени файла, ? соответствует любому одиночному регулярному символу имени файла, а [range] соответствует любому из символов в диапазоне (например, a-z, a-zA-Z, a-f0-9_.). Определение «регулярного символа имени файла» зависит от платформы: в Unix это все, кроме слэша; в Windows - все, кроме обратной косой черты или двоеточия.