codeop.md

1> **Источник:** https://python-all.ru/3.0/library/codeop.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `codeop` – Компиляция кода Python89Модуль `codeop` предоставляет утилиты, на основе которых можно эмулировать цикл чтения, вычисления и вывода Python, как это делается в модуле [`code`](https://python-all.ru/3.0/library/code.html#module-code). Поэтому данный модуль, скорее всего, не требуется использовать напрямую; если необходимо включить такой цикл в программу, вероятно, стоит использовать модуль [`code`](https://python-all.ru/3.0/library/code.html#module-code).1011Эта задача состоит из двух частей:12131. Возможность определить, завершает ли строка ввода оператор Python: проще говоря, решить, выводить ли дальше ‘`>>>`‘ или ‘`...`‘.142. Запоминание того, какие future-инструкции ввёл пользователь, чтобы последующий ввод можно было компилировать с их учётом.1516Модуль `codeop` предоставляет способ выполнять каждое из этих действий, а также способ выполнять их оба.1718Чтобы выполнить только первое:1920#### `[codeop.compile_command]codeop.compile_command(source[, filename[, symbol]])`2122Пытается скомпилировать *source*, который должен быть строкой кода Python, и возвращает объект кода, если *source* является корректным кодом Python. В этом случае атрибут filename объекта кода будет равен *filename*, который по умолчанию равен `'<input>'`. Возвращает `None`, если *source* *не* является корректным кодом Python, но является префиксом корректного кода Python.2324Если с *source* возникла проблема, будет возбуждено исключение. [`SyntaxError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.SyntaxError) возбуждается при неверном синтаксисе Python, а [`OverflowError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.OverflowError) или [`ValueError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.ValueError) – при неверном литерале.2526Аргумент *symbol* определяет, компилируется ли *source* как инструкция (`'single'`, по умолчанию) или как [*выражение*](https://python-all.ru/3.0/glossary.html#term-expression) (`'eval'`). Любое другое значение приведёт к возбуждению [`ValueError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.ValueError).2728> **Предупреждение**29>30> Возможно (хотя маловероятно), что синтаксический анализатор прекратит разбор с успешным результатом до достижения конца исходного кода; в этом случае завершающие символы могут игнорироваться, а не вызывать ошибку. Например, обратная косая черта, за которой следуют две пустые строки, может сопровождаться произвольным мусором. Это будет исправлено, когда API анализатора станет лучше.3132#### `[codeop.Compile]class codeop.Compile`3334Экземпляры этого класса имеют методы3536[`__call__()`](https://python-all.ru/3.0/reference/datamodel.html#object.__call__)3738с сигнатурой, идентичной встроенной функции3940[`compile()`](https://python-all.ru/3.0/library/functions.html#compile)4142, но с тем отличием, что если экземпляр компилирует текст программы, содержащий инструкцию4344[`__future__`](https://python-all.ru/3.0/library/__future__.html#module-__future__)4546, то он 'запоминает' и компилирует все последующие тексты программ с учётом этой инструкции.4748#### `[codeop.CommandCompiler]class codeop.CommandCompiler`4950Экземпляры этого класса имеют методы5152[`__call__()`](https://python-all.ru/3.0/reference/datamodel.html#object.__call__)5354с сигнатурой, идентичной5556[`compile_command()`](https://python-all.ru/3.0/library/codeop.html#codeop.compile_command)5758; отличие в том, что если экземпляр компилирует текст программы, содержащий инструкцию5960`__future__`6162, то он 'запоминает' и компилирует все последующие тексты программ с учётом этой инструкции.63