# `code` — Interpreter base classes

Вихідний код: Lib/code.py

Модуль `code` надає засоби для реалізації циклів читання-оцінки-друку в Python. Включено два класи та додаткові функції, які можна використовувати для створення програм, які надають інтерактивну підказку інтерпретатора.

class code.InteractiveInterpreter(locals=None)

  This class deals with parsing and interpreter state (the user’s namespace); it does not deal with input buffering or prompting or input file naming (the filename is always passed in explicitly). The optional locals argument specifies a mapping to use as the namespace in which code will be executed; it defaults to a newly created dictionary with key `'__name__'` set to `'__console__'` and key `'__doc__'` set to `None`.

  Note that functions and classes objects created under an `InteractiveInterpreter` instance will belong to the namespace specified by locals. They are only pickleable if locals is the namespace of an existing module.

class code.InteractiveConsole(locals=None, filename='<console>', local_exit=False)

  Closely emulate the behavior of the interactive Python interpreter. This class builds on `InteractiveInterpreter` and adds prompting using the familiar `sys.ps1` and `sys.ps2`, and input buffering. If local_exit is true, `exit()` and `quit()` in the console will not raise `SystemExit`, but instead return to the calling code.

  Змінено в версії 3.13: Added local_exit parameter.

code.interact(banner=None, readfunc=None, local=None, exitmsg=None, local_exit=False)

  Convenience function to run a read-eval-print loop. This creates a new instance of `InteractiveConsole` and sets readfunc to be used as the `InteractiveConsole.raw_input()` method, if provided. If local is provided, it is passed to the `InteractiveConsole` constructor for use as the default namespace for the interpreter loop. If local_exit is provided, it is passed to the `InteractiveConsole` constructor. The `interact()` method of the instance is then run with banner and exitmsg passed as the banner and exit message to use, if provided. The console object is discarded after use.

  Змінено в версії 3.6: Додано параметр exitmsg.

  Змінено в версії 3.13: Added local_exit parameter.

code.compile_command(source, filename='<input>', symbol='single')

  Ця функція корисна для програм, які хочуть емулювати основний цикл інтерпретатора Python (він же цикл читання-оцінки-друку). Складна частина полягає в тому, щоб визначити, коли користувач ввів неповну команду, яку можна завершити введенням додаткового тексту (на відміну від повної команди чи синтаксичної помилки). Ця функція майже завжди приймає те саме рішення, що й основний цикл реального інтерпретатора.

  джерело - вихідний рядок; ім’я файлу — необов’язкове ім’я файлу, з якого було прочитано джерело, за умовчанням `' <input> ''`; і symbol є необов’язковим символом початку граматики, який має бути `'single'` (за замовчуванням), `'eval'` або `'exec'`.

  Повертає об’єкт коду (те саме, що `compile(source, filename, symbol)`), якщо команда повна та дійсна; `None`, якщо команда неповна; викликає `SyntaxError`, якщо команда завершена та містить синтаксичну помилку, або викликає `OverflowError` або `ValueError`, якщо команда містить недійсний літерал.

## Об’єкти інтерактивного інтерпретатора

InteractiveInterpreter.runsource(source, filename='<input>', symbol='single')

  Скомпілюйте та запустіть деяке джерело в інтерпретаторі. Аргументи такі самі, як і для `compile_command()`; за замовчуванням для ім’я файлу є `' <input> ''`, а для symbol — `'single'`. Може статися одне з кількох:

  - Введено неправильно; `compile_command()` викликала виняток (`SyntaxError` або `OverflowError`). Відстеження синтаксису буде надруковано викликом методу `showsyntaxerror()`. `runsource()` повертає `False`.

  - Вхідні дані неповні, потрібні додаткові дані; `compile_command()` повернула `None`. `runsource()` повертає `True`.

  - Введення завершено; `compile_command()` повернув об’єкт коду. Код виконується шляхом виклику `runcode()` (який також обробляє винятки під час виконання, за винятком `SystemExit`). `runsource()` повертає `False`.

  Значення, що повертається, можна використовувати, щоб вирішити, чи використовувати `sys.ps1` або `sys.ps2` для підказки наступного рядка.

InteractiveInterpreter.runcode(code)

  Виконати об’єкт коду. Коли виникає виняткова ситуація, `showtraceback()` викликається для відображення зворотного відстеження. Перехоплюються всі винятки, крім `SystemExit`, якому дозволено поширюватися.

  Примітка про `KeyboardInterrupt`: цей виняток може виникнути в іншому місці цього коду та не завжди може бути перехоплений. Той, хто дзвонить, повинен бути готовим до цього.

InteractiveInterpreter.showsyntaxerror(filename=None)

  Відобразити синтаксичну помилку, яка щойно сталася. Це не відображає трасування стека, оскільки немає трасування синтаксичних помилок. Якщо вказано filename, воно вставляється у виняток замість назви файлу за замовчуванням, наданої синтаксичним аналізатором Python, оскільки він завжди використовує `' <string> ''` під час читання з рядка. Вихід записується методом `write()`.

InteractiveInterpreter.showtraceback()

  Відобразити виняток, який щойно стався. Ми видаляємо перший елемент стеку, оскільки він знаходиться в межах реалізації об’єкта інтерпретатора. Вихід записується методом `write()`.

  Змінено в версії 3.5: Відображається повна ланцюгова трасування, а не лише основна трасування.

InteractiveInterpreter.write(data)

  Запишіть рядок у стандартний потік помилок (`sys.stderr`). Похідні класи повинні замінити це, щоб забезпечити відповідну обробку виводу за потреби.

## Інтерактивні консольні об’єкти

Клас `InteractiveConsole` є підкласом `InteractiveInterpreter`, тому пропонує всі методи об’єктів інтерпретатора, а також наступні доповнення.

InteractiveConsole.interact(banner=None, exitmsg=None)

  Повністю емулюйте інтерактивну консоль Python. Необов’язковий аргумент banner визначає банер для друку перед першою взаємодією; за замовчуванням він друкує банер, подібний до того, який друкує стандартний інтерпретатор Python, а потім ім’я класу консольного об’єкта в дужках (щоб не сплутати це зі справжнім інтерпретатором, оскільки він дуже близький!).

  Необов’язковий аргумент exitmsg визначає повідомлення про вихід, яке друкується під час виходу. Передайте порожній рядок, щоб приховати повідомлення про вихід. Якщо exitmsg не вказано або `None`, буде надруковано повідомлення за замовчуванням.

  Змінено в версії 3.4: Щоб заборонити друк будь-якого банера, передайте порожній рядок.

  Змінено в версії 3.6: Друк повідомлення про вихід під час виходу.

InteractiveConsole.push(line)

  Push a line of source text to the interpreter. The line should not have a trailing newline; it may have internal newlines. The line is appended to a buffer and the interpreter’s `runsource()` method is called with the concatenated contents of the buffer as source. If this indicates that the command was executed or invalid, the buffer is reset; otherwise, the command is incomplete, and the buffer is left as it was after the line was appended. The return value is `True` if more input is required, `False` if the line was dealt with in some way (this is the same as `runsource()`).

InteractiveConsole.resetbuffer()

  Видаліть будь-який необроблений вихідний текст із вхідного буфера.

InteractiveConsole.raw_input(prompt='')

  Напишіть підказку та прочитайте рядок. Повернений рядок не містить кінцевого символу нового рядка. Коли користувач вводить послідовність клавіш EOF, виникає `EOFError`. Базова реалізація читає з `sys.stdin`; підклас може замінити це іншою реалізацією.