Информатика · объяснение и практика

__name__ и главный запуск: почему импорт не должен начинать диалог

Различаем выполнение файла главным сценарием и обычный импорт, ограничиваем демонстрационный код условием __name__ и прослеживаем однократную инициализацию модуля.

Синие фигурные скобки держат между собой оранжевый квадрат.

В теме Переменные, ветвления, циклы и функции · Учебная карта

Главная мысль

При обычном прямом запуске файла его __name__ равно "__main__". При импорте под именем module_name значение соответствует имени модуля. Поэтому условие if __name__ == "__main__" позволяет запускать демонстрацию только в главном сценарии. Определения функций снаружи остаются доступными для импорта, а случайный ввод или вывод из демонстрации не запускается автоматически.

Импорт исполняет верхний уровень

Пусть файл shapes.py определяет функцию area(width, height), а затем без условия вызывает input с просьбой ввести стороны. При первом import shapes интерпретатор выполнит не только определение функции, но и этот ввод. Программа, которая просто хотела воспользоваться готовым расчётом, неожиданно остановится в ожидании пользователя.

Решение состоит в явном разделении: определение area находится на верхнем уровне, а чтение учебных данных и демонстрационный print помещены под условие главного запуска. При импорте условие ложно, но определение area уже выполнено. Поэтому другой модуль сможет вызвать shapes.area(3, 7). Условие не прячет весь файл от импорта, а выбирает только помеченную ветвь.

Один и тот же текст получает разный контекст имени

При прямом выполнении python shapes.py значение __name__ устанавливается как "__main__". При import shapes оно будет "shapes" для обычного отдельного модуля; у вложенного модуля пакета имя может включать путь пакета через точки. Не нужно заменять проверку на сравнение с произвольным названием файла: специальное значение обозначает роль запуска, а не имя документа.

Если поместить под главное условие само определение area, при обычном импорте этой функции не появится. Значит, положение отступов является частью договора. Для проверки сначала отметьте, какие команды исполняются до if, затем вычислите его условие для данного режима. Определение функции создаёт вызываемый объект, а команды её тела выполнятся только при последующем вызове.

Пример

На верхнем уровне a.py печатает A, определяет f, а под главным условием печатает M. В новом сеансе дважды выполняют import a. Что появится?

При первом импорте появится A. Значение __name__ равно имени a, поэтому M не печатается. Обычный второй импорт использует уже инициализированный модуль и не печатает A заново. В другом сценарии прямого запуска a.py появились бы A и M. Сравниваются разные режимы, а не разные версии исходного текста.

Повторный импорт не является повторным запуском файла

Обычно первый успешный импорт инициализирует модуль и сохраняет его в текущем интерпретаторе. Следующий import того же модуля использует сохранённый объект, не повторяя автоматически каждую верхнеуровневую команду. Поэтому демонстрация инициализации не обязана печататься при каждом импорте. Это отличается от двух отдельных запусков программы, каждый из которых создаёт свой процесс.

Специальная перезагрузка и запуск одного файла под разными именами требуют отдельного рассмотрения. В начальной модели достаточно одного обычного имени модуля и одного сеанса. Проверяйте два случая: прямой запуск действительно выполняет демонстрацию, а импорт предоставляет определения без запроса учебного ввода. Такое условие полезно и для тестирования вычислительной функции: проверка может импортировать её, не проходя весь диалог сценария.

От чтения к действию

А теперь — вы

В модуле helper функция calc определена снаружи if __name__ == "__main__", а input внутри него. Что произойдёт при обычном import helper?

Частые вопросы

Главное условие запрещает импорт функций?

Нет, если их определения находятся снаружи условного блока и выполняются при загрузке.

Два обычных import в одном сеансе всегда дважды исполняют файл?

Нет. Обычно после первого успешного импорта используется сохранённый объект модуля.

Источники и работа с материалом

Объяснение, примеры и вопросы написаны для erudeet. Факты и определения сверены по источникам ниже; это ссылки для самостоятельной проверки.

Продолжить разбираться