🕷️ Crawler Inspector

URL Lookup

Direct Parameter Lookup

Raw Queries and Responses

1. Shard Calculation

Query:

Response:

Calculated Shard: 143 (from laksa155)

2. Crawled Status Check

Query:

curl -X POST \
  'http://laksa143.int.ahrefs:8124/' \
  -H 'Content-Type: text/plain' \
  -H 'X-ClickHouse-Database: crawler3' \
  -H 'Authorization: Basic YXBpOg==' \
  -d 'SELECT getAhrefsURLFromUnparsed(src_unparsed) AS found_url, ifNull(toUnixTimestamp(download_stamp), 0) AS crawl_time, ifNull(toUnixTimestamp(props_url_first_seen), 0) AS first_indexed_time, download_http_code AS http_code, src_unparsed AS src_unparsed, src_root_hash AS src_root_hash, history_drop_reason AS history_drop_reason, meta_title AS meta_title, meta_descriptions AS meta_descriptions, attrs_boilerpipe_text AS attrs_boilerpipe_text, attrs_markdown AS attrs_markdown, attrs_readable_markdown AS attrs_readable_markdown, meta_canonical AS meta_canonical FROM crawler3.page_info_local FINAL PREWHERE (src_root_hash, src_unparsed) IN ((getAhrefsRootHashFromUnparsed(getAhrefsUnparsedNoserviceFromURL(\'https://django.fun/docs/python/3.11/library/py_compile/\')), getAhrefsUnparsedNoserviceFromURL(\'https://django.fun/docs/python/3.11/library/py_compile/\'))) FORMAT JSONEachRow'

Response:

