> **Источник:** https://python-all.ru/3.8/reference/toplevel_components.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# 9. Компоненты верхнего уровня

Интерпретатор Python может получать данные из нескольких источников: из скрипта, переданного ему через стандартный ввод или как аргумент программы, при интерактивном вводе, из файла исходного кода модуля и т.д. В этой главе описывается синтаксис, используемый в этих случаях.

## 9.1. Полные программы на Python

Хотя спецификация языка не должна предписывать, как вызывается интерпретатор языка, полезно иметь понятие полной программы Python. Полная программа Python выполняется в минимально инициализированном окружении: все встроенные и стандартные модули доступны, но ни один не инициализирован, за исключением [`sys`](https://python-all.ru/3.8/library/sys.html#module-sys) (различные системные службы), [`builtins`](https://python-all.ru/3.8/library/builtins.html#module-builtins) (встроенные функции, исключения и `None`) и [`__main__`](https://python-all.ru/3.8/library/__main__.html#module-__main__). Последний используется для предоставления локального и глобального пространства имён для выполнения полной программы.

Синтаксис полной программы на Python – это синтаксис ввода из файла, описанный в следующем разделе.

Интерпретатор также может быть вызван в интерактивном режиме; в этом случае он не читает и не выполняет полную программу, а читает и выполняет по одному оператору (возможно, составному) за раз. Начальное окружение идентично окружению полной программы; каждый оператор выполняется в пространстве имён [`__main__`](https://python-all.ru/3.8/library/__main__.html#module-__main__).

Полная программа может быть передана интерпретатору в трёх формах: с помощью опции командной строки [`-c`](https://python-all.ru/3.8/using/cmdline.html#cmdoption-c) *строка*, как файл, переданный в качестве первого аргумента командной строки, или как стандартный ввод. Если файл или стандартный ввод является tty-устройством, интерпретатор переходит в интерактивный режим; в противном случае он выполняет файл как полную программу.

## 9.2. Ввод из файла

Весь ввод, читаемый из неинтерактивных файлов, имеет одну и ту же форму:

```

file_input ::=  (NEWLINE | statement)*
```

Этот синтаксис используется в следующих ситуациях:

- при разборе полной программы на Python (из файла или из строки);
- при разборе модуля;
- при разборе строки, переданной функции [`exec()`](https://python-all.ru/3.8/library/functions.html#exec);

## 9.3. Интерактивный ввод

Ввод в интерактивном режиме разбирается с использованием следующей грамматики:

```

interactive_input ::=  [stmt_list] NEWLINE | compound_stmt NEWLINE
```

Обратите внимание, что в интерактивном режиме за (составным) оператором верхнего уровня должна следовать пустая строка; это необходимо, чтобы помочь синтаксическому анализатору обнаружить конец ввода.

## 9.4. Ввод выражений

[`eval()`](https://python-all.ru/3.8/library/functions.html#eval) используется для ввода выражений. Он игнорирует начальные пробелы. Строковый аргумент для [`eval()`](https://python-all.ru/3.8/library/functions.html#eval) должен иметь следующую форму:

```

eval_input ::=  expression_list NEWLINE*
```