toplevel_components.md

1> **Источник:** https://python-all.ru/3.14/reference/toplevel_components.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 9. Компоненты верхнего уровня89Интерпретатор Python может получать данные из нескольких источников: из скрипта, переданного ему через стандартный ввод или как аргумент программы, при интерактивном вводе, из файла исходного кода модуля и т.д. В этой главе описывается синтаксис, используемый в этих случаях.1011## 9.1. Полные программы на Python1213Хотя спецификация языка не обязана предписывать, как вызывается интерпретатор, полезно иметь понятие полной программы на Python. Полная программа на Python выполняется в минимально инициализированном окружении: все встроенные и стандартные модули доступны, но ни один из них не инициализирован, за исключением [`sys`](https://python-all.ru/3.14/library/sys.html#module-sys) (различные системные службы), [`builtins`](https://python-all.ru/3.14/library/builtins.html#module-builtins) (встроенные функции, исключения и `None`) и [`__main__`](https://python-all.ru/3.14/library/__main__.html#module-__main__). Последний используется для предоставления локального и глобального пространства имён для выполнения полной программы.1415Синтаксис полной программы на Python – это синтаксис ввода из файла, описанный в следующем разделе.1617Интерпретатор также может быть вызван в интерактивном режиме; в этом случае он не читает и не выполняет полную программу, а читает и выполняет по одному оператору (возможно, составному) за раз. Начальное окружение идентично окружению полной программы; каждый оператор выполняется в пространстве имён [`__main__`](https://python-all.ru/3.14/library/__main__.html#module-__main__).1819Полная программа может быть передана интерпретатору в трёх формах: с помощью опции командной строки [`-c`](https://python-all.ru/3.14/using/cmdline.html#cmdoption-c) *строка*, как файл, переданный в качестве первого аргумента командной строки, или как стандартный ввод. Если файл или стандартный ввод является tty-устройством, интерпретатор переходит в интерактивный режим; в противном случае он выполняет файл как полную программу.2021## 9.2. Ввод из файла2223Весь ввод, читаемый из неинтерактивных файлов, имеет одну и ту же форму:2425```2627file_input: (NEWLINE | statement)* ENDMARKER28```2930Этот синтаксис используется в следующих ситуациях:3132- при разборе полной программы на Python (из файла или из строки);33- при разборе модуля;34- при разборе строки, переданной функции [`exec()`](https://python-all.ru/3.14/library/functions.html#exec);3536## 9.3. Интерактивный ввод3738Ввод в интерактивном режиме разбирается с использованием следующей грамматики:3940```4142interactive_input: [stmt_list] NEWLINE | compound_stmt NEWLINE | ENDMARKER43```4445Обратите внимание, что в интерактивном режиме за (составным) оператором верхнего уровня должна следовать пустая строка; это необходимо, чтобы помочь синтаксическому анализатору обнаружить конец ввода.4647## 9.4. Ввод выражений4849[`eval()`](https://python-all.ru/3.14/library/functions.html#eval) используется для ввода выражений. Он игнорирует начальные пробелы. Строковый аргумент для `eval()` должен иметь следующую форму:5051```5253eval_input: expression_list NEWLINE* ENDMARKER54```55