{"found_url":"https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/","crawl_time":1775265832,"first_indexed_time":1746216096,"http_code":200,"src_unparsed":"fun,django!\/docs\/python\/3.11\/library\/py_compile\/ s443","src_root_hash":"14748620484168611943","history_drop_reason":null,"meta_title":"py_compile — Скомпилируйте исходные файлы Python | Документация Python 3.11 | Все о фреймворке Джанго и его библиотеках","meta_descriptions":["py_compile — Скомпилируйте исходные файлы Python Исходный код: Lib\/py_compile.py Модуль py_compile предоставляет функцию для генерации файла байт-кода из исходного файла и другую функцию, используемую, когда исходный файл модуля вызывается как скрипт. Хотя эта функция и не часто требуется, она может …"],"attrs_boilerpipe_text":"Исходный код:\nLib\/py_compile.py\nМодуль\npy_compile\nпредоставляет функцию для генерации файла байт-кода из исходного файла и другую функцию, используемую, когда исходный файл модуля вызывается как скрипт.\nХотя эта функция и не часто требуется, она может быть полезна при установке модулей для совместного использования, особенно если у некоторых пользователей может не быть разрешения на запись файлов кэша байт-кода в каталог, содержащий исходный код.\nexception\npy_compile.\nPyCompileError\n¶\nИсключение возникает при возникновении ошибки при попытке скомпилировать файл.\npy_compile.\ncompile\n(\nfile\n,\ncfile\n=\nNone\n,\ndfile\n=\nNone\n,\ndoraise\n=\nFalse\n,\noptimize\n=\n-1\n,\ninvalidation_mode\n=\nPycInvalidationMode.TIMESTAMP\n,\nquiet\n=\n0\n)\n¶\nСкомпилируйте исходный файл в байт-код и запишите файл кэша байт-кода. Исходный код загружается из файла с именем\nfile\n.  Байт-код записывается в\ncfile\n, который по умолчанию имеет значение\nPEP 3147\nPEP 488\npath, заканчивающийся на\n.pyc\n. Например, если значение\nfile\nравно\n\/foo\/bar\/baz.py\n, то значение\ncfile\nпо умолчанию будет равно\n\/foo\/bar\/__pycache__\/baz.cpython-32.pyc\nдля Python 3.2. Если указано значение\ndfile\n, оно используется вместо\nfile\nв качестве имени исходного файла, из которого получены исходные строки для отображения в трассировках исключений. Если значение\ndoraise\nравно true, то при возникновении ошибки при компиляции\nfile\nвыдается сообщение\nPyCompileError\n. Если значение\ndoraise\nравно false (значение по умолчанию), строка ошибки записывается в\nsys.stderr\n, но исключение не генерируется.  Эта функция возвращает путь к файлу, скомпилированному в байтах, т.е. любое значение\ncfile\n, которое было использовано.\nЭти аргументы\ndoraise\nи\nquiet\nопределяют, как обрабатываются ошибки при компиляции файла. Если значение\nquiet\nравно 0 или 1, а значение\ndoraise\nравно false, то включается поведение по умолчанию: строка ошибки записывается в\nsys.stderr\n, и функция возвращает\nNone\nвместо пути. Если значение\ndoraise\nравно true, то вместо этого выводится значение\nPyCompileError\n. Однако, если значение\nquiet\nравно 2, сообщение не выводится, и\ndoraise\nне действует.\nЕсли путь, которым становится\ncfile\n(либо явно указанный, либо вычисленный), является символической ссылкой или необычным файлом, будет поднят\nFileExistsError\n. Это служит предупреждением о том, что импорт преобразует эти пути в обычные файлы, если разрешено записывать в них файлы, скомпилированные по байтам. Это побочный эффект импорта, использующего переименование файлов для размещения конечного файла, скомпилированного по байтам, на место, чтобы предотвратить проблемы с одновременной записью файлов.\nоптимизировать\nуправляет уровнем оптимизации и передается встроенной функции\ncompile()\n.  Значение по умолчанию\n-1\nопределяет уровень оптимизации текущего интерпретатора.\ninvalidation_mode\nдолжен быть членом перечисления\nPycInvalidationMode\nи управляет тем, как сгенерированный кэш байт-кода становится недействительным во время выполнения.  Значение по умолчанию равно\nPycInvalidationMode.CHECKED_HASH\n, если задана переменная окружения\nSOURCE_DATE_EPOCH\n, в противном случае значение по умолчанию равно\nPycInvalidationMode.TIMESTAMP\n.\nИзменено в версии 3.2:\nИзменено значение по умолчанию для\ncfile\n, чтобы оно соответствовало\nPEP 3147\n.  Предыдущее значение по умолчанию было\nfile\n+\n'c'\n(\n'o'\nесли была включена оптимизация). Также добавлен параметр\nоптимизировать\n.\nИзменено в версии 3.4:\nИзменен код, чтобы использовать\nimportlib\nдля записи файла в кэш с байт-кодом. Это означает, что семантика записи при создании файла теперь совпадает с семантикой\nimportlib\n, например, разрешения, семантика записи и перемещения и т.д. Также добавлено предостережение о том, что\nFileExistsError\nвозникает, если\ncfile\nявляется символической ссылкой или необычным файлом.\nИзменено в версии 3.7:\nПараметр\ninvalidation_mode\nбыл добавлен, как указано в\nPEP 552\n. Если задана переменная окружения\nSOURCE_DATE_EPOCH\n, для параметра\ninvalidation_mode\nбудет принудительно присвоено значение\nPycInvalidationMode.CHECKED_HASH\n.\nИзменено в версии 3.7.2:\nПеременная окружения\nSOURCE_DATE_EPOCH\nбольше не переопределяет значение аргумента\ninvalidation_mode\nи вместо этого определяет его значение по умолчанию.\nИзменено в версии 3.8:\nБыл добавлен параметр\nquiet\n.\nclass\npy_compile.\nPycInvalidationMode\n¶\nСписок возможных методов, которые интерпретатор может использовать для определения соответствия файла байт-кода исходному файлу. В заголовке файла\n.pyc\nуказывается желаемый режим аннулирования. Смотрите\nНедействительность кэшированного байт-кода\nдля получения дополнительной информации о том, как Python делает недействительными файлы\n.pyc\nво время выполнения.\nДобавлено в версии 3.7.\nTIMESTAMP\n¶\nФайл\n.pyc\nсодержит временную метку и размер исходного файла, которые Python сравнит с метаданными исходного файла во время выполнения, чтобы определить, нужно ли восстанавливать файл\n.pyc\n.\nCHECKED_HASH\n¶\nФайл\n.pyc\nсодержит хэш содержимого исходного файла, который Python сравнит с исходным кодом во время выполнения, чтобы определить, нужно ли восстанавливать файл\n.pyc\n.\nUNCHECKED_HASH\n¶\nКак и\nCHECKED_HASH\n, файл\n.pyc\nсодержит хэш содержимого исходного файла. Однако во время выполнения Python будет предполагать, что файл\n.pyc\nобновлен, и вообще не будет проверять\n.pyc\nна соответствие исходному файлу.\nЭта опция полезна, когда\n.pycs\nподдерживается в актуальном состоянии какой-либо системой, внешней по отношению к Python, например системой сборки.\nИнтерфейс командной строки\n¶\nЭтот модуль может быть вызван как скрипт для компиляции нескольких исходных файлов.  Файлы, указанные в\nfilenames\n, компилируются, и результирующий байт-код кэшируется обычным способом.  Эта программа не выполняет поиск в структуре каталогов для поиска исходных файлов; она только компилирует файлы с явными именами. Статус завершения не равен нулю, если один из файлов не удалось скомпилировать.\n<file>\n...\n<fileN>\n¶\n-\n¶\nПозиционные аргументы - это файлы для компиляции.  Если\n-\nявляется единственным параметром, список файлов берется из стандартного ввода.\n-q\n,\n--quiet\n¶\nПодавляйте вывод ошибок.\nИзменено в версии 3.2:\nДобавлена поддержка\n-\n.\nИзменено в версии 3.10:\nДобавлена поддержка\n-q\n.\nСм.также\nМодуль\ncompileall\nУтилиты для компиляции всех исходных файлов Python в дерево каталогов.","attrs_markdown":"[Django.fun](https:\/\/django.fun\/)\n\n- [Документация](https:\/\/django.fun\/docs\/)\n  [Django - документация на русском Django (Джанго) — свободный фреймворк для веб-приложений на языке Python, использующий шаблон проектирования MVC. Документация на русском языке.](https:\/\/django.fun\/docs\/django\/stable\/)\n  \n  [Python - документация на русском Python — это простой в освоении мощный язык программирования.](https:\/\/django.fun\/docs\/python\/stable\/)\n  \n  [Рецепты Django ORM Рецепты Django ORM - это книга о работе с моделями Django ORM и Django. Django ORM является одним из ключевых столпов Django.](https:\/\/django.fun\/docs\/django-orm-cookbook\/stable\/)\n  \n  [Django Rest Framework Django Rest Framework (DRF) — это библиотека, которая работает со стандартными моделями Django для создания гибкого и мощного API для проекта.](https:\/\/django.fun\/docs\/django-rest-framework\/stable\/)\n  \n  [SQLAlchemy на русском SQLAlchemy — это набор инструментов Python SQL и Object Relational Mapper, который дает разработчикам приложений всю мощь и гибкость SQL.](https:\/\/django.fun\/docs\/sqlalchemy\/stable\/)\n  \n  [Django CMS Django CMS - это современная платформа для веб-публикаций, построенная на Django, фреймворке веб-приложений «для перфекционистов с соблюдением сроков».](https:\/\/django.fun\/docs\/django-cms\/stable\/)\n  \n  [Документация по Python Social Auth Python Social Auth - это простой в настройке механизм социальной аутентификации\/регистрации с поддержкой нескольких платформ и провайдеров аутентификации.](https:\/\/django.fun\/docs\/social-docs\/stable\/)\n  \n  [Celery Очереди задач используются как механизм распределения работы между потоками или машинами. Входом очереди задач является единица работы, называемая задачей.](https:\/\/django.fun\/docs\/celery\/stable\/)\n  \n  [Перейти к полному списку библиотек →](https:\/\/django.fun\/docs\/)\n- [Статьи](https:\/\/django.fun\/articles\/)\n  [Статьи Учебники по фреймворку Django, его особенностям, случаям использования и общим полезным вещам о фреймворке.](https:\/\/django.fun\/articles\/tutorials\/)\n  \n  [Советы Различные маленькие подсказки, советы, необычные применения Django - маленькие полезные вещи.](https:\/\/django.fun\/articles\/tips\/)\n  \n  [Видеоуроки Видеоуроки по фреймворку Django, основам и использованию Python и Django.](https:\/\/django.fun\/articles\/videos\/)\n  \n  [Новости Новости Django. Будьте в курсе последних изменений и событий.](https:\/\/django.fun\/articles\/news\/)\n  \n  [Python Учебники по Python, его функциям, применению и общим полезным вещам.](https:\/\/django.fun\/articles\/python\/)\n- [Вопросы и ответы](https:\/\/django.fun\/qa\/)\n- [Классы-представления](https:\/\/django.fun\/cbv\/)\n\n✕\n\n☰\n\n# [`py_compile`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#module-py_compile \"py_compile: Generate byte-code files from Python source files.\") — Скомпилируйте исходные файлы Python[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#module-py_compile \"Permalink to this heading\")\n**Исходный код:** [Lib\/py\\_compile.py](https:\/\/github.com\/python\/cpython\/tree\/3.11\/Lib\/py_compile.py)\n***\nМодуль [`py_compile`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#module-py_compile \"py_compile: Generate byte-code files from Python source files.\") предоставляет функцию для генерации файла байт-кода из исходного файла и другую функцию, используемую, когда исходный файл модуля вызывается как скрипт.\n\nХотя эта функция и не часто требуется, она может быть полезна при установке модулей для совместного использования, особенно если у некоторых пользователей может не быть разрешения на запись файлов кэша байт-кода в каталог, содержащий исходный код.\n\n*exception* py\\_compile.PyCompileError[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PyCompileError \"Ссылка на это определение\")\n\nИсключение возникает при возникновении ошибки при попытке скомпилировать файл.\n\npy\\_compile.compile(*file*, *cfile\\=None*, *dfile\\=None*, *doraise\\=False*, *optimize\\=\\-1*, *invalidation\\_mode\\=PycInvalidationMode.TIMESTAMP*, *quiet\\=0*)[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.compile \"Ссылка на это определение\")\n\nСкомпилируйте исходный файл в байт-код и запишите файл кэша байт-кода. Исходный код загружается из файла с именем *file*. Байт-код записывается в *cfile*, который по умолчанию имеет значение [**PEP 3147**](https:\/\/peps.python.org\/pep-3147\/)[**PEP 488**](https:\/\/peps.python.org\/pep-0488\/) path, заканчивающийся на `.pyc`. Например, если значение *file* равно `\/foo\/bar\/baz.py`, то значение *cfile* по умолчанию будет равно `\/foo\/bar\/__pycache__\/baz.cpython-32.pyc` для Python 3.2. Если указано значение *dfile*, оно используется вместо *file* в качестве имени исходного файла, из которого получены исходные строки для отображения в трассировках исключений. Если значение *doraise* равно true, то при возникновении ошибки при компиляции *file* выдается сообщение [`PyCompileError`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PyCompileError \"py_compile.PyCompileError\"). Если значение *doraise* равно false (значение по умолчанию), строка ошибки записывается в `sys.stderr`, но исключение не генерируется. Эта функция возвращает путь к файлу, скомпилированному в байтах, т.е. любое значение *cfile*, которое было использовано.\n\nЭти аргументы *doraise* и *quiet* определяют, как обрабатываются ошибки при компиляции файла. Если значение *quiet* равно 0 или 1, а значение *doraise* равно false, то включается поведение по умолчанию: строка ошибки записывается в `sys.stderr`, и функция возвращает `None` вместо пути. Если значение *doraise* равно true, то вместо этого выводится значение [`PyCompileError`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PyCompileError \"py_compile.PyCompileError\"). Однако, если значение *quiet* равно 2, сообщение не выводится, и *doraise* не действует.\n\nЕсли путь, которым становится *cfile* (либо явно указанный, либо вычисленный), является символической ссылкой или необычным файлом, будет поднят [`FileExistsError`](https:\/\/django.fun\/docs\/python\/3.11\/library\/exceptions\/#FileExistsError \"FileExistsError\"). Это служит предупреждением о том, что импорт преобразует эти пути в обычные файлы, если разрешено записывать в них файлы, скомпилированные по байтам. Это побочный эффект импорта, использующего переименование файлов для размещения конечного файла, скомпилированного по байтам, на место, чтобы предотвратить проблемы с одновременной записью файлов.\n\n*оптимизировать* управляет уровнем оптимизации и передается встроенной функции [`compile()`](https:\/\/django.fun\/docs\/python\/3.11\/library\/functions\/#compile \"compile\"). Значение по умолчанию `-1` определяет уровень оптимизации текущего интерпретатора.\n\n*invalidation\\_mode* должен быть членом перечисления [`PycInvalidationMode`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode \"py_compile.PycInvalidationMode\") и управляет тем, как сгенерированный кэш байт-кода становится недействительным во время выполнения. Значение по умолчанию равно [`PycInvalidationMode.CHECKED_HASH`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.CHECKED_HASH \"py_compile.PycInvalidationMode.CHECKED_HASH\"), если задана переменная окружения `SOURCE_DATE_EPOCH`, в противном случае значение по умолчанию равно [`PycInvalidationMode.TIMESTAMP`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.TIMESTAMP \"py_compile.PycInvalidationMode.TIMESTAMP\").\n\nИзменено в версии 3.2: Изменено значение по умолчанию для *cfile*, чтобы оно соответствовало [**PEP 3147**](https:\/\/peps.python.org\/pep-3147\/). Предыдущее значение по умолчанию было *file* + `'c'` (`'o'` если была включена оптимизация). Также добавлен параметр *оптимизировать*.\n\nИзменено в версии 3.4: Изменен код, чтобы использовать [`importlib`](https:\/\/django.fun\/docs\/python\/3.11\/library\/importlib\/#module-importlib \"importlib: The implementation of the import machinery.\") для записи файла в кэш с байт-кодом. Это означает, что семантика записи при создании файла теперь совпадает с семантикой [`importlib`](https:\/\/django.fun\/docs\/python\/3.11\/library\/importlib\/#module-importlib \"importlib: The implementation of the import machinery.\"), например, разрешения, семантика записи и перемещения и т.д. Также добавлено предостережение о том, что [`FileExistsError`](https:\/\/django.fun\/docs\/python\/3.11\/library\/exceptions\/#FileExistsError \"FileExistsError\") возникает, если *cfile* является символической ссылкой или необычным файлом.\n\nИзменено в версии 3.7: Параметр *invalidation\\_mode* был добавлен, как указано в [**PEP 552**](https:\/\/peps.python.org\/pep-0552\/). Если задана переменная окружения `SOURCE_DATE_EPOCH`, для параметра *invalidation\\_mode* будет принудительно присвоено значение [`PycInvalidationMode.CHECKED_HASH`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.CHECKED_HASH \"py_compile.PycInvalidationMode.CHECKED_HASH\").\n\nИзменено в версии 3.7.2: Переменная окружения `SOURCE_DATE_EPOCH` больше не переопределяет значение аргумента *invalidation\\_mode* и вместо этого определяет его значение по умолчанию.\n\nИзменено в версии 3.8: Был добавлен параметр *quiet*.\n\n*class* py\\_compile.PycInvalidationMode[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode \"Ссылка на это определение\")\n\nСписок возможных методов, которые интерпретатор может использовать для определения соответствия файла байт-кода исходному файлу. В заголовке файла `.pyc` указывается желаемый режим аннулирования. Смотрите [Недействительность кэшированного байт-кода](https:\/\/django.fun\/docs\/python\/3.11\/reference\/import\/#pyc-invalidation) для получения дополнительной информации о том, как Python делает недействительными файлы `.pyc` во время выполнения.\n\nДобавлено в версии 3.7.\n\nTIMESTAMP[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.TIMESTAMP \"Ссылка на это определение\")\n\nФайл `.pyc` содержит временную метку и размер исходного файла, которые Python сравнит с метаданными исходного файла во время выполнения, чтобы определить, нужно ли восстанавливать файл `.pyc`.\n\nCHECKED\\_HASH[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.CHECKED_HASH \"Ссылка на это определение\")\n\nФайл `.pyc` содержит хэш содержимого исходного файла, который Python сравнит с исходным кодом во время выполнения, чтобы определить, нужно ли восстанавливать файл `.pyc`.\n\nUNCHECKED\\_HASH[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.UNCHECKED_HASH \"Ссылка на это определение\")\n\nКак и [`CHECKED_HASH`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.CHECKED_HASH \"py_compile.PycInvalidationMode.CHECKED_HASH\"), файл `.pyc` содержит хэш содержимого исходного файла. Однако во время выполнения Python будет предполагать, что файл `.pyc` обновлен, и вообще не будет проверять `.pyc` на соответствие исходному файлу.\n\nЭта опция полезна, когда `.pycs` поддерживается в актуальном состоянии какой-либо системой, внешней по отношению к Python, например системой сборки.\n\n## Интерфейс командной строки[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#command-line-interface \"Permalink to this heading\")\nЭтот модуль может быть вызван как скрипт для компиляции нескольких исходных файлов. Файлы, указанные в *filenames*, компилируются, и результирующий байт-код кэшируется обычным способом. Эта программа не выполняет поиск в структуре каталогов для поиска исходных файлов; она только компилирует файлы с явными именами. Статус завершения не равен нулю, если один из файлов не удалось скомпилировать.\n\n\\<file\\> ... \\<fileN\\>[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#cmdoption-python-m-py_compile-arg-file \"Ссылка на это определение\")\n\n\\-[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#cmdoption-python-m-py_compile \"Ссылка на это определение\")\n\nПозиционные аргументы - это файлы для компиляции. Если `-` является единственным параметром, список файлов берется из стандартного ввода.\n\n\\-q, \\--quiet[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#cmdoption-python-m-py_compile-q \"Ссылка на это определение\")\n\nПодавляйте вывод ошибок.\n\nИзменено в версии 3.2: Добавлена поддержка `-`.\n\nИзменено в версии 3.10: Добавлена поддержка [`-q`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#cmdoption-python-m-py_compile-q).\n\nСм.также\n\nМодуль [`compileall`](https:\/\/django.fun\/docs\/python\/3.11\/library\/compileall\/#module-compileall \"compileall: Tools for byte-compiling all Python source files in a directory tree.\")\n\nУтилиты для компиляции всех исходных файлов Python в дерево каталогов.\n\n[`pyclbr` — Поддержка браузера модуля Python](https:\/\/django.fun\/docs\/python\/3.11\/library\/pyclbr\/)\n\n[`compileall` — Библиотеки Python для байтовой компиляции](https:\/\/django.fun\/docs\/python\/3.11\/library\/compileall\/)\n\n[Вернуться на верх](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#top)\n\n## **[Python 3.11](https:\/\/django.fun\/docs\/python\/3.11\/)**\n### Содержание\n- [`py_compile` — Скомпилируйте исходные файлы Python](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/)\n  - [Интерфейс командной строки](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#command-line-interface)\n### Дополнительно\n- [Алфавитный указатель](https:\/\/django.fun\/docs\/python\/3.11\/genindex\/)\n- [Содержание модулей Python](https:\/\/django.fun\/docs\/python\/3.11\/py-modindex\/)\n### Вы здесь:\n- [Документация Django Python 3.11](https:\/\/django.fun\/docs\/python\/3.11\/)\n  - [Стандартная библиотека Python](https:\/\/django.fun\/docs\/python\/3.11\/library\/)\n    - [Языковые сервисы Python](https:\/\/django.fun\/docs\/python\/3.11\/library\/language\/)\n      - `py_compile` — Скомпилируйте исходные файлы Python\n\n#### Документация\n[Django - документация на русском Django (Джанго) — свободный фреймворк для веб-приложений на языке Python, использующий шаблон проектирования MVC. Документация на русском языке.](https:\/\/django.fun\/docs\/django\/stable\/)\n\n[Python - документация на русском Python — это простой в освоении мощный язык программирования.](https:\/\/django.fun\/docs\/python\/stable\/)\n\n[Рецепты Django ORM Рецепты Django ORM - это книга о работе с моделями Django ORM и Django. Django ORM является одним из ключевых столпов Django.](https:\/\/django.fun\/docs\/django-orm-cookbook\/stable\/)\n\n[Django Rest Framework Django Rest Framework (DRF) — это библиотека, которая работает со стандартными моделями Django для создания гибкого и мощного API для проекта.](https:\/\/django.fun\/docs\/django-rest-framework\/stable\/)\n\n[SQLAlchemy на русском SQLAlchemy — это набор инструментов Python SQL и Object Relational Mapper, который дает разработчикам приложений всю мощь и гибкость SQL.](https:\/\/django.fun\/docs\/sqlalchemy\/stable\/)\n\n[Django CMS Django CMS - это современная платформа для веб-публикаций, построенная на Django, фреймворке веб-приложений «для перфекционистов с соблюдением сроков».](https:\/\/django.fun\/docs\/django-cms\/stable\/)\n\n[Документация по Python Social Auth Python Social Auth - это простой в настройке механизм социальной аутентификации\/регистрации с поддержкой нескольких платформ и провайдеров аутентификации.](https:\/\/django.fun\/docs\/social-docs\/stable\/)\n\n[Celery Очереди задач используются как механизм распределения работы между потоками или машинами. Входом очереди задач является единица работы, называемая задачей.](https:\/\/django.fun\/docs\/celery\/stable\/)\n\n[Перейти к полному списку библиотек →](https:\/\/django.fun\/docs\/)\n\n#### Статьи\n[Статьи Учебники по фреймворку Django, его особенностям, случаям использования и общим полезным вещам о фреймворке.](https:\/\/django.fun\/articles\/tutorials\/)\n\n[Советы Различные маленькие подсказки, советы, необычные применения Django - маленькие полезные вещи.](https:\/\/django.fun\/articles\/tips\/)\n\n[Видеоуроки Видеоуроки по фреймворку Django, основам и использованию Python и Django.](https:\/\/django.fun\/articles\/videos\/)\n\n[Новости Новости Django. Будьте в курсе последних изменений и событий.](https:\/\/django.fun\/articles\/news\/)\n\n[Python Учебники по Python, его функциям, применению и общим полезным вещам.](https:\/\/django.fun\/articles\/python\/)\n\n© [Django.Fun](https:\/\/django.fun\/) 2017-2025\n\nDjango.Fun не связан с Django Software Foundation. Django - зарегистрированная торговая марка Django Software Foundation.\n\n- [3\\.10](https:\/\/django.fun\/docs\/python\/3.10\/library\/py_compile\/)\n- Версия документации: **3\\.11**\n\n![](https:\/\/mc.yandex.ru\/watch\/46974723)","attrs_readable_markdown":"**Исходный код:** [Lib\/py\\_compile.py](https:\/\/github.com\/python\/cpython\/tree\/3.11\/Lib\/py_compile.py)\n***\nМодуль [`py_compile`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#module-py_compile \"py_compile: Generate byte-code files from Python source files.\") предоставляет функцию для генерации файла байт-кода из исходного файла и другую функцию, используемую, когда исходный файл модуля вызывается как скрипт.\n\nХотя эта функция и не часто требуется, она может быть полезна при установке модулей для совместного использования, особенно если у некоторых пользователей может не быть разрешения на запись файлов кэша байт-кода в каталог, содержащий исходный код.\n\n*exception* py\\_compile.PyCompileError[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PyCompileError \"Ссылка на это определение\")\n\nИсключение возникает при возникновении ошибки при попытке скомпилировать файл.\n\npy\\_compile.compile(*file*, *cfile\\=None*, *dfile\\=None*, *doraise\\=False*, *optimize\\=\\-1*, *invalidation\\_mode\\=PycInvalidationMode.TIMESTAMP*, *quiet\\=0*)[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.compile \"Ссылка на это определение\")\n\nСкомпилируйте исходный файл в байт-код и запишите файл кэша байт-кода. Исходный код загружается из файла с именем *file*. Байт-код записывается в *cfile*, который по умолчанию имеет значение [**PEP 3147**](https:\/\/peps.python.org\/pep-3147\/)[**PEP 488**](https:\/\/peps.python.org\/pep-0488\/) path, заканчивающийся на `.pyc`. Например, если значение *file* равно `\/foo\/bar\/baz.py`, то значение *cfile* по умолчанию будет равно `\/foo\/bar\/__pycache__\/baz.cpython-32.pyc` для Python 3.2. Если указано значение *dfile*, оно используется вместо *file* в качестве имени исходного файла, из которого получены исходные строки для отображения в трассировках исключений. Если значение *doraise* равно true, то при возникновении ошибки при компиляции *file* выдается сообщение [`PyCompileError`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PyCompileError \"py_compile.PyCompileError\"). Если значение *doraise* равно false (значение по умолчанию), строка ошибки записывается в `sys.stderr`, но исключение не генерируется. Эта функция возвращает путь к файлу, скомпилированному в байтах, т.е. любое значение *cfile*, которое было использовано.\n\nЭти аргументы *doraise* и *quiet* определяют, как обрабатываются ошибки при компиляции файла. Если значение *quiet* равно 0 или 1, а значение *doraise* равно false, то включается поведение по умолчанию: строка ошибки записывается в `sys.stderr`, и функция возвращает `None` вместо пути. Если значение *doraise* равно true, то вместо этого выводится значение [`PyCompileError`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PyCompileError \"py_compile.PyCompileError\"). Однако, если значение *quiet* равно 2, сообщение не выводится, и *doraise* не действует.\n\nЕсли путь, которым становится *cfile* (либо явно указанный, либо вычисленный), является символической ссылкой или необычным файлом, будет поднят [`FileExistsError`](https:\/\/django.fun\/docs\/python\/3.11\/library\/exceptions\/#FileExistsError \"FileExistsError\"). Это служит предупреждением о том, что импорт преобразует эти пути в обычные файлы, если разрешено записывать в них файлы, скомпилированные по байтам. Это побочный эффект импорта, использующего переименование файлов для размещения конечного файла, скомпилированного по байтам, на место, чтобы предотвратить проблемы с одновременной записью файлов.\n\n*оптимизировать* управляет уровнем оптимизации и передается встроенной функции [`compile()`](https:\/\/django.fun\/docs\/python\/3.11\/library\/functions\/#compile \"compile\"). Значение по умолчанию `-1` определяет уровень оптимизации текущего интерпретатора.\n\n*invalidation\\_mode* должен быть членом перечисления [`PycInvalidationMode`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode \"py_compile.PycInvalidationMode\") и управляет тем, как сгенерированный кэш байт-кода становится недействительным во время выполнения. Значение по умолчанию равно [`PycInvalidationMode.CHECKED_HASH`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.CHECKED_HASH \"py_compile.PycInvalidationMode.CHECKED_HASH\"), если задана переменная окружения `SOURCE_DATE_EPOCH`, в противном случае значение по умолчанию равно [`PycInvalidationMode.TIMESTAMP`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.TIMESTAMP \"py_compile.PycInvalidationMode.TIMESTAMP\").\n\nИзменено в версии 3.2: Изменено значение по умолчанию для *cfile*, чтобы оно соответствовало [**PEP 3147**](https:\/\/peps.python.org\/pep-3147\/). Предыдущее значение по умолчанию было *file* + `'c'` (`'o'` если была включена оптимизация). Также добавлен параметр *оптимизировать*.\n\nИзменено в версии 3.4: Изменен код, чтобы использовать [`importlib`](https:\/\/django.fun\/docs\/python\/3.11\/library\/importlib\/#module-importlib \"importlib: The implementation of the import machinery.\") для записи файла в кэш с байт-кодом. Это означает, что семантика записи при создании файла теперь совпадает с семантикой [`importlib`](https:\/\/django.fun\/docs\/python\/3.11\/library\/importlib\/#module-importlib \"importlib: The implementation of the import machinery.\"), например, разрешения, семантика записи и перемещения и т.д. Также добавлено предостережение о том, что [`FileExistsError`](https:\/\/django.fun\/docs\/python\/3.11\/library\/exceptions\/#FileExistsError \"FileExistsError\") возникает, если *cfile* является символической ссылкой или необычным файлом.\n\nИзменено в версии 3.7: Параметр *invalidation\\_mode* был добавлен, как указано в [**PEP 552**](https:\/\/peps.python.org\/pep-0552\/). Если задана переменная окружения `SOURCE_DATE_EPOCH`, для параметра *invalidation\\_mode* будет принудительно присвоено значение [`PycInvalidationMode.CHECKED_HASH`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.CHECKED_HASH \"py_compile.PycInvalidationMode.CHECKED_HASH\").\n\nИзменено в версии 3.7.2: Переменная окружения `SOURCE_DATE_EPOCH` больше не переопределяет значение аргумента *invalidation\\_mode* и вместо этого определяет его значение по умолчанию.\n\nИзменено в версии 3.8: Был добавлен параметр *quiet*.\n\n*class* py\\_compile.PycInvalidationMode[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode \"Ссылка на это определение\")\n\nСписок возможных методов, которые интерпретатор может использовать для определения соответствия файла байт-кода исходному файлу. В заголовке файла `.pyc` указывается желаемый режим аннулирования. Смотрите [Недействительность кэшированного байт-кода](https:\/\/django.fun\/docs\/python\/3.11\/reference\/import\/#pyc-invalidation) для получения дополнительной информации о том, как Python делает недействительными файлы `.pyc` во время выполнения.\n\nДобавлено в версии 3.7.\n\nTIMESTAMP[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.TIMESTAMP \"Ссылка на это определение\")\n\nФайл `.pyc` содержит временную метку и размер исходного файла, которые Python сравнит с метаданными исходного файла во время выполнения, чтобы определить, нужно ли восстанавливать файл `.pyc`.\n\nCHECKED\\_HASH[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.CHECKED_HASH \"Ссылка на это определение\")\n\nФайл `.pyc` содержит хэш содержимого исходного файла, который Python сравнит с исходным кодом во время выполнения, чтобы определить, нужно ли восстанавливать файл `.pyc`.\n\nUNCHECKED\\_HASH[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.UNCHECKED_HASH \"Ссылка на это определение\")\n\nКак и [`CHECKED_HASH`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#py_compile.PycInvalidationMode.CHECKED_HASH \"py_compile.PycInvalidationMode.CHECKED_HASH\"), файл `.pyc` содержит хэш содержимого исходного файла. Однако во время выполнения Python будет предполагать, что файл `.pyc` обновлен, и вообще не будет проверять `.pyc` на соответствие исходному файлу.\n\nЭта опция полезна, когда `.pycs` поддерживается в актуальном состоянии какой-либо системой, внешней по отношению к Python, например системой сборки.\n\n## Интерфейс командной строки[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#command-line-interface \"Permalink to this heading\")\nЭтот модуль может быть вызван как скрипт для компиляции нескольких исходных файлов. Файлы, указанные в *filenames*, компилируются, и результирующий байт-код кэшируется обычным способом. Эта программа не выполняет поиск в структуре каталогов для поиска исходных файлов; она только компилирует файлы с явными именами. Статус завершения не равен нулю, если один из файлов не удалось скомпилировать.\n\n\\<file\\> ... \\<fileN\\>[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#cmdoption-python-m-py_compile-arg-file \"Ссылка на это определение\")\n\n\\-[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#cmdoption-python-m-py_compile \"Ссылка на это определение\")\n\nПозиционные аргументы - это файлы для компиляции. Если `-` является единственным параметром, список файлов берется из стандартного ввода.\n\n\\-q, \\--quiet[¶](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#cmdoption-python-m-py_compile-q \"Ссылка на это определение\")\n\nПодавляйте вывод ошибок.\n\nИзменено в версии 3.2: Добавлена поддержка `-`.\n\nИзменено в версии 3.10: Добавлена поддержка [`-q`](https:\/\/django.fun\/docs\/python\/3.11\/library\/py_compile\/#cmdoption-python-m-py_compile-q).\n\nСм.также\n\nМодуль [`compileall`](https:\/\/django.fun\/docs\/python\/3.11\/library\/compileall\/#module-compileall \"compileall: Tools for byte-compiling all Python source files in a directory tree.\")\n\nУтилиты для компиляции всех исходных файлов Python в дерево каталогов.","meta_canonical":null}

3. Robots.txt Check

Query:

Response:

4. Spam/Ban Check

Query:

Response:

5. Seen Status Check

ℹ️ Skipped - page is already crawled

📄

INDEXABLE

✅

CRAWLED

5 days ago

🤖

ROBOTS ALLOWED

Page Info Filters

Filter	Status	Condition	Details
HTTP status	PASS	`download_http_code = 200`	HTTP 200
Age cutoff	PASS	`download_stamp > now() - 6 MONTH`	0.2 months ago
History drop	PASS	`isNull(history_drop_reason)`	No drop reason
Spam/ban	PASS	`fh_dont_index != 1 AND ml_spam_score = 0`	ml_spam_score=0
Canonical	PASS	`meta_canonical IS NULL OR = '' OR = src_unparsed`	Not set

Page Details

Property	Value
URL	https://django.fun/docs/python/3.11/library/py_compile/
Last Crawled	2026-04-04 01:23:52 (5 days ago)
First Indexed	2025-05-02 20:01:36 (11 months ago)
HTTP Status Code	200
Meta Title	py_compile — Скомпилируйте исходные файлы Python \| Документация Python 3.11 \| Все о фреймворке Джанго и его библиотеках
Meta Description	py_compile — Скомпилируйте исходные файлы Python Исходный код: Lib/py_compile.py Модуль py_compile предоставляет функцию для генерации файла байт-кода из исходного файла и другую функцию, используемую, когда исходный файл модуля вызывается как скрипт. Хотя эта функция и не часто требуется, она может …
Meta Canonical	null
Boilerpipe Text	Исходный код: Lib/py_compile.py Модуль py_compile предоставляет функцию для генерации файла байт-кода из исходного файла и другую функцию, используемую, когда исходный файл модуля вызывается как скрипт. Хотя эта функция и не часто требуется, она может быть полезна при установке модулей для совместного использования, особенно если у некоторых пользователей может не быть разрешения на запись файлов кэша байт-кода в каталог, содержащий исходный код. exception py_compile. PyCompileError ¶ Исключение возникает при возникновении ошибки при попытке скомпилировать файл. py_compile. compile ( file , cfile = None , dfile = None , doraise = False , optimize = -1 , invalidation_mode = PycInvalidationMode.TIMESTAMP , quiet = 0 ) ¶ Скомпилируйте исходный файл в байт-код и запишите файл кэша байт-кода. Исходный код загружается из файла с именем file . Байт-код записывается в cfile , который по умолчанию имеет значение PEP 3147 PEP 488 path, заканчивающийся на .pyc . Например, если значение file равно /foo/bar/baz.py , то значение cfile по умолчанию будет равно /foo/bar/__pycache__/baz.cpython-32.pyc для Python 3.2. Если указано значение dfile , оно используется вместо file в качестве имени исходного файла, из которого получены исходные строки для отображения в трассировках исключений. Если значение doraise равно true, то при возникновении ошибки при компиляции file выдается сообщение PyCompileError . Если значение doraise равно false (значение по умолчанию), строка ошибки записывается в sys.stderr , но исключение не генерируется. Эта функция возвращает путь к файлу, скомпилированному в байтах, т.е. любое значение cfile , которое было использовано. Эти аргументы doraise и quiet определяют, как обрабатываются ошибки при компиляции файла. Если значение quiet равно 0 или 1, а значение doraise равно false, то включается поведение по умолчанию: строка ошибки записывается в sys.stderr , и функция возвращает None вместо пути. Если значение doraise равно true, то вместо этого выводится значение PyCompileError . Однако, если значение quiet равно 2, сообщение не выводится, и doraise не действует. Если путь, которым становится cfile (либо явно указанный, либо вычисленный), является символической ссылкой или необычным файлом, будет поднят FileExistsError . Это служит предупреждением о том, что импорт преобразует эти пути в обычные файлы, если разрешено записывать в них файлы, скомпилированные по байтам. Это побочный эффект импорта, использующего переименование файлов для размещения конечного файла, скомпилированного по байтам, на место, чтобы предотвратить проблемы с одновременной записью файлов. оптимизировать управляет уровнем оптимизации и передается встроенной функции compile() . Значение по умолчанию -1 определяет уровень оптимизации текущего интерпретатора. invalidation_mode должен быть членом перечисления PycInvalidationMode и управляет тем, как сгенерированный кэш байт-кода становится недействительным во время выполнения. Значение по умолчанию равно PycInvalidationMode.CHECKED_HASH , если задана переменная окружения SOURCE_DATE_EPOCH , в противном случае значение по умолчанию равно PycInvalidationMode.TIMESTAMP . Изменено в версии 3.2: Изменено значение по умолчанию для cfile , чтобы оно соответствовало PEP 3147 . Предыдущее значение по умолчанию было file + 'c' ( 'o' если была включена оптимизация). Также добавлен параметр оптимизировать . Изменено в версии 3.4: Изменен код, чтобы использовать importlib для записи файла в кэш с байт-кодом. Это означает, что семантика записи при создании файла теперь совпадает с семантикой importlib , например, разрешения, семантика записи и перемещения и т.д. Также добавлено предостережение о том, что FileExistsError возникает, если cfile является символической ссылкой или необычным файлом. Изменено в версии 3.7: Параметр invalidation_mode был добавлен, как указано в PEP 552 . Если задана переменная окружения SOURCE_DATE_EPOCH , для параметра invalidation_mode будет принудительно присвоено значение PycInvalidationMode.CHECKED_HASH . Изменено в версии 3.7.2: Переменная окружения SOURCE_DATE_EPOCH больше не переопределяет значение аргумента invalidation_mode и вместо этого определяет его значение по умолчанию. Изменено в версии 3.8: Был добавлен параметр quiet . class py_compile. PycInvalidationMode ¶ Список возможных методов, которые интерпретатор может использовать для определения соответствия файла байт-кода исходному файлу. В заголовке файла .pyc указывается желаемый режим аннулирования. Смотрите Недействительность кэшированного байт-кода для получения дополнительной информации о том, как Python делает недействительными файлы .pyc во время выполнения. Добавлено в версии 3.7. TIMESTAMP ¶ Файл .pyc содержит временную метку и размер исходного файла, которые Python сравнит с метаданными исходного файла во время выполнения, чтобы определить, нужно ли восстанавливать файл .pyc . CHECKED_HASH ¶ Файл .pyc содержит хэш содержимого исходного файла, который Python сравнит с исходным кодом во время выполнения, чтобы определить, нужно ли восстанавливать файл .pyc . UNCHECKED_HASH ¶ Как и CHECKED_HASH , файл .pyc содержит хэш содержимого исходного файла. Однако во время выполнения Python будет предполагать, что файл .pyc обновлен, и вообще не будет проверять .pyc на соответствие исходному файлу. Эта опция полезна, когда .pycs поддерживается в актуальном состоянии какой-либо системой, внешней по отношению к Python, например системой сборки. Интерфейс командной строки ¶ Этот модуль может быть вызван как скрипт для компиляции нескольких исходных файлов. Файлы, указанные в filenames , компилируются, и результирующий байт-код кэшируется обычным способом. Эта программа не выполняет поиск в структуре каталогов для поиска исходных файлов; она только компилирует файлы с явными именами. Статус завершения не равен нулю, если один из файлов не удалось скомпилировать. <file> ... <fileN> ¶ - ¶ Позиционные аргументы - это файлы для компиляции. Если - является единственным параметром, список файлов берется из стандартного ввода. -q , --quiet ¶ Подавляйте вывод ошибок. Изменено в версии 3.2: Добавлена поддержка - . Изменено в версии 3.10: Добавлена поддержка -q . См.также Модуль compileall Утилиты для компиляции всех исходных файлов Python в дерево каталогов.
Markdown	[Django.fun](https://django.fun/) - [Документация](https://django.fun/docs/) [Django - документация на русском Django (Джанго) — свободный фреймворк для веб-приложений на языке Python, использующий шаблон проектирования MVC. Документация на русском языке.](https://django.fun/docs/django/stable/) [Python - документация на русском Python — это простой в освоении мощный язык программирования.](https://django.fun/docs/python/stable/) [Рецепты Django ORM Рецепты Django ORM - это книга о работе с моделями Django ORM и Django. Django ORM является одним из ключевых столпов Django.](https://django.fun/docs/django-orm-cookbook/stable/) [Django Rest Framework Django Rest Framework (DRF) — это библиотека, которая работает со стандартными моделями Django для создания гибкого и мощного API для проекта.](https://django.fun/docs/django-rest-framework/stable/) [SQLAlchemy на русском SQLAlchemy — это набор инструментов Python SQL и Object Relational Mapper, который дает разработчикам приложений всю мощь и гибкость SQL.](https://django.fun/docs/sqlalchemy/stable/) [Django CMS Django CMS - это современная платформа для веб-публикаций, построенная на Django, фреймворке веб-приложений «для перфекционистов с соблюдением сроков».](https://django.fun/docs/django-cms/stable/) [Документация по Python Social Auth Python Social Auth - это простой в настройке механизм социальной аутентификации/регистрации с поддержкой нескольких платформ и провайдеров аутентификации.](https://django.fun/docs/social-docs/stable/) [Celery Очереди задач используются как механизм распределения работы между потоками или машинами. Входом очереди задач является единица работы, называемая задачей.](https://django.fun/docs/celery/stable/) [Перейти к полному списку библиотек →](https://django.fun/docs/) - [Статьи](https://django.fun/articles/) [Статьи Учебники по фреймворку Django, его особенностям, случаям использования и общим полезным вещам о фреймворке.](https://django.fun/articles/tutorials/) [Советы Различные маленькие подсказки, советы, необычные применения Django - маленькие полезные вещи.](https://django.fun/articles/tips/) [Видеоуроки Видеоуроки по фреймворку Django, основам и использованию Python и Django.](https://django.fun/articles/videos/) [Новости Новости Django. Будьте в курсе последних изменений и событий.](https://django.fun/articles/news/) [Python Учебники по Python, его функциям, применению и общим полезным вещам.](https://django.fun/articles/python/) - [Вопросы и ответы](https://django.fun/qa/) - [Классы-представления](https://django.fun/cbv/) ✕ ☰ # [`py_compile`](https://django.fun/docs/python/3.11/library/py_compile/#module-py_compile "py_compile: Generate byte-code files from Python source files.") — Скомпилируйте исходные файлы Python[¶](https://django.fun/docs/python/3.11/library/py_compile/#module-py_compile "Permalink to this heading") Исходный код: [Lib/py\_compile.py](https://github.com/python/cpython/tree/3.11/Lib/py_compile.py) *** Модуль [`py_compile`](https://django.fun/docs/python/3.11/library/py_compile/#module-py_compile "py_compile: Generate byte-code files from Python source files.") предоставляет функцию для генерации файла байт-кода из исходного файла и другую функцию, используемую, когда исходный файл модуля вызывается как скрипт. Хотя эта функция и не часто требуется, она может быть полезна при установке модулей для совместного использования, особенно если у некоторых пользователей может не быть разрешения на запись файлов кэша байт-кода в каталог, содержащий исходный код. exception py\_compile.PyCompileError[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PyCompileError "Ссылка на это определение") Исключение возникает при возникновении ошибки при попытке скомпилировать файл. py\_compile.compile(file, cfile\=None, dfile\=None, doraise\=False, optimize\=\-1, invalidation\_mode\=PycInvalidationMode.TIMESTAMP, quiet\=0)[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.compile "Ссылка на это определение") Скомпилируйте исходный файл в байт-код и запишите файл кэша байт-кода. Исходный код загружается из файла с именем file. Байт-код записывается в cfile, который по умолчанию имеет значение [PEP 3147](https://peps.python.org/pep-3147/)[PEP 488](https://peps.python.org/pep-0488/) path, заканчивающийся на `.pyc`. Например, если значение file равно `/foo/bar/baz.py`, то значение cfile по умолчанию будет равно `/foo/bar/__pycache__/baz.cpython-32.pyc` для Python 3.2. Если указано значение dfile, оно используется вместо file в качестве имени исходного файла, из которого получены исходные строки для отображения в трассировках исключений. Если значение doraise равно true, то при возникновении ошибки при компиляции file выдается сообщение [`PyCompileError`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PyCompileError "py_compile.PyCompileError"). Если значение doraise равно false (значение по умолчанию), строка ошибки записывается в `sys.stderr`, но исключение не генерируется. Эта функция возвращает путь к файлу, скомпилированному в байтах, т.е. любое значение cfile, которое было использовано. Эти аргументы doraise и quiet определяют, как обрабатываются ошибки при компиляции файла. Если значение quiet равно 0 или 1, а значение doraise равно false, то включается поведение по умолчанию: строка ошибки записывается в `sys.stderr`, и функция возвращает `None` вместо пути. Если значение doraise равно true, то вместо этого выводится значение [`PyCompileError`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PyCompileError "py_compile.PyCompileError"). Однако, если значение quiet равно 2, сообщение не выводится, и doraise не действует. Если путь, которым становится cfile (либо явно указанный, либо вычисленный), является символической ссылкой или необычным файлом, будет поднят [`FileExistsError`](https://django.fun/docs/python/3.11/library/exceptions/#FileExistsError "FileExistsError"). Это служит предупреждением о том, что импорт преобразует эти пути в обычные файлы, если разрешено записывать в них файлы, скомпилированные по байтам. Это побочный эффект импорта, использующего переименование файлов для размещения конечного файла, скомпилированного по байтам, на место, чтобы предотвратить проблемы с одновременной записью файлов. оптимизировать управляет уровнем оптимизации и передается встроенной функции [`compile()`](https://django.fun/docs/python/3.11/library/functions/#compile "compile"). Значение по умолчанию `-1` определяет уровень оптимизации текущего интерпретатора. invalidation\_mode должен быть членом перечисления [`PycInvalidationMode`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode "py_compile.PycInvalidationMode") и управляет тем, как сгенерированный кэш байт-кода становится недействительным во время выполнения. Значение по умолчанию равно [`PycInvalidationMode.CHECKED_HASH`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.CHECKED_HASH "py_compile.PycInvalidationMode.CHECKED_HASH"), если задана переменная окружения `SOURCE_DATE_EPOCH`, в противном случае значение по умолчанию равно [`PycInvalidationMode.TIMESTAMP`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.TIMESTAMP "py_compile.PycInvalidationMode.TIMESTAMP"). Изменено в версии 3.2: Изменено значение по умолчанию для cfile, чтобы оно соответствовало [PEP 3147](https://peps.python.org/pep-3147/). Предыдущее значение по умолчанию было file + `'c'` (`'o'` если была включена оптимизация). Также добавлен параметр оптимизировать. Изменено в версии 3.4: Изменен код, чтобы использовать [`importlib`](https://django.fun/docs/python/3.11/library/importlib/#module-importlib "importlib: The implementation of the import machinery.") для записи файла в кэш с байт-кодом. Это означает, что семантика записи при создании файла теперь совпадает с семантикой [`importlib`](https://django.fun/docs/python/3.11/library/importlib/#module-importlib "importlib: The implementation of the import machinery."), например, разрешения, семантика записи и перемещения и т.д. Также добавлено предостережение о том, что [`FileExistsError`](https://django.fun/docs/python/3.11/library/exceptions/#FileExistsError "FileExistsError") возникает, если cfile является символической ссылкой или необычным файлом. Изменено в версии 3.7: Параметр invalidation\_mode был добавлен, как указано в [PEP 552](https://peps.python.org/pep-0552/). Если задана переменная окружения `SOURCE_DATE_EPOCH`, для параметра invalidation\_mode будет принудительно присвоено значение [`PycInvalidationMode.CHECKED_HASH`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.CHECKED_HASH "py_compile.PycInvalidationMode.CHECKED_HASH"). Изменено в версии 3.7.2: Переменная окружения `SOURCE_DATE_EPOCH` больше не переопределяет значение аргумента invalidation\_mode и вместо этого определяет его значение по умолчанию. Изменено в версии 3.8: Был добавлен параметр quiet. class py\_compile.PycInvalidationMode[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode "Ссылка на это определение") Список возможных методов, которые интерпретатор может использовать для определения соответствия файла байт-кода исходному файлу. В заголовке файла `.pyc` указывается желаемый режим аннулирования. Смотрите [Недействительность кэшированного байт-кода](https://django.fun/docs/python/3.11/reference/import/#pyc-invalidation) для получения дополнительной информации о том, как Python делает недействительными файлы `.pyc` во время выполнения. Добавлено в версии 3.7. TIMESTAMP[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.TIMESTAMP "Ссылка на это определение") Файл `.pyc` содержит временную метку и размер исходного файла, которые Python сравнит с метаданными исходного файла во время выполнения, чтобы определить, нужно ли восстанавливать файл `.pyc`. CHECKED\_HASH[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.CHECKED_HASH "Ссылка на это определение") Файл `.pyc` содержит хэш содержимого исходного файла, который Python сравнит с исходным кодом во время выполнения, чтобы определить, нужно ли восстанавливать файл `.pyc`. UNCHECKED\_HASH[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.UNCHECKED_HASH "Ссылка на это определение") Как и [`CHECKED_HASH`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.CHECKED_HASH "py_compile.PycInvalidationMode.CHECKED_HASH"), файл `.pyc` содержит хэш содержимого исходного файла. Однако во время выполнения Python будет предполагать, что файл `.pyc` обновлен, и вообще не будет проверять `.pyc` на соответствие исходному файлу. Эта опция полезна, когда `.pycs` поддерживается в актуальном состоянии какой-либо системой, внешней по отношению к Python, например системой сборки. ## Интерфейс командной строки[¶](https://django.fun/docs/python/3.11/library/py_compile/#command-line-interface "Permalink to this heading") Этот модуль может быть вызван как скрипт для компиляции нескольких исходных файлов. Файлы, указанные в filenames, компилируются, и результирующий байт-код кэшируется обычным способом. Эта программа не выполняет поиск в структуре каталогов для поиска исходных файлов; она только компилирует файлы с явными именами. Статус завершения не равен нулю, если один из файлов не удалось скомпилировать. \<file\> ... \<fileN\>[¶](https://django.fun/docs/python/3.11/library/py_compile/#cmdoption-python-m-py_compile-arg-file "Ссылка на это определение") \-[¶](https://django.fun/docs/python/3.11/library/py_compile/#cmdoption-python-m-py_compile "Ссылка на это определение") Позиционные аргументы - это файлы для компиляции. Если `-` является единственным параметром, список файлов берется из стандартного ввода. \-q, \--quiet[¶](https://django.fun/docs/python/3.11/library/py_compile/#cmdoption-python-m-py_compile-q "Ссылка на это определение") Подавляйте вывод ошибок. Изменено в версии 3.2: Добавлена поддержка `-`. Изменено в версии 3.10: Добавлена поддержка [`-q`](https://django.fun/docs/python/3.11/library/py_compile/#cmdoption-python-m-py_compile-q). См.также Модуль [`compileall`](https://django.fun/docs/python/3.11/library/compileall/#module-compileall "compileall: Tools for byte-compiling all Python source files in a directory tree.") Утилиты для компиляции всех исходных файлов Python в дерево каталогов. [`pyclbr` — Поддержка браузера модуля Python](https://django.fun/docs/python/3.11/library/pyclbr/) [`compileall` — Библиотеки Python для байтовой компиляции](https://django.fun/docs/python/3.11/library/compileall/) [Вернуться на верх](https://django.fun/docs/python/3.11/library/py_compile/#top) ## [Python 3.11](https://django.fun/docs/python/3.11/) ### Содержание - [`py_compile` — Скомпилируйте исходные файлы Python](https://django.fun/docs/python/3.11/library/py_compile/) - [Интерфейс командной строки](https://django.fun/docs/python/3.11/library/py_compile/#command-line-interface) ### Дополнительно - [Алфавитный указатель](https://django.fun/docs/python/3.11/genindex/) - [Содержание модулей Python](https://django.fun/docs/python/3.11/py-modindex/) ### Вы здесь: - [Документация Django Python 3.11](https://django.fun/docs/python/3.11/) - [Стандартная библиотека Python](https://django.fun/docs/python/3.11/library/) - [Языковые сервисы Python](https://django.fun/docs/python/3.11/library/language/) - `py_compile` — Скомпилируйте исходные файлы Python #### Документация [Django - документация на русском Django (Джанго) — свободный фреймворк для веб-приложений на языке Python, использующий шаблон проектирования MVC. Документация на русском языке.](https://django.fun/docs/django/stable/) [Python - документация на русском Python — это простой в освоении мощный язык программирования.](https://django.fun/docs/python/stable/) [Рецепты Django ORM Рецепты Django ORM - это книга о работе с моделями Django ORM и Django. Django ORM является одним из ключевых столпов Django.](https://django.fun/docs/django-orm-cookbook/stable/) [Django Rest Framework Django Rest Framework (DRF) — это библиотека, которая работает со стандартными моделями Django для создания гибкого и мощного API для проекта.](https://django.fun/docs/django-rest-framework/stable/) [SQLAlchemy на русском SQLAlchemy — это набор инструментов Python SQL и Object Relational Mapper, который дает разработчикам приложений всю мощь и гибкость SQL.](https://django.fun/docs/sqlalchemy/stable/) [Django CMS Django CMS - это современная платформа для веб-публикаций, построенная на Django, фреймворке веб-приложений «для перфекционистов с соблюдением сроков».](https://django.fun/docs/django-cms/stable/) [Документация по Python Social Auth Python Social Auth - это простой в настройке механизм социальной аутентификации/регистрации с поддержкой нескольких платформ и провайдеров аутентификации.](https://django.fun/docs/social-docs/stable/) [Celery Очереди задач используются как механизм распределения работы между потоками или машинами. Входом очереди задач является единица работы, называемая задачей.](https://django.fun/docs/celery/stable/) [Перейти к полному списку библиотек →](https://django.fun/docs/) #### Статьи [Статьи Учебники по фреймворку Django, его особенностям, случаям использования и общим полезным вещам о фреймворке.](https://django.fun/articles/tutorials/) [Советы Различные маленькие подсказки, советы, необычные применения Django - маленькие полезные вещи.](https://django.fun/articles/tips/) [Видеоуроки Видеоуроки по фреймворку Django, основам и использованию Python и Django.](https://django.fun/articles/videos/) [Новости Новости Django. Будьте в курсе последних изменений и событий.](https://django.fun/articles/news/) [Python Учебники по Python, его функциям, применению и общим полезным вещам.](https://django.fun/articles/python/) © [Django.Fun](https://django.fun/) 2017-2025 Django.Fun не связан с Django Software Foundation. Django - зарегистрированная торговая марка Django Software Foundation. - [3\.10](https://django.fun/docs/python/3.10/library/py_compile/) - Версия документации: 3\.11 ![](https://mc.yandex.ru/watch/46974723)
Readable Markdown	Исходный код: [Lib/py\_compile.py](https://github.com/python/cpython/tree/3.11/Lib/py_compile.py) *** Модуль [`py_compile`](https://django.fun/docs/python/3.11/library/py_compile/#module-py_compile "py_compile: Generate byte-code files from Python source files.") предоставляет функцию для генерации файла байт-кода из исходного файла и другую функцию, используемую, когда исходный файл модуля вызывается как скрипт. Хотя эта функция и не часто требуется, она может быть полезна при установке модулей для совместного использования, особенно если у некоторых пользователей может не быть разрешения на запись файлов кэша байт-кода в каталог, содержащий исходный код. exception py\_compile.PyCompileError[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PyCompileError "Ссылка на это определение") Исключение возникает при возникновении ошибки при попытке скомпилировать файл. py\_compile.compile(file, cfile\=None, dfile\=None, doraise\=False, optimize\=\-1, invalidation\_mode\=PycInvalidationMode.TIMESTAMP, quiet\=0)[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.compile "Ссылка на это определение") Скомпилируйте исходный файл в байт-код и запишите файл кэша байт-кода. Исходный код загружается из файла с именем file. Байт-код записывается в cfile, который по умолчанию имеет значение [PEP 3147](https://peps.python.org/pep-3147/)[PEP 488](https://peps.python.org/pep-0488/) path, заканчивающийся на `.pyc`. Например, если значение file равно `/foo/bar/baz.py`, то значение cfile по умолчанию будет равно `/foo/bar/__pycache__/baz.cpython-32.pyc` для Python 3.2. Если указано значение dfile, оно используется вместо file в качестве имени исходного файла, из которого получены исходные строки для отображения в трассировках исключений. Если значение doraise равно true, то при возникновении ошибки при компиляции file выдается сообщение [`PyCompileError`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PyCompileError "py_compile.PyCompileError"). Если значение doraise равно false (значение по умолчанию), строка ошибки записывается в `sys.stderr`, но исключение не генерируется. Эта функция возвращает путь к файлу, скомпилированному в байтах, т.е. любое значение cfile, которое было использовано. Эти аргументы doraise и quiet определяют, как обрабатываются ошибки при компиляции файла. Если значение quiet равно 0 или 1, а значение doraise равно false, то включается поведение по умолчанию: строка ошибки записывается в `sys.stderr`, и функция возвращает `None` вместо пути. Если значение doraise равно true, то вместо этого выводится значение [`PyCompileError`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PyCompileError "py_compile.PyCompileError"). Однако, если значение quiet равно 2, сообщение не выводится, и doraise не действует. Если путь, которым становится cfile (либо явно указанный, либо вычисленный), является символической ссылкой или необычным файлом, будет поднят [`FileExistsError`](https://django.fun/docs/python/3.11/library/exceptions/#FileExistsError "FileExistsError"). Это служит предупреждением о том, что импорт преобразует эти пути в обычные файлы, если разрешено записывать в них файлы, скомпилированные по байтам. Это побочный эффект импорта, использующего переименование файлов для размещения конечного файла, скомпилированного по байтам, на место, чтобы предотвратить проблемы с одновременной записью файлов. оптимизировать управляет уровнем оптимизации и передается встроенной функции [`compile()`](https://django.fun/docs/python/3.11/library/functions/#compile "compile"). Значение по умолчанию `-1` определяет уровень оптимизации текущего интерпретатора. invalidation\_mode должен быть членом перечисления [`PycInvalidationMode`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode "py_compile.PycInvalidationMode") и управляет тем, как сгенерированный кэш байт-кода становится недействительным во время выполнения. Значение по умолчанию равно [`PycInvalidationMode.CHECKED_HASH`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.CHECKED_HASH "py_compile.PycInvalidationMode.CHECKED_HASH"), если задана переменная окружения `SOURCE_DATE_EPOCH`, в противном случае значение по умолчанию равно [`PycInvalidationMode.TIMESTAMP`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.TIMESTAMP "py_compile.PycInvalidationMode.TIMESTAMP"). Изменено в версии 3.2: Изменено значение по умолчанию для cfile, чтобы оно соответствовало [PEP 3147](https://peps.python.org/pep-3147/). Предыдущее значение по умолчанию было file + `'c'` (`'o'` если была включена оптимизация). Также добавлен параметр оптимизировать. Изменено в версии 3.4: Изменен код, чтобы использовать [`importlib`](https://django.fun/docs/python/3.11/library/importlib/#module-importlib "importlib: The implementation of the import machinery.") для записи файла в кэш с байт-кодом. Это означает, что семантика записи при создании файла теперь совпадает с семантикой [`importlib`](https://django.fun/docs/python/3.11/library/importlib/#module-importlib "importlib: The implementation of the import machinery."), например, разрешения, семантика записи и перемещения и т.д. Также добавлено предостережение о том, что [`FileExistsError`](https://django.fun/docs/python/3.11/library/exceptions/#FileExistsError "FileExistsError") возникает, если cfile является символической ссылкой или необычным файлом. Изменено в версии 3.7: Параметр invalidation\_mode был добавлен, как указано в [PEP 552](https://peps.python.org/pep-0552/). Если задана переменная окружения `SOURCE_DATE_EPOCH`, для параметра invalidation\_mode будет принудительно присвоено значение [`PycInvalidationMode.CHECKED_HASH`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.CHECKED_HASH "py_compile.PycInvalidationMode.CHECKED_HASH"). Изменено в версии 3.7.2: Переменная окружения `SOURCE_DATE_EPOCH` больше не переопределяет значение аргумента invalidation\_mode и вместо этого определяет его значение по умолчанию. Изменено в версии 3.8: Был добавлен параметр quiet. class py\_compile.PycInvalidationMode[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode "Ссылка на это определение") Список возможных методов, которые интерпретатор может использовать для определения соответствия файла байт-кода исходному файлу. В заголовке файла `.pyc` указывается желаемый режим аннулирования. Смотрите [Недействительность кэшированного байт-кода](https://django.fun/docs/python/3.11/reference/import/#pyc-invalidation) для получения дополнительной информации о том, как Python делает недействительными файлы `.pyc` во время выполнения. Добавлено в версии 3.7. TIMESTAMP[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.TIMESTAMP "Ссылка на это определение") Файл `.pyc` содержит временную метку и размер исходного файла, которые Python сравнит с метаданными исходного файла во время выполнения, чтобы определить, нужно ли восстанавливать файл `.pyc`. CHECKED\_HASH[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.CHECKED_HASH "Ссылка на это определение") Файл `.pyc` содержит хэш содержимого исходного файла, который Python сравнит с исходным кодом во время выполнения, чтобы определить, нужно ли восстанавливать файл `.pyc`. UNCHECKED\_HASH[¶](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.UNCHECKED_HASH "Ссылка на это определение") Как и [`CHECKED_HASH`](https://django.fun/docs/python/3.11/library/py_compile/#py_compile.PycInvalidationMode.CHECKED_HASH "py_compile.PycInvalidationMode.CHECKED_HASH"), файл `.pyc` содержит хэш содержимого исходного файла. Однако во время выполнения Python будет предполагать, что файл `.pyc` обновлен, и вообще не будет проверять `.pyc` на соответствие исходному файлу. Эта опция полезна, когда `.pycs` поддерживается в актуальном состоянии какой-либо системой, внешней по отношению к Python, например системой сборки. ## Интерфейс командной строки[¶](https://django.fun/docs/python/3.11/library/py_compile/#command-line-interface "Permalink to this heading") Этот модуль может быть вызван как скрипт для компиляции нескольких исходных файлов. Файлы, указанные в filenames, компилируются, и результирующий байт-код кэшируется обычным способом. Эта программа не выполняет поиск в структуре каталогов для поиска исходных файлов; она только компилирует файлы с явными именами. Статус завершения не равен нулю, если один из файлов не удалось скомпилировать. \<file\> ... \<fileN\>[¶](https://django.fun/docs/python/3.11/library/py_compile/#cmdoption-python-m-py_compile-arg-file "Ссылка на это определение") \-[¶](https://django.fun/docs/python/3.11/library/py_compile/#cmdoption-python-m-py_compile "Ссылка на это определение") Позиционные аргументы - это файлы для компиляции. Если `-` является единственным параметром, список файлов берется из стандартного ввода. \-q, \--quiet[¶](https://django.fun/docs/python/3.11/library/py_compile/#cmdoption-python-m-py_compile-q "Ссылка на это определение") Подавляйте вывод ошибок. Изменено в версии 3.2: Добавлена поддержка `-`. Изменено в версии 3.10: Добавлена поддержка [`-q`](https://django.fun/docs/python/3.11/library/py_compile/#cmdoption-python-m-py_compile-q). См.также Модуль [`compileall`](https://django.fun/docs/python/3.11/library/compileall/#module-compileall "compileall: Tools for byte-compiling all Python source files in a directory tree.") Утилиты для компиляции всех исходных файлов Python в дерево каталогов.
Shard	143 (laksa)
Root Hash	14748620484168611943
Unparsed URL	fun,django!/docs/python/3.11/library/py_compile/ s443