py_compile – Компиляция исходных файлов Python¶py_compile – Compile Python source files
Модуль py_compile предоставляет функцию для создания файла байт-кода из исходного файла, а также другую функцию, используемую при вызове исходного файла модуля в качестве сценария.
Хотя эта функция требуется нечасто, она может быть полезна при установке модулей для общего использования, особенно если некоторые пользователи могут не иметь прав на запись файлов кэша байт-кода в каталог, содержащий исходный код.
- exception py_compile.PyCompileError¶
- Исключение, возникающее при попытке компиляции файла.
- py_compile.compile(file[, cfile[, dfile[, doraise]]])¶
- Компилирует исходный файл в байт-код и записывает файл кэша байт-кода. Исходный код загружается из файла с именем file. Байт-код записывается в cfile, который по умолчанию равен file + 'c' ('o', если в текущем интерпретаторе включена оптимизация). Если указан dfile, он используется как имя исходного файла в сообщениях об ошибках вместо file. Если doraise равно true, при возникновении ошибки во время компиляции file возбуждается PyCompileError. Если doraise равно false (по умолчанию), строка с ошибкой записывается в sys.stderr, но исключение не возбуждается.
- py_compile.main([args])¶
- Компилирует несколько исходных файлов. Файлы, указанные в args (или в командной строке, если args не указан), компилируются, и полученный байт-код кэшируется обычным образом. Эта функция не ищет исходные файлы по структуре каталогов; она компилирует только явно указанные файлы.
При запуске этого модуля как скрипта, функция main() используется для компиляции всех файлов, перечисленных в командной строке. Код возврата будет ненулевым, если один из файлов не удалось скомпилировать.
См. также
- Модуль compileall
- Утилиты для компиляции всех исходных файлов Python в дереве каталогов.