Документация Python неофициальный перевод

py_compile – Компиляция исходных файлов Pythonpy_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 в дереве каталогов.