> **Источник:** https://python-all.ru/2.7/distutils/apiref.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # 10. Справочник API ## 10.1. [`distutils.core`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.core) – Основная функциональность Distutils Модуль [`distutils.core`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.core) – единственный модуль, который необходимо установить для использования Distutils. Он предоставляет [`setup()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.setup) (которая вызывается из сценария setup). Косвенно предоставляет классы `distutils.dist.Distribution` и [`distutils.cmd.Command`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command). #### `distutils.core.setup(arguments)` Базовая универсальная функция, которая делает почти всё, что можно попросить у метода Distutils. Функция setup принимает большое количество аргументов. Они перечислены в следующей таблице. | имя аргумента | значение | тип | | --- | --- | --- | | *имя* | Название пакета | строка | | *версия* | Номер версии пакета; см. [`distutils.version`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.version) | строка | | *описание* | Краткое описание пакета (одна строка) | строка | | *long\_description* | Подробное описание пакета | строка | | *author* | Имя автора пакета | строка | | *author\_email* | Адрес электронной почты автора пакета | строка | | *maintainer* | Имя текущего сопровождающего, если он отличается от автора. Обратите внимание: если указан сопровождающий, distutils использует его как автора в `PKG-INFO` | строка | | *maintainer\_email* | Адрес электронной почты текущего сопровождающего, если он отличается от автора | строка | | *url* | URL пакета (домашняя страница) | строка | | *download\_url* | URL для загрузки пакета | строка | | *packages* | Список пакетов Python, которыми будет управлять distutils | список строк | | *py\_modules* | Список модулей Python, которыми будет управлять distutils | список строк | | *сценарии* | Список отдельных файлов скриптов, которые нужно собрать и установить | список строк | | *ext\_modules* | Список расширений Python, которые необходимо собрать | список экземпляров [`distutils.core.Extension`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.Extension) | | *classifiers* | Список категорий для пакета | список строк; допустимые классификаторы перечислены на [PyPI](https://python-all.ru/2.7/distutils/apiref.html). | | *distclass* | класс [`Distribution`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.Distribution) для использования | подкласс [`distutils.core.Distribution`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.Distribution) | | *script\_name* | Имя скрипта setup.py – по умолчанию `sys.argv[0]` | строка | | *script\_args* | Аргументы, передаваемые скрипту setup | список строк | | *опции* | параметры по умолчанию для скрипта setup | словарь | | *лицензия* | Лицензия пакета | строка | | *keywords* | Описательные метаданные, см. [**PEP 314**](https://python-all.ru/2.7/distutils/apiref.html) | список строк или строка, разделённая запятыми | | *platforms* | | список строк или строка, разделённая запятыми | | *cmdclass* | Сопоставление имён команд с подклассами [`Command`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.Command) | словарь | | *data\_files* | Список файлов данных для установки | список | | *package\_dir* | Сопоставление пакетов и имён каталогов | словарь | #### `distutils.core.run_setup(script_name[, script_args=None, stop_after='run'])` Выполняет сценарий установки в частично контролируемой среде и возвращает экземпляр `distutils.dist.Distribution`, который управляет процессом. Это полезно, если нужно получить метаданные дистрибутива (передаваемые в качестве именованных аргументов из *script* в [`setup()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.setup)) или содержимое файлов конфигурации или командной строки. *script\_name* – это файл, который будет запущен с помощью [`execfile()`](https://python-all.ru/2.7/library/functions.html#execfile) `sys.argv[0]` и заменён на *script* на время вызова. *script\_args* – это список строк; если он указан, `sys.argv[1:]` будет заменён на *script\_args* на время вызова. *stop\_after* указывает [`setup()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.setup), когда остановить обработку; возможные значения: | значение | описание | | --- | --- | | *init* | Остановиться после того, как экземпляр [`Distribution`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.Distribution) будет создан и заполнен именованными аргументами для [`setup()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.setup) | | *config* | Остановиться после того, как файлы конфигурации будут проанализированы (а их данные сохранены в экземпляре [`Distribution`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.Distribution)) | | *commandline* | Остановиться после того, как командная строка (`sys.argv[1:]` или *script\_args*) будет разобрана (а данные сохранены в экземпляре [`Distribution`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.Distribution)). | | *run* | Остановиться после выполнения всех команд (то же самое, как если бы [`setup()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.setup) была вызвана обычным способом). Это значение по умолчанию. | Кроме того, модуль [`distutils.core`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.core) предоставляет ряд классов, которые находятся в других местах. - `Extension` из [`distutils.extension`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.extension) - [`Command`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command) из [`distutils.cmd`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.cmd) - `Distribution` из [`distutils.dist`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.dist) Краткое описание каждого из них приведено ниже, но полную справку смотрите в соответствующем модуле. #### `class distutils.core.Extension` Класс Extension описывает один модуль расширения на C или C++ в скрипте setup. Его конструктор принимает следующие именованные аргументы: | имя аргумента | значение | тип | | --- | --- | --- | | *имя* | полное имя расширения, включая любые пакеты – то есть *не* имя файла или путь, а точечное имя Python | строка | | *sources* | список имён исходных файлов, относительно корня дистрибутива, корень (где setup-скрипт находится), в Unix-формате (косая черта) для переносимости. Исходные файлы могут быть на C, C++, SWIG (.i), платформенно-зависимые файлы ресурсов или что-либо ещё распознаётся командой **build\_ext** как исходный код для расширения Python. | список строк | | *include\_dirs* | список каталогов для поиска файлов заголовков C/C++ (в формате Unix для переносимости) | список строк | | *define\_macros* | список определяемых макросов; каждый макрос определяется с помощью кортежа из двух элементов `(name, value)`, где *value* – это либо строка для определения, либо `None` для определения без конкретного значения (эквивалент `#define FOO` в исходном коде или `-DFOO` в командной строке компилятора C Unix) | список кортежей | | *undef\_macros* | список макросов, которые нужно явно отменить | список строк | | *library\_dirs* | список каталогов для поиска библиотек C/C++ во время компоновки | список строк | | *libraries* | список имён библиотек (не имён файлов или путей) для компоновки | список строк | | *runtime\_library\_dirs* | список каталогов для поиска библиотек C/C++ во время выполнения (для разделяемых расширений это момент загрузки расширения) | список строк | | *extra\_objects* | список дополнительных файлов для компоновки (например, объектные файлы, не входящие в «sources», статическая библиотека, которую нужно явно указать, бинарные ресурсные файлы и т.д.) | список строк | | *extra\_compile\_args* | любая дополнительная информация, зависящая от платформы и компилятора, используемая при компиляции исходных файлов из «sources». Для платформ и компиляторов, где командная строка имеет смысл, это обычно список аргументов командной строки, но для других платформ это может быть что угодно. | список строк | | *extra\_link\_args* | любая дополнительная информация, зависящая от платформы и компилятора, используемая при компоновке объектных файлов для создания расширения (или для создания нового статического интерпретатора Python). Интерпретация аналогична «extra\_compile\_args». | список строк | | *export\_symbols* | список символов, экспортируемых из разделяемого расширения. Используется не на всех платформах и обычно не требуется для расширений Python, которые обычно экспортируют ровно один символ: `init` + extension\_name. | список строк | | *зависит* | список файлов, от которых зависит расширение | список строк | | *язык* | язык расширения (т.е. `'c'`, `'c++'`, `'objc'`). Если не указан, будет определён по расширениям исходных файлов. | строка | #### `class distutils.core.Distribution` [`Distribution`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.Distribution) описывает, как собрать, установить и упаковать программный пакет Python. Список именованных аргументов, принимаемых конструктором Distribution, приведён в описании функции [`setup()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.setup). [`setup()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.setup) создаёт экземпляр Distribution. #### `class distutils.core.Command` Класс [`Command`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.Command) (точнее, экземпляр одного из его подклассов) реализует одну команду distutils. ## 10.2. [`distutils.ccompiler`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.ccompiler) – базовый класс CCompiler Этот модуль предоставляет абстрактный базовый класс для классов [`CCompiler`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler). Экземпляр [`CCompiler`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler) можно использовать для всех этапов компиляции и компоновки, необходимых для сборки одного проекта. Предусмотрены методы для задания параметров компилятора – макроопределений, путей включения, путей компоновки, библиотек и т.п. Этот модуль предоставляет следующие функции. #### `distutils.ccompiler.gen_lib_options(compiler, library_dirs, runtime_library_dirs, libraries)` Генерирует параметры компоновщика для поиска каталогов библиотек и компоновки с конкретными библиотеками. *libraries* и *library\_dirs* – это соответственно списки имён библиотек (не имён файлов!) и каталогов поиска. Возвращает список параметров командной строки, подходящих для использования с некоторым компилятором (в зависимости от двух переданных строк формата). #### `distutils.ccompiler.gen_preprocess_options(macros, include_dirs)` Генерирует параметры препроцессора C (`-D`, `-U`, `-I`), используемые как минимум двумя типами компиляторов: типичным Unix-компилятором и Visual C++. *macros* – обычный список кортежей из одного или двух элементов, где `(name,)` означает отменить определение (`-U`) макроса *имя*, а `(name, value)` означает определить (`-D`) макрос *имя* со значением *значение*. *include\_dirs* – просто список имён каталогов, добавляемых в путь поиска заголовочных файлов (`-I`). Возвращает список параметров командной строки, подходящих для Unix-компиляторов или Visual C++. #### `distutils.ccompiler.get_default_compiler(osname, platform)` Определяет компилятор по умолчанию для указанной платформы. *osname* должно быть одним из стандартных имён ОС Python (т.е. тех, что возвращаются функцией `os.name`), а *platform* – обычным значением, возвращаемым `sys.platform` для данной платформы. Если параметры не указаны, используются значения по умолчанию: `os.name` и `sys.platform`. #### `distutils.ccompiler.new_compiler(plat=None, compiler=None, verbose=0, dry_run=0, force=0)` Фабричная функция для создания экземпляра подкласса CCompiler для заданной комбинации платформа/компилятор. *plat* по умолчанию равен `os.name` (например, `'posix'`, `'nt'`), а *compiler* по умолчанию равен компилятору по умолчанию для этой платформы. В настоящее время поддерживаются только `'posix'` и `'nt'`, и компиляторами по умолчанию являются «традиционный интерфейс Unix» (класс `UnixCCompiler`) и Visual C++ (класс `MSVCCompiler`). Обратите внимание, что вполне можно запросить объект Unix-компилятора в Windows и объект Microsoft-компилятора в Unix – если указать значение для *compiler*, то *plat* игнорируется. #### `distutils.ccompiler.show_compilers()` Выводит список доступных компиляторов (используется параметрами `--help-compiler` команд **build**, **build\_ext**, **build\_clib**). #### `class distutils.ccompiler.CCompiler([verbose=0, dry_run=0, force=0])` Абстрактный базовый класс [`CCompiler`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler) определяет интерфейс, который должны реализовывать реальные классы компиляторов. Класс также содержит несколько вспомогательных методов, используемых несколькими классами компиляторов. Основная идея абстрактного класса компилятора заключается в том, что каждый экземпляр может использоваться для всех этапов компиляции/компоновки при сборке одного проекта. Таким образом, атрибуты, общие для всех этих этапов компиляции и компоновки – каталоги включения, определяемые макросы, библиотеки для компоновки и т.д. – являются атрибутами экземпляра компилятора. Чтобы обеспечить возможность изменения обработки отдельных файлов, большинство этих атрибутов можно изменять для каждой компиляции или каждой компоновки отдельно. Конструктор каждого подкласса создаёт экземпляр объекта Compiler. Флаги: *verbose* (показывать подробный вывод), *dry\_run* (не выполнять шаги фактически) и *force* (пересобрать всё, независимо от зависимостей). Все эти флаги по умолчанию равны `0` (выключены). Обратите внимание, что, вероятно, не следует создавать экземпляр [`CCompiler`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler) или его подклассов напрямую – вместо этого используйте фабричную функцию `distutils.CCompiler.new_compiler()`. The following methods allow you to manually alter compiler options for the instance of the Compiler class. #### `add_include_dir(dir)` Add *dir* to the list of directories that will be searched for header files. The compiler is instructed to search directories in the order in which they are supplied by successive calls to [`add_include_dir()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.add_include_dir). #### `set_include_dirs(dirs)` Set the list of directories that will be searched to *dirs* (a list of strings). Overrides any preceding calls to [`add_include_dir()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.add_include_dir); subsequent calls to [`add_include_dir()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.add_include_dir) add to the list passed to [`set_include_dirs()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.set_include_dirs). This does not affect any list of standard include directories that the compiler may search by default. #### `add_library(libname)` Add *libname* to the list of libraries that will be included in all links driven by this compiler object. Note that *libname* should \*not\* be the name of a file containing a library, but the name of the library itself: the actual filename will be inferred by the linker, the compiler, or the compiler class (depending on the platform). Компоновщику будет указано компоновать библиотеки в том порядке, в котором они были переданы в [`add_library()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.add_library) и/или [`set_libraries()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.set_libraries). Допускается дублирование имен библиотек; компоновщику будет указано компоновать библиотеки столько раз, сколько они упомянуты. #### `set_libraries(libnames)` Set the list of libraries to be included in all links driven by this compiler object to *libnames* (a list of strings). This does not affect any standard system libraries that the linker may include by default. #### `add_library_dir(dir)` Add *dir* to the list of directories that will be searched for libraries specified to [`add_library()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.add_library) and [`set_libraries()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.set_libraries). The linker will be instructed to search for libraries in the order they are supplied to [`add_library_dir()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.add_library_dir) and/or [`set_library_dirs()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.set_library_dirs). #### `set_library_dirs(dirs)` Set the list of library search directories to *dirs* (a list of strings). This does not affect any standard library search path that the linker may search by default. #### `add_runtime_library_dir(dir)` Add *dir* to the list of directories that will be searched for shared libraries at runtime. #### `set_runtime_library_dirs(dirs)` Set the list of directories to search for shared libraries at runtime to *dirs* (a list of strings). This does not affect any standard search path that the runtime linker may search by default. #### `define_macro(name[, value=None])` Define a preprocessor macro for all compilations driven by this compiler object. The optional parameter *value* should be a string; if it is not supplied, then the macro will be defined without an explicit value and the exact outcome depends on the compiler used. #### `undefine_macro(name)` Отменяет определение макроса препроцессора для всех компиляций, выполняемых данным объектом компилятора. Если один и тот же макрос определен с помощью [`define_macro()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.define_macro) и отменен с помощью [`undefine_macro()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.undefine_macro), приоритет имеет последний вызов (включая множественные переопределения или отмены). Если макрос переопределяется/отменяется для отдельной компиляции (т.е. в вызове [`compile()`](https://python-all.ru/2.7/library/functions.html#compile)), то этот вызов имеет приоритет. #### `add_link_object(object)` Add *object* to the list of object files (or analogues, such as explicitly named library files or the output of “resource compilers”) to be included in every link driven by this compiler object. #### `set_link_objects(objects)` Set the list of object files (or analogues) to be included in every link to *objects*. This does not affect any standard object files that the linker may include by default (such as system libraries). Следующие методы реализуют автодетекцию параметров компилятора, предоставляя функциональность, аналогичную GNU **autoconf**. #### `detect_language(sources)` Определяет язык заданного файла или списка файлов. Использует атрибуты экземпляра `language_map` (словарь) и `language_order` (список). #### `find_library_file(dirs, lib[, debug=0])` Search the specified list of directories for a static or shared library file *lib* and return the full path to that file. If *debug* is true, look for a debugging version (if that makes sense on the current platform). Return `None` if *lib* wasn’t found in any of the specified directories. #### `has_function(funcname[, includes=None, include_dirs=None, libraries=None, library_dirs=None])` Возвращает логическое значение, указывающее, поддерживается ли *funcname* на текущей платформе. Необязательные аргументы можно использовать для расширения среды компиляции, предоставляя дополнительные включаемые файлы и пути, а также библиотеки и пути. #### `library_dir_option(dir)` Возвращает опцию компилятора для добавления *dir* в список каталогов, в которых выполняется поиск библиотек. #### `library_option(lib)` Возвращает опцию компилятора для добавления *lib* в список библиотек, связываемых в разделяемую библиотеку или исполняемый файл. #### `runtime_library_dir_option(dir)` Возвращает опцию компилятора для добавления *dir* в список каталогов, в которых выполняется поиск библиотек времени выполнения. #### `set_executables(**args)` Определяет исполняемые файлы (и параметры для них), которые будут запущены для выполнения различных этапов компиляции. Точный набор исполняемых файлов, которые могут быть здесь указаны, зависит от класса компилятора (через атрибут класса ‘executables’), но большинство будут иметь: | атрибут | описание | | --- | --- | | *compiler* | компилятор C/C++ | | *linker\_so* | компоновщик, используемый для создания разделяемых объектов и библиотек | | *linker\_exe* | компоновщик, используемый для создания двоичных исполняемых файлов | | *archiver* | создатель статических библиотек | На платформах с командной строкой (Unix, DOS/Windows) каждый из них представляет собой строку, которая будет разделена на имя исполняемого файла и (необязательный) список аргументов. (Разделение строки выполняется аналогично тому, как работают оболочки Unix: слова разделяются пробелами, но кавычки и обратная косая черта могут переопределить это. См. [`distutils.util.split_quoted()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.util.split_quoted).) Следующие методы вызывают этапы процесса сборки. #### `compile(sources[, output_dir=None, macros=None, include_dirs=None, debug=0, extra_preargs=None, extra_postargs=None, depends=None])` Компилирует один или несколько исходных файлов. Создает объектные файлы (например, преобразует файл `.c` в файл `.o`). *sources* должен быть списком имен файлов, скорее всего файлов C/C++, но на самом деле всего, что может обрабатываться конкретным компилятором и классом компилятора (например, `MSVCCompiler` может обрабатывать файлы ресурсов в *sources*). Возвращает список имен объектных файлов, по одному на каждое имя исходного файла в *sources*. В зависимости от реализации не все исходные файлы обязательно будут скомпилированы, но все соответствующие имена объектных файлов будут возвращены. Если указан *output\_dir*, объектные файлы будут помещены в него, сохраняя свой исходный компонент пути. То есть `foo/bar.c` обычно компилируется в `foo/bar.o` (для реализации Unix); если *output\_dir* равен *build*, то он будет скомпилирован в `build/foo/bar.o`. *macros*, если указан, должен быть списком определений макросов. Определение макроса – это либо кортеж из 2 элементов `(name, value)`, либо кортеж из 1 элемента `(name,)`. Первый вариант определяет макрос; если значение равно `None`, макрос определяется без явного значения. Случай с кортежем из 1 элемента отменяет определение макроса. Последующие определения/переопределения/отмены имеют приоритет. *include\_dirs*, если указан, должен быть списком строк – каталогов, добавляемых к пути поиска включаемых файлов по умолчанию только для данной компиляции. *debug* – логическое значение; если истинно, компилятору будет дано указание выводить отладочные символы в объектный файл (или рядом с ним). *extra\_preargs* и *extra\_postargs* зависят от реализации. На платформах, имеющих понятие командной строки (например, Unix, DOS/Windows), они, скорее всего, представляют собой списки строк: дополнительные аргументы командной строки, добавляемые в начало/конец командной строки компилятора. На других платформах обращайтесь к документации класса реализации. В любом случае они предназначены как запасной выход для тех случаев, когда абстрактная структура компилятора не справляется. *depends*, если указан, представляет собой список имен файлов, от которых зависят все цели. Если исходный файл старше любого файла из depends, то исходный файл будет перекомпилирован. Это обеспечивает отслеживание зависимостей, но только с грубой зернистостью. Возбуждает `CompileError` при ошибке. #### `create_static_lib(objects, output_libname[, output_dir=None, debug=0, target_lang=None])` Связывает вместе набор компонентов для создания файла статической библиотеки. «Набор компонентов» состоит из списка объектных файлов, переданных как *objects*, дополнительных объектных файлов, переданных в [`add_link_object()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.add_link_object) и/или [`set_link_objects()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.set_link_objects), библиотек, переданных в [`add_library()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.add_library) и/или [`set_libraries()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.set_libraries), и библиотек, переданных как *libraries* (если есть). *output\_libname* должно быть именем библиотеки, а не именем файла; имя файла будет выведено из имени библиотеки. *output\_dir* – это каталог, в который будет помещен файл библиотеки. *debug* – логическое значение; если истинно, в библиотеку будет включена отладочная информация (обратите внимание: на большинстве платформ значение имеет этап компиляции; флаг *debug* добавлен здесь лишь для единообразия). *target\_lang* – целевой язык, для которого компилируются указанные объекты. Это позволяет выполнять специальную обработку на этапе компоновки для некоторых языков. Возбуждает `LibError` при ошибке. #### `link(target_desc, objects, output_filename[, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None])` Связывает всё вместе, чтобы создать исполняемый файл или файл динамической библиотеки. «Всё вместе» включает список объектных файлов, переданных в *objects*. *output\_filename* должно быть именем файла. Если *output\_dir* задан, *output\_filename* указывается относительно него (т.е. *output\_filename* может содержать компоненты пути). *libraries* – список библиотек для компоновки. Это имена библиотек, а не имена файлов, поскольку они преобразуются в имена файлов платформенно-зависимым образом (например, *foo* превращается в `libfoo.a` в Unix и `foo.lib` в DOS/Windows). Однако они могут содержать компонент пути, что означает, что компоновщик будет искать в этом конкретном каталоге, а не во всех стандартных местах. *library\_dirs*, если задан, должен быть списком каталогов для поиска библиотек, указанных только по имени (т.е. без компонента пути). Эти каталоги добавляются поверх системных по умолчанию и тех, что переданы в [`add_library_dir()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.add_library_dir) и/или [`set_library_dirs()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.set_library_dirs). *runtime\_library\_dirs* – список каталогов, которые будут встроены в динамическую библиотеку и использоваться для поиска других динамических библиотек, от которых она зависит во время выполнения. (Это может быть актуально только в Unix.) *export\_symbols* – список символов, которые будет экспортировать динамическая библиотека. (Это актуально, по-видимому, только в Windows.) *debug* аналогичен [`compile()`](https://python-all.ru/2.7/library/functions.html#compile) и [`create_static_lib()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.create_static_lib), с тем небольшим отличием, что он действительно имеет значение на большинстве платформ (в отличие от [`create_static_lib()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.create_static_lib), который содержит флаг *debug* в основном для формальности). *extra\_preargs* и *extra\_postargs* аналогичны [`compile()`](https://python-all.ru/2.7/library/functions.html#compile) (за исключением, конечно, того, что они предоставляют аргументы командной строки для используемого компоновщика). *target\_lang* – целевой язык, для которого компилируются указанные объекты. Это позволяет выполнять специальную обработку на этапе компоновки для некоторых языков. Возбуждает `LinkError` при ошибке. #### `link_executable(objects, output_progname[, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, debug=0, extra_preargs=None, extra_postargs=None, target_lang=None])` Компоновка исполняемого файла. *output\_progname* – имя исполняемого файла, а *objects* – список имен объектных файлов для включения. Остальные аргументы такие же, как у метода [`link()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.link). #### `link_shared_lib(objects, output_libname[, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None])` Компоновка динамической библиотеки. *output\_libname* – имя выходной библиотеки, а *objects* – список имен объектных файлов для включения. Остальные аргументы такие же, как у метода [`link()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.link). #### `link_shared_object(objects, output_filename[, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None])` Компоновка разделяемого объекта. *output\_filename* – имя создаваемого разделяемого объекта, а *objects* – список имен объектных файлов для включения. Остальные аргументы такие же, как у метода [`link()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.link). #### `preprocess(source[, output_file=None, macros=None, include_dirs=None, extra_preargs=None, extra_postargs=None])` Препроцессирование одного исходного файла C/C++, указанного в *source*. Результат будет записан в файл с именем *output\_file* или в *stdout*, если *output\_file* не задан. *macros* – список определений макросов, как в [`compile()`](https://python-all.ru/2.7/library/functions.html#compile), который дополнит макросы, установленные с помощью [`define_macro()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.define_macro) и [`undefine_macro()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.undefine_macro). *include\_dirs* – список имен каталогов, которые будут добавлены к списку по умолчанию, аналогично [`add_include_dir()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler.add_include_dir). Возбуждает `PreprocessError` при ошибке. Следующие вспомогательные методы определены классом [`CCompiler`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler) для использования различными конкретными подклассами. #### `executable_filename(basename[, strip_dir=0, output_dir=''])` Возвращает имя файла исполняемого файла для заданного *basename*. Обычно на платформах, отличных от Windows, оно совпадает с базовым именем, в то время как в Windows будет добавлено `.exe`. #### `library_filename(libname[, lib_type='static', strip_dir=0, output_dir=''])` Возвращает имя файла для заданного имени библиотеки на текущей платформе. В Unix библиотека с *lib\_type* равным `'static'` обычно имеет вид `liblibname.a`, а с *lib\_type* равным `'dynamic'` – вид `liblibname.so`. #### `object_filenames(source_filenames[, strip_dir=0, output_dir=''])` Возвращает имена объектных файлов для заданных исходных файлов. *source\_filenames* должен быть списком имен файлов. #### `shared_object_filename(basename[, strip_dir=0, output_dir=''])` Возвращает имя файла разделяемого объекта для заданного имени файла *basename*. #### `execute(func, args[, msg=None, level=1])` Вызывает [`distutils.util.execute()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.util.execute). Этот метод вызывает функцию Python *func* с заданными аргументами *args*, предварительно выполнив логирование и учтя флаг *dry\_run*. #### `spawn(cmd)` Вызывает `distutils.util.spawn()`. Запускает внешний процесс для выполнения указанной команды. #### `mkpath(name[, mode=511])` Вызывает [`distutils.dir_util.mkpath()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.dir_util.mkpath). Создаёт каталог и все недостающие родительские каталоги. #### `move_file(src, dst)` Вызывает [`distutils.file_util.move_file()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.file_util.move_file). Переименовывает *src* в *dst*. #### `announce(msg[, level=1])` Записывает сообщение, используя `distutils.log.debug()`. #### `warn(msg)` Записывает предупреждающее сообщение *msg* в стандартный поток ошибок. #### `debug_print(msg)` Если на экземпляре [`CCompiler`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler) установлен флаг *debug*, вывести *msg* в стандартный вывод; в противном случае ничего не делать. ## 10.3. [`distutils.unixccompiler`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.unixccompiler) – компилятор C для Unix Этот модуль предоставляет класс `UnixCCompiler`, подкласс `CCompiler`, который работает с типичным компилятором C для Unix в стиле командной строки: - макросы, определённые с помощью `-Dname[=value]` - макросы, отменённые с помощью `-Uname` - каталоги поиска include, указанные с помощью `-Idir` - библиотеки, указанные с помощью `-llib` - каталоги поиска библиотек, указанные с помощью `-Ldir` - компиляция выполняется исполняемым файлом **cc** (или аналогичным) с опцией `-c`: компилирует `.c` в `.o` - компоновка статической библиотеки выполняется командой **ar** (возможно, с **ranlib**) - компоновка разделяемой библиотеки выполняется **cc** `-shared` ## 10.4. [`distutils.msvccompiler`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.msvccompiler) – компилятор Microsoft Этот модуль предоставляет `MSVCCompiler`, реализацию абстрактного класса `CCompiler` для Microsoft Visual Studio. Обычно модули расширения необходимо компилировать тем же компилятором, который использовался для компиляции Python. Для Python 2.3 и более ранних версий компилятором был Visual Studio 6. Для Python 2.4 и 2.5 – Visual Studio .NET 2003. Бинарные сборки AMD64 и Itanium создаются с помощью Platform SDK. `MSVCCompiler` обычно самостоятельно выбирает подходящий компилятор, компоновщик и т. д. Чтобы переопределить этот выбор, должны быть установлены обе переменные окружения *DISTUTILS\_USE\_SDK* и *MSSdk*. *MSSdk* указывает, что текущее окружение было настроено сценарием `SetEnv.Cmd` SDK или что переменные окружения были зарегистрированы при установке SDK; *DISTUTILS\_USE\_SDK* указывает, что пользователь distutils явно решил переопределить выбор компилятора с помощью `MSVCCompiler`. ## 10.5. [`distutils.bcppcompiler`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.bcppcompiler) – компилятор Borland Этот модуль предоставляет `BorlandCCompiler`, подкласс абстрактного класса `CCompiler` для компилятора Borland C++. ## 10.6. `distutils.cygwincompiler` – компилятор Cygwin Этот модуль предоставляет класс `CygwinCCompiler`, подкласс `UnixCCompiler`, который работает с портом Cygwin компилятора GNU C для Windows. Он также содержит класс Mingw32CCompiler, который работает с портом mingw32 GCC (то же, что cygwin в режиме без cygwin). ## 10.7. [`distutils.emxccompiler`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.emxccompiler) – OS/2 EMX Compiler Этот модуль предоставляет класс EMXCCompiler, подкласс `UnixCCompiler`, который управляет портом EMX компилятора GNU C для OS/2. ## 10.8. [`distutils.archive_util`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.archive_util) – утилиты архивации Этот модуль предоставляет несколько функций для создания архивных файлов, таких как tar-архивы или zip-файлы. #### `distutils.archive_util.make_archive(base_name, format[, root_dir=None, base_dir=None, verbose=0, dry_run=0])` Создаёт архивный файл (например, `zip` или `tar`). *base\_name* – это имя файла для создания, без расширения, зависящего от формата; *format* – это формат архива: один из `zip`, `tar`, `ztar`, или `gztar`. *root\_dir* – каталог, который будет корневым каталогом архива; то есть обычно мы `chdir` в *root\_dir* перед созданием архива. *base\_dir* – это каталог, из которого начинается архивация; то есть *base\_dir* будет общим префиксом всех файлов и каталогов в архиве. *root\_dir* и *base\_dir* по умолчанию равны текущему каталогу. Возвращает имя файла архива. #### `distutils.archive_util.make_tarball(base_name, base_dir[, compress='gzip', verbose=0, dry_run=0])` Создаёт (возможно, сжатый) архив в виде tar-файла из всех файлов в каталоге *base\_dir* и его подкаталогах. *compress* должно быть `'gzip'` (по умолчанию), `'compress'`, `'bzip2'` или `None`. И **tar**, и утилита сжатия, указанная в *compress*, должны находиться в стандартном пути поиска программ, так что это, вероятно, зависит от Unix. Выходной tar-файл будет называться `base_dir.tar`, возможно, с соответствующим расширением сжатия (`.gz`, `.bz2` или `.Z`). Возвращает имя выходного файла. #### `distutils.archive_util.make_zipfile(base_name, base_dir[, verbose=0, dry_run=0])` Создаёт zip-файл из всех файлов в *base\_dir* и его подкаталогах. Выходной zip-файл будет назван *base\_name* + `.zip`. Использует либо модуль Python [`zipfile`](https://python-all.ru/2.7/library/zipfile.html#module-zipfile) (если доступен), либо утилиту InfoZIP `zip` (если установлена и найдена в пути поиска по умолчанию). Если ни один из инструментов недоступен, возбуждает `DistutilsExecError`. Возвращает имя выходного zip-файла. ## 10.9. [`distutils.dep_util`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.dep_util) – Проверка зависимостей Этот модуль предоставляет функции для простой проверки зависимостей файлов и групп файлов на основе временных меток; а также функции, полностью основанные на таком анализе зависимостей по временным меткам. #### `distutils.dep_util.newer(source, target)` Возвращает истину, если *source* существует и изменён позже, чем *target*, или если *source* существует, а *target* – нет. Возвращает ложь, если оба существуют и *target* одного возраста или новее, чем *source*. Возбуждает `DistutilsFileError`, если *source* не существует. #### `distutils.dep_util.newer_pairwise(sources, targets)` Обходит два списка имён файлов параллельно, проверяя, является ли каждый исходный файл новее соответствующего целевого. Возвращает пару списков (*sources*, *targets*), где исходный файл новее целевого, в соответствии с семантикой [`newer()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.dep_util.newer). #### `distutils.dep_util.newer_group(sources, target[, missing='error'])` Возвращает истину, если *target* устарел относительно любого файла из списка *sources*. Другими словами, если *target* существует и новее любого файла в *sources*, возвращает ложь; в противном случае возвращает истину. *missing* определяет поведение при отсутствии исходного файла; по умолчанию (`'error'`) – аварийное завершение с [`OSError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.OSError) внутри [`os.stat()`](https://python-all.ru/2.7/library/os.html#os.stat); если указано `'ignore'`, отсутствующие исходные файлы молча пропускаются; если указано `'newer'`, любой отсутствующий исходный файл заставляет считать, что *target* устарел (это удобно в режиме «холостого прогона»: он заставляет считать, что команды выполняются, хотя они не сработали бы из-за отсутствия входных данных, но это не имеет значения, поскольку команды на самом деле не выполняются). ## 10.10. [`distutils.dir_util`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.dir_util) – Операции с деревьями каталогов Этот модуль предоставляет функции для работы с каталогами и деревьями каталогов. #### `distutils.dir_util.mkpath(name[, mode=0777, verbose=0, dry_run=0])` Создаёт каталог и все недостающие родительские каталоги. Если каталог уже существует (или если *name* – пустая строка, что означает текущий каталог, который, разумеется, существует), то ничего не делает. Возбуждает `DistutilsFileError`, если не удаётся создать какой-либо каталог по пути (например, часть пути существует, но является файлом, а не каталогом). Если *verbose* истинно, выводит в stdout одну строку с итогом каждого mkdir. Возвращает список фактически созданных каталогов. #### `distutils.dir_util.create_tree(base_dir, files[, mode=0777, verbose=0, dry_run=0])` Создаёт все пустые каталоги внутри *base\_dir*, необходимые для размещения *files*. *base\_dir* – это просто имя каталога, который необязательно существует; *files* – список имён файлов, интерпретируемых относительно *base\_dir*. *base\_dir* + часть пути (каталог) каждого файла из *files* будут созданы, если их ещё нет. Флаги *mode*, *verbose* и *dry\_run* аналогичны [`mkpath()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.dir_util.mkpath). #### `distutils.dir_util.copy_tree(src, dst[, preserve_mode=1, preserve_times=1, preserve_symlinks=0, update=0, verbose=0, dry_run=0])` Копирует всё дерево каталогов *src* в новое местоположение *dst*. И *src*, и *dst* должны быть именами каталогов. Если *src* не является каталогом, вызывается `DistutilsFileError`. Если *dst* не существует, он создаётся с помощью [`mkpath()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.dir_util.mkpath). Конечный результат копирования: каждый файл в *src* копируется в *dst*, а каталоги внутри *src* рекурсивно копируются в *dst*. Возвращает список файлов, которые были скопированы или могли быть скопированы, с их выходными именами. Возвращаемое значение не зависит от *update* или *dry\_run*: это просто список всех файлов в *src*, с именами, изменёнными на соответствующие *dst*. *preserve\_mode* и *preserve\_times* аналогичны одноимённым параметрам в [`distutils.file_util.copy_file()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.file_util.copy_file); обратите внимание, что они применяются только к обычным файлам, а не к каталогам. Если *preserve\_symlinks* истинно, символические ссылки копируются как символические ссылки (на платформах, которые их поддерживают!); в противном случае (по умолчанию) копируется объект, на который указывает ссылка. *update* и *verbose* аналогичны `copy_file()`. Файлы в *src*, начинающиеся с `.nfs`, пропускаются (дополнительная информация об этих файлах доступна в ответе D2 на [странице FAQ по NFS](https://python-all.ru/2.7/distutils/apiref.html)). Изменено в версии 2.7.4: NFS-файлы игнорируются. #### `distutils.dir_util.remove_tree(directory[, verbose=0, dry_run=0])` Рекурсивно удаляет *directory* и все файлы и каталоги внутри него. Все ошибки игнорируются (за исключением сообщения в `sys.stdout`, если *verbose* истинно). ## 10.11. [`distutils.file_util`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.file_util) – Операции с отдельными файлами Этот модуль содержит несколько служебных функций для работы с отдельными файлами. #### `distutils.file_util.copy_file(src, dst[, preserve_mode=1, preserve_times=1, update=0, link=None, verbose=0, dry_run=0])` Копирует файл *src* в *dst*. Если *dst* является каталогом, то *src* копируется туда с тем же именем; в противном случае это должно быть имя файла. (Если файл существует, он будет безжалостно перезаписан.) Если *preserve\_mode* равен true (по умолчанию), то копируется режим файла (тип и биты разрешений, или что-то аналогичное на текущей платформе). Если *preserve\_times* равен true (по умолчанию), то также копируются время последнего изменения и последнего доступа. Если *update* равен true, то *src* будет скопирован только если *dst* не существует, или если *dst* существует, но старше, чем *src*. *link* позволяет создавать жёсткие ссылки (с помощью [`os.link()`](https://python-all.ru/2.7/library/os.html#os.link)) или символические ссылки (с помощью [`os.symlink()`](https://python-all.ru/2.7/library/os.html#os.symlink)) вместо копирования: установите его в `'hard'` или `'sym'`; если он равен `None` (по умолчанию), файлы копируются. Не устанавливайте *link* в системах, которые его не поддерживают: [`copy_file()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.file_util.copy_file) не проверяет, доступно ли создание жёстких или символических ссылок. Он использует `_copy_file_contents()` для копирования содержимого файла. Возвращает кортеж `(dest_name, copied)`: *dest\_name* – это фактическое имя выходного файла, а *copied* равен true, если файл был скопирован (или был бы скопирован, если бы *dry\_run* был true). #### `distutils.file_util.move_file(src, dst[, verbose, dry_run])` Перемещает файл *src* в *dst*. Если *dst* является каталогом, файл будет перемещён в него с тем же именем; в противном случае *src* просто переименовывается в *dst*. Возвращает новое полное имя файла. > **Предупреждение** > > Обрабатывает перемещение между устройствами в Unix с помощью [`copy_file()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.file_util.copy_file). А как насчёт других систем? #### `distutils.file_util.write_file(filename, contents)` Создаёт файл с именем *filename* и записывает в него *contents* (последовательность строк без символов конца строки). ## 10.12. [`distutils.util`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.util) – Прочие вспомогательные функции Этот модуль содержит другие разрозненные элементы, которые не вписываются ни в один другой вспомогательный модуль. #### `distutils.util.get_platform()` Возвращает строку, идентифицирующую текущую платформу. В основном используется для различения платформозависимых каталогов сборки и платформозависимых готовых дистрибутивов. Обычно включает имя и версию ОС, а также архитектуру (как их возвращает ‘os.uname()’), хотя точный состав информации зависит от ОС; например, для IRIX архитектура не особенно важна (IRIX работает только на оборудовании SGI), а для Linux версия ядра не особенно важна. Примеры возвращаемых значений: - `linux-i586` - `linux-alpha` - `solaris-2.6-sun4u` - `irix-5.3` - `irix64-6.2` Для платформ, несовместимых с POSIX, в настоящее время просто возвращает `sys.platform`. Для систем Mac OS X версия ОС отражает минимальную версию, на которой будут работать двоичные файлы (то есть значение `MACOSX_DEPLOYMENT_TARGET` во время сборки Python), а не версию ОС текущей системы. Для универсальных сборок двоичных файлов на Mac OS X значение архитектуры отражает статус универсальной сборки, а не архитектуру текущего процессора. Для 32-битных универсальных сборок архитектура – `fat`, для 64-битных универсальных сборок – `fat64`, а для 4-сторонних универсальных сборок – `universal`. Начиная с Python 2.7 и Python 3.2 архитектура `fat3` используется для 3-сторонней универсальной сборки (ppc, i386, x86\_64), а `intel` – для универсальной сборки с архитектурами i386 и x86\_64. Примеры возвращаемых значений на Mac OS X: - `macosx-10.3-ppc` - `macosx-10.3-fat` - `macosx-10.5-universal` - `macosx-10.6-intel` #### `distutils.util.convert_path(pathname)` Возвращает 'pathname' как имя, которое будет работать в родной файловой системе, т.е. разделяет его по '/' и снова соединяет, используя текущий разделитель каталогов. Это необходимо, потому что имена файлов в скрипте установки всегда предоставляются в стиле Unix и должны быть преобразованы в локальное соглашение, прежде чем их можно будет использовать в файловой системе. Вызывает [`ValueError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.ValueError) в системах, несовместимых с Unix, если *pathname* начинается или заканчивается косой чертой. #### `distutils.util.change_root(new_root, pathname)` Возвращает *pathname* с добавленным в начало *new\_root*. Если *pathname* является относительным, это эквивалентно `os.path.join(new_root,pathname)`. В противном случае требуется сделать *pathname* относительным, а затем объединить их, что сложно на DOS/Windows. #### `distutils.util.check_environ()` Гарантирует, что 'os.environ' содержит все переменные окружения, которые пользователи могут использовать в конфигурационных файлах, параметрах командной строки и т.д. В настоящее время это включает: - `HOME` – домашний каталог пользователя (только Unix) - `PLAT` – описание текущей платформы, включая аппаратное обеспечение и ОС (см. [`get_platform()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.util.get_platform)) #### `distutils.util.subst_vars(s, local_vars)` Выполняет подстановку переменных в стиле shell/Perl для *s*. Каждое вхождение `$`, за которым следует имя, считается переменной, и переменная заменяется значением, найденным в словаре *local\_vars* или в `os.environ`, если её нет в *local\_vars*. *os.environ* сначала проверяется/дополняется, чтобы гарантировать, что он содержит определённые значения: см. [`check_environ()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.util.check_environ). Вызывает [`ValueError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.ValueError) для любых переменных, не найденных ни в *local\_vars*, ни в `os.environ`. Обратите внимание, что это не полноценная функция интерполяции строк. Допустимое `$variable` может состоять только из букв верхнего и нижнего регистра, цифр и символа подчеркивания. Кавычки в стиле { } или ( ) не поддерживаются. #### `distutils.util.split_quoted(s)` Разделяет строку по правилам, похожим на оболочку Unix, для кавычек и обратной косой черты. Кратко: слова разделяются пробелами, если эти пробелы не экранированы обратной косой чертой или не находятся внутри строки в кавычках. Одинарные и двойные кавычки эквивалентны, и символы кавычек могут быть экранированы обратной косой чертой. Обратная косая черта удаляется из любой двухсимвольной escape-последовательности, оставляя только экранированный символ. Символы кавычек удаляются из любой строки в кавычках. Возвращает список слов. #### `distutils.util.execute(func, args[, msg=None, verbose=0, dry_run=0])` Выполняет некоторое действие, влияющее на внешний мир (например, запись в файловую систему). Такие действия особенны тем, что они отключаются флагом *dry\_run*. Этот метод берет на себя всю эту бюрократию; все, что нужно сделать – предоставить вызываемую функцию и кортеж аргументов для нее (чтобы воплотить выполняемое «внешнее действие») и необязательное сообщение для вывода. #### `distutils.util.strtobool(val)` Преобразует строковое представление истинности в true (1) или false (0). Истинными значениями являются `y`, `yes`, `t`, `true`, `on` и `1`; ложными значениями являются `n`, `no`, `f`, `false`, `off` и `0`. Возбуждает [`ValueError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.ValueError), если *val* – что-то другое. #### `distutils.util.byte_compile(py_files[, optimize=0, force=0, prefix=None, base_dir=None, verbose=1, dry_run=0, direct=None])` Байт-компилирует набор исходных файлов Python в файлы `.pyc` или `.pyo` в том же каталоге. *py\_files* – это список файлов для компиляции; все файлы, не заканчивающиеся на `.py`, молча пропускаются. *optimize* должен быть одним из следующих значений: - `0` – не оптимизировать (создавать `.pyc`) - `1` – обычная оптимизация (как `python -O`) - `2` – дополнительная оптимизация (как `python -OO`) Если *force* равно true, все файлы перекомпилируются независимо от временных меток. Имя исходного файла, закодированное в каждом [bytecode](https://python-all.ru/2.7/glossary.html#term-bytecode) файле, по умолчанию соответствует именам файлов, перечисленным в *py\_files*; их можно изменить с помощью *prefix* и *basedir*. *prefix* – это строка, которая будет отрезана от каждого имени исходного файла, а *base\_dir* – это имя каталога, которое будет добавлено спереди (после того, как *prefix* будет отрезан). Можно указать либо *prefix*, либо *base\_dir*, или оба, или ни одного, по желанию. Если *dry\_run* равно true, на самом деле не выполняет никаких действий, влияющих на файловую систему. Байт-компиляция выполняется либо непосредственно в текущем процессе интерпретатора с использованием стандартного модуля [`py_compile`](https://python-all.ru/2.7/library/py_compile.html#module-py_compile), либо косвенно – путем записи временного скрипта и его выполнения. Обычно следует позволить [`byte_compile()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.util.byte_compile) решать, использовать ли прямую компиляцию (подробности см. в исходном коде). Флаг *direct* используется скриптом, созданным в косвенном режиме; если нет уверенности в том, что делается, оставьте его равным `None`. #### `distutils.util.rfc822_escape(header)` Возвращает версию *header* с экранированием для включения в заголовок [**RFC 822**](https://python-all.ru/2.7/distutils/apiref.html), гарантируя наличие 8 пробелов после каждого перевода строки. Обратите внимание, что никаких других изменений строки не производится. ## 10.13. [`distutils.dist`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.dist) – Класс Distribution Этот модуль предоставляет класс [`Distribution`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.Distribution), который представляет распространяемый модуль (сборка/установка/распространение). ## 10.14. [`distutils.extension`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.extension) – Класс Extension Этот модуль предоставляет класс `Extension`, используемый для описания модулей расширения C/C++ в скриптах установки. ## 10.15. [`distutils.debug`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.debug) – Режим отладки Distutils Этот модуль предоставляет флаг DEBUG. ## 10.16. [`distutils.errors`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.errors) – Исключения Distutils Предоставляет исключения, используемые модулями Distutils. Обратите внимание, что модули Distutils могут вызывать стандартные исключения; в частности, SystemExit обычно возбуждается для ошибок, которые явно являются виной конечного пользователя (например, неправильные аргументы командной строки). Этот модуль безопасно использовать в режиме `from ... import *`; он экспортирует только символы, имена которых начинаются с `Distutils` и заканчиваются на `Error`. ## 10.17. [`distutils.fancy_getopt`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.fancy_getopt) – Обёртка вокруг стандартного модуля getopt Этот модуль предоставляет обёртку вокруг стандартного модуля [`getopt`](https://python-all.ru/2.7/library/getopt.html#module-getopt), которая предоставляет следующие дополнительные возможности: - короткие и длинные опции привязаны друг к другу - опции имеют строки справки, поэтому [`fancy_getopt()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.fancy_getopt.fancy_getopt) потенциально может создать полную сводку использования - опции устанавливают атрибуты переданного объекта - булевы опции могут иметь «отрицательные псевдонимы» – например, если `--quiet` – это «отрицательный псевдоним» для `--verbose`, то `--quiet` в командной строке устанавливает *verbose* в false. #### `distutils.fancy_getopt.fancy_getopt(options, negative_opt, object, args)` Функция-обёртка. *options* – это список `(long_option, short_option, help_string)` 3-кортежей, как описано в конструкторе [`FancyGetopt`](https://python-all.ru/2.7/distutils/apiref.html#distutils.fancy_getopt.FancyGetopt). *negative\_opt* должен быть словарём, сопоставляющим имена опций именам опций; и ключ, и значение должны быть в списке *options*. *object* – это объект, который будет использоваться для хранения значений (см. метод [`getopt()`](https://python-all.ru/2.7/library/getopt.html#module-getopt) класса [`FancyGetopt`](https://python-all.ru/2.7/distutils/apiref.html#distutils.fancy_getopt.FancyGetopt)). *args* – это список аргументов. Будет использован `sys.argv[1:]`, если передать `None` в качестве *args*. #### `distutils.fancy_getopt.wrap_text(text, width)` Переносит *text* до ширины менее *width*. #### `class distutils.fancy_getopt.FancyGetopt([option_table=None])` option\_table – это список 3-кортежей: `(long_option, short_option, help_string)` Если опция принимает аргумент, её *long\_option* должен оканчиваться на `'='`; *short\_option* должен быть просто одним символом, ни в коем случае без `':'`. *short\_option* должен быть `None`, если *long\_option* не имеет соответствующего *short\_option*. Все кортежи опций должны включать длинную опцию. Класс [`FancyGetopt`](https://python-all.ru/2.7/distutils/apiref.html#distutils.fancy_getopt.FancyGetopt) предоставляет следующие методы: #### `FancyGetopt.getopt([args=None, object=None])` Разбирает параметры командной строки в args. Сохраняет как атрибуты *object*. Если *args* – `None` или не указан, используется `sys.argv[1:]`. Если *object* – `None` или не указан, создаётся новый экземпляр `OptionDummy`, сохраняются значения опций и возвращается кортеж `(args, object)`. Если *object* указан, он изменяется на месте, и [`getopt()`](https://python-all.ru/2.7/library/getopt.html#module-getopt) просто возвращает *args*; в обоих случаях возвращаемый *args* – это изменённая копия переданного списка *args*, который остаётся нетронутым. #### `FancyGetopt.get_option_order()` Возвращает список кортежей `(option, value)`, обработанных предыдущим вызовом [`getopt()`](https://python-all.ru/2.7/library/getopt.html#module-getopt). Вызывает [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError), если [`getopt()`](https://python-all.ru/2.7/library/getopt.html#module-getopt) ещё не вызывался. #### `FancyGetopt.generate_help([header=None])` Генерирует текст справки (список строк, по одной на каждую предлагаемую строку вывода) из таблицы опций для данного объекта [`FancyGetopt`](https://python-all.ru/2.7/distutils/apiref.html#distutils.fancy_getopt.FancyGetopt). Если указан, выводит переданный *header* в начале справки. ## 10.18. [`distutils.filelist`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.filelist) – Класс FileList Этот модуль предоставляет класс `FileList`, используемый для обхода файловой системы и построения списков файлов. ## 10.19. [`distutils.log`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.log) – Простое логирование в стиле PEP 282 ## 10.20. [`distutils.spawn`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.spawn) – Запуск подпроцесса Этот модуль предоставляет функцию `spawn()` – интерфейс к различным платформенно-зависимым функциям для запуска другой программы в подпроцессе. Также предоставляет `find_executable()` для поиска заданного исполняемого файла по путям. ## 10.21. [`distutils.sysconfig`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.sysconfig) – Информация о конфигурации системы Модуль [`distutils.sysconfig`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.sysconfig) предоставляет доступ к низкоуровневой информации о конфигурации Python. Доступные конкретные переменные конфигурации сильно зависят от платформы и конфигурации. Конкретные переменные зависят от процесса сборки для конкретной версии Python; это те переменные, которые находятся в `Makefile` и заголовочном файле конфигурации, устанавливаемом вместе с Python в Unix-системах. Заголовочный файл называется `pyconfig.h` для Python версий 2.2 и новее, и `config.h` для более ранних версий Python. Предоставляются также некоторые дополнительные функции, выполняющие полезные преобразования для других частей пакета [`distutils`](https://python-all.ru/2.7/library/distutils.html#module-distutils). #### `distutils.sysconfig.PREFIX` Результат `os.path.normpath(sys.prefix)`. #### `distutils.sysconfig.EXEC_PREFIX` Результат `os.path.normpath(sys.exec_prefix)`. #### `distutils.sysconfig.get_config_var(name)` Возвращает значение одной переменной. Эквивалентно `get_config_vars().get(name)`. #### `distutils.sysconfig.get_config_vars(...)` Возвращает набор определений переменных. Если аргументы не переданы, возвращается словарь, сопоставляющий имена конфигурационных переменных их значениям. Если аргументы указаны, они должны быть строками, а возвращаемое значение будет последовательностью соответствующих значений. Если для указанного имени нет соответствующего значения, `None` будет включено для этой переменной. #### `distutils.sysconfig.get_config_h_filename()` Возвращает полное имя файла заголовка конфигурации. Для Unix это будет заголовок, сгенерированный сценарием **configure**; для других платформ заголовок поставляется непосредственно с дистрибутивом исходных кодов Python. Этот файл является платформозависимым текстовым файлом. #### `distutils.sysconfig.get_makefile_filename()` Возвращает полное имя файла `Makefile`, использованного для сборки Python. Для Unix это будет файл, сгенерированный сценарием **configure**; на других платформах значение может различаться. Файл является платформозависимым текстовым файлом (если он существует). Эта функция полезна только на платформах POSIX. #### `distutils.sysconfig.get_python_inc([plat_specific[, prefix]])` Возвращает каталог для общих или платформозависимых C-заголовочных файлов. Если *plat\_specific* равен true, возвращается платформозависимый каталог include; если false или не указан, возвращается платформонезависимый каталог. Если указан *prefix*, он используется как префикс вместо [`PREFIX`](https://python-all.ru/2.7/distutils/apiref.html#distutils.sysconfig.PREFIX), или как exec-prefix вместо [`EXEC_PREFIX`](https://python-all.ru/2.7/distutils/apiref.html#distutils.sysconfig.EXEC_PREFIX), если *plat\_specific* равен true. #### `distutils.sysconfig.get_python_lib([plat_specific[, standard_lib[, prefix]]])` Возвращает каталог для установки общих или платформозависимых библиотек. Если *plat\_specific* равен true, возвращается платформозависимый каталог include; если false или не указан, возвращается платформонезависимый каталог. Если указан *prefix*, он используется как префикс вместо [`PREFIX`](https://python-all.ru/2.7/distutils/apiref.html#distutils.sysconfig.PREFIX), или как exec-prefix вместо [`EXEC_PREFIX`](https://python-all.ru/2.7/distutils/apiref.html#distutils.sysconfig.EXEC_PREFIX), если *plat\_specific* равен true. Если *standard\_lib* равен true, возвращается каталог для стандартной библиотеки, а не для установки сторонних расширений. Следующая функция предназначена только для использования в пакете [`distutils`](https://python-all.ru/2.7/library/distutils.html#module-distutils). #### `distutils.sysconfig.customize_compiler(compiler)` Выполняет любую платформозависимую настройку экземпляра [`distutils.ccompiler.CCompiler`](https://python-all.ru/2.7/distutils/apiref.html#distutils.ccompiler.CCompiler). Эта функция сейчас требуется только на Unix, но её следует вызывать последовательно для обеспечения прямой совместимости. Она вставляет информацию, которая различается в разных версиях Unix и хранится в `Makefile` Python. Эта информация включает выбранный компилятор, параметры компилятора и компоновщика, а также расширение, используемое компоновщиком для разделяемых объектов. Эта функция ещё более специализированная и должна использоваться только в процедурах сборки самого Python. #### `distutils.sysconfig.set_python_build()` Сообщает модулю [`distutils.sysconfig`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.sysconfig), что он используется как часть процесса сборки Python. Это изменяет множество относительных расположений файлов, позволяя им находиться в каталоге сборки, а не в установленном Python. ## 10.22. [`distutils.text_file`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.text_file) – класс TextFile Этот модуль предоставляет класс [`TextFile`](https://python-all.ru/2.7/distutils/apiref.html#distutils.text_file.TextFile), который предоставляет интерфейс к текстовым файлам, (опционально) обрабатывающий удаление комментариев, игнорирование пустых строк и объединение строк с обратной косой чертой. #### `class distutils.text_file.TextFile([filename=None, file=None, **options])` Этот класс предоставляет объект, подобный файлу, который заботится обо всех вещах, которые обычно нужно делать при обработке текстового файла с построчным синтаксисом: удаление комментариев (если `#` является символом комментария), пропуск пустых строк, объединение соседних строк с помощью экранирования перевода строки (т.е. обратная косая черта в конце строки), удаление начальных и/или конечных пробелов. Все эти возможности опциональны и управляются независимо. Класс предоставляет метод [`warn()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.text_file.TextFile.warn) для генерации предупреждений с указанием физического номера строки, даже если логическая строка охватывает несколько физических строк. Также предоставляет [`unreadline()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.text_file.TextFile.unreadline) для реализации построчного просмотра вперед. Экземпляры [`TextFile`](https://python-all.ru/2.7/distutils/apiref.html#distutils.text_file.TextFile) создаются с помощью *filename*, *file* или обоих. [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError) возникает, если оба равны `None`. *filename* должна быть строкой, а *file* – файловым объектом (или чем-то, предоставляющим методы [`readline()`](https://python-all.ru/2.7/library/readline.html#module-readline) и [`close()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.text_file.TextFile.close)). Рекомендуется указывать хотя бы *filename*, чтобы [`TextFile`](https://python-all.ru/2.7/distutils/apiref.html#distutils.text_file.TextFile) мог включать его в предупреждения. Если *file* не указан, [`TextFile`](https://python-all.ru/2.7/distutils/apiref.html#distutils.text_file.TextFile) создаёт собственный файловый объект с помощью встроенной функции [`open()`](https://python-all.ru/2.7/library/functions.html#open). Все параметры логические и влияют на значения, возвращаемые [`readline()`](https://python-all.ru/2.7/library/readline.html#module-readline). | имя параметра | описание | по умолчанию | | --- | --- | --- | | *strip\_comments* | удалять от `'#'` до конца строки, а также все пробельные символы перед `'#'` – если только они не экранированы обратной косой чертой | истина | | *lstrip\_ws* | удаляет начальные пробелы из каждой строки перед её возвратом | ложь | | *rstrip\_ws* | Удаляет завершающие пробелы (включая символ конца строки!) из каждой строки перед её возвратом. | истина | | *skip\_blanks* | Пропускает строки, которые пусты \*после\* удаления комментариев и пробелов. (Если и lstrip\_ws, и rstrip\_ws равны false, то некоторые строки могут состоять только из пробелов: они \*не\* будут пропущены, даже если *skip\_blanks* равно true.) | истина | | *join\_lines* | если обратная косая черта – последний символ (не перевод строки) в строке после удаления комментариев и пробелов, соединить следующую строку с ней, чтобы получить одну логическую строку; если N последовательных строк заканчиваются обратной косой чертой, то N+1 физических строк будут объединены для образования одной логической строки. | ложь | | *collapse\_join* | удаляет начальные пробелы из строк, которые присоединяются к предыдущей; имеет значение только если `(join_lines and not lstrip_ws)` | ложь | Отметим, что поскольку *rstrip\_ws* может удалять завершающий перевод строки, семантика [`readline()`](https://python-all.ru/2.7/library/readline.html#module-readline) должна отличаться от семантики метода [`readline()`](https://python-all.ru/2.7/library/readline.html#module-readline) встроенного файлового объекта! В частности, [`readline()`](https://python-all.ru/2.7/library/readline.html#module-readline) возвращает `None` при достижении конца файла: пустая строка может быть просто пустой строкой (или строкой из одних пробелов), если *rstrip\_ws* равно true, а *skip\_blanks* – нет. #### `open(filename)` Открывает новый файл *filename*. Это переопределяет любые аргументы конструктора *file* или *filename*. #### `close()` Закрывает текущий файл и забывает всю информацию о нём (включая имя файла и текущий номер строки). #### `warn(msg[, line=None])` Выводит (в stderr) предупреждение, привязанное к текущей логической строке в текущем файле. Если текущая логическая строка в файле охватывает несколько физических строк, предупреждение относится ко всему диапазону, например `"lines 3-5"`. Если указан *line*, он переопределяет текущий номер строки; он может быть списком или кортежем для указания диапазона физических строк, или целым числом для одной физической строки. #### `readline()` Читает и возвращает одну логическую строку из текущего файла (или из внутреннего буфера, если строки ранее были «возвращены» с помощью [`unreadline()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.text_file.TextFile.unreadline)). Если опция *join\_lines* равна true, это может включать чтение нескольких физических строк, объединённых в одну строку. Обновляет текущий номер строки, поэтому вызов [`warn()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.text_file.TextFile.warn) после [`readline()`](https://python-all.ru/2.7/library/readline.html#module-readline) вызывает предупреждение о только что прочитанных физических строках. Возвращает `None` при достижении конца файла, поскольку пустая строка может быть получена, если *rstrip\_ws* равно true, а *strip\_blanks* – нет. #### `readlines()` Читает и возвращает список всех логических строк, оставшихся в текущем файле. Это обновляет текущий номер строки до последней строки файла. #### `unreadline(line)` Помещает *line* (строку) во внутренний буфер, который будет проверяться последующими вызовами [`readline()`](https://python-all.ru/2.7/library/readline.html#module-readline). Полезно для реализации синтаксического анализатора с просмотром на одну строку вперёд. Обратите внимание, что строки, «возвращённые» с помощью [`unreadline()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.text_file.TextFile.unreadline), впоследствии не проходят повторную очистку (удаление пробелов и т.п.) при чтении с помощью [`readline()`](https://python-all.ru/2.7/library/readline.html#module-readline). Если выполняется несколько вызовов [`unreadline()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.text_file.TextFile.unreadline) перед вызовом [`readline()`](https://python-all.ru/2.7/library/readline.html#module-readline), строки возвращаются в порядке «последний пришёл – первый вышел». ## 10.23. [`distutils.version`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.version) – Классы номеров версий ## 10.24. [`distutils.cmd`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.cmd) – Абстрактный базовый класс для команд Distutils Этот модуль предоставляет абстрактный базовый класс [`Command`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command). #### `class distutils.cmd.Command(dist)` Абстрактный базовый класс для определения классов команд, «рабочих пчёл» Distutils. Полезная аналогия для классов команд – рассматривать их как подпрограммы с локальными переменными, называемыми *options*. Опции объявляются в [`initialize_options()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command.initialize_options) и определяются (получают свои окончательные значения) в [`finalize_options()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command.finalize_options); оба метода должны быть определены в каждом классе команд. Различие между ними необходимо, потому что значения опций могут поступать из внешнего мира (командная строка, конфигурационный файл и т.д.), и любые опции, зависящие от других опций, должны вычисляться после обработки этих внешних воздействий – отсюда [`finalize_options()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command.finalize_options). Тело подпрограммы, где она выполняет всю свою работу на основе значений опций, – это метод [`run()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command.run), который также должен быть реализован в каждом классе команд. Конструктор класса принимает единственный аргумент *dist*, экземпляр [`Distribution`](https://python-all.ru/2.7/distutils/apiref.html#distutils.core.Distribution). ## 10.25. Создание новой команды Distutils В этом разделе описываются шаги по созданию новой команды Distutils. Новая команда находится в модуле пакета [`distutils.command`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command). В этом каталоге есть шаблон под названием `command_template`. Скопируйте этот файл в новый модуль с тем же именем, что и реализуемая команда. Этот модуль должен содержать класс с тем же именем, что и модуль (и команда). Например, чтобы создать команду `peel_banana` (чтобы пользователи могли запускать `setup.py peel_banana`), нужно скопировать `command_template` в `distutils/command/peel_banana.py`, а затем отредактировать его так, чтобы он реализовывал класс `peel_banana`, подкласс [`distutils.cmd.Command`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command). Подклассы [`Command`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command) должны определять следующие методы. #### `Command.initialize_options()` Устанавливает значения по умолчанию для всех параметров, поддерживаемых этой командой. Обратите внимание: эти умолчания могут быть переопределены другими командами, сценарием setup, файлами конфигурации или командной строкой. Поэтому здесь не место прописывать зависимости между параметрами; обычно реализация [`initialize_options()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command.initialize_options) представляет собой просто набор присваиваний `self.foo = None`. #### `Command.finalize_options()` Устанавливает окончательные значения для всех параметров, поддерживаемых этой командой. Этот метод всегда вызывается как можно позже, то есть после того, как были выполнены все присваивания параметров из командной строки или из других команд. Таким образом, это место для кодирования зависимостей между параметрами: если *foo* зависит от *bar*, то можно безопасно задать *foo* из *bar* при условии, что *foo* всё ещё имеет то же значение, которое было присвоено в [`initialize_options()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command.initialize_options). #### `Command.run()` Смысл существования команды: выполнить действие, ради которого она создана, управляемое параметрами, инициализированными в [`initialize_options()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command.initialize_options), настроенными другими командами, сценарием setup, командной строкой и файлами конфигурации, и окончательно установленными в [`finalize_options()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command.finalize_options). Весь вывод в терминал и взаимодействие с файловой системой должны выполняться через [`run()`](https://python-all.ru/2.7/distutils/apiref.html#distutils.cmd.Command.run). #### `Command.sub_commands` *sub\_commands* формализует понятие «семейства» команд, например `install` как родительская команда с подкомандами `install_lib`, `install_headers` и т.д. Родитель семейства команд определяет *sub\_commands* как атрибут класса; это список 2-кортежей `(command_name, predicate)`, где *command\_name* – строка, а *predicate* – функция, строка или `None`. *predicate* – метод родительской команды, который определяет, применима ли соответствующая команда в текущей ситуации. (Например, `install_headers` применима только при наличии C-заголовочных файлов для установки.) Если *predicate* равно `None`, эта команда применима всегда. *sub\_commands* обычно определяется в *конце* класса, потому что предикаты могут быть методами класса, а значит, они уже должны быть определены. Канонический пример – команда **install**. ## 10.26. [`distutils.command`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command) – Отдельные команды Distutils ## 10.27. [`distutils.command.bdist`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.bdist) – Сборка двоичного установщика ## 10.28. [`distutils.command.bdist_packager`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.bdist_packager) – Абстрактный базовый класс для упаковщиков ## 10.29. [`distutils.command.bdist_dumb`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.bdist_dumb) – Сборка «тупого» установщика ## 10.30. [`distutils.command.bdist_msi`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.bdist_msi) – Сборка двоичного пакета Microsoft Installer #### `class distutils.command.bdist_msi.bdist_msi` Создаёт двоичный пакет [Windows Installer](https://python-all.ru/2.7/distutils/apiref.html) (.msi). В большинстве случаев `bdist_msi` установщик лучше, чем `bdist_wininst` установщик, так как он обеспечивает лучшую поддержку платформ Win64, позволяет администраторам выполнять неинтерактивные установки, а также установку через групповые политики. ## 10.31. [`distutils.command.bdist_rpm`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.bdist_rpm) – Сборка двоичного дистрибутива в формате Redhat RPM и SRPM ## 10.32. [`distutils.command.bdist_wininst`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.bdist_wininst) – Сборка установщика Windows ## 10.33. [`distutils.command.sdist`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.sdist) – Сборка дистрибутива из исходных кодов ## 10.34. [`distutils.command.build`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.build) – Сборка всех файлов пакета ## 10.35. [`distutils.command.build_clib`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.build_clib) – Сборка любых C-библиотек в пакете ## 10.36. [`distutils.command.build_ext`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.build_ext) – Сборка любых расширений в пакете ## 10.37. [`distutils.command.build_py`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.build_py) – Сборка .py/.pyc файлов пакета ## 10.38. [`distutils.command.build_scripts`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.build_scripts) – Сборка сценариев пакета ## 10.39. [`distutils.command.clean`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.clean) – Очистка области сборки пакета Эта команда удаляет временные файлы, созданные **build** и его подкомандами, например промежуточные объектные файлы. С опцией `--all` будет удалена вся директория сборки. Модули расширения, собранные [на месте](https://python-all.ru/2.7/distutils/configfile.html#distutils-build-ext-inplace), не будут очищены, так как они не находятся в директории сборки. ## 10.40. [`distutils.command.config`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.config) – Выполнение конфигурации пакета ## 10.41. [`distutils.command.install`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.install) – Установить пакет ## 10.42. [`distutils.command.install_data`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.install_data) – Установить файлы данных из пакета ## 10.43. [`distutils.command.install_headers`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.install_headers) – Установить заголовочные файлы C/C++ из пакета ## 10.44. [`distutils.command.install_lib`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.install_lib) – Установить файлы библиотек из пакета ## 10.45. [`distutils.command.install_scripts`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.install_scripts) – Установить скриптовые файлы из пакета ## 10.46. [`distutils.command.register`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.register) – Зарегистрировать модуль в Python Package Index Команда `register` регистрирует пакет в Python Package Index. Это подробно описано в [**PEP 301**](https://python-all.ru/2.7/distutils/apiref.html). ## 10.47. [`distutils.command.check`](https://python-all.ru/2.7/distutils/apiref.html#module-distutils.command.check) – Проверить метаданные пакета Команда `check` выполняет несколько проверок метаданных пакета. Например, она проверяет, что все обязательные метаданные переданы в аргументах функции `setup()`.