Зачем нужна конструкция if __name__ == "__main__"?

При импорте Python выполняет весь код модуля сверху вниз: определения функций, классов и всё, что написано на верхнем уровне. Если там стоит запуск программы, он произойдёт при каждом import.

У каждого модуля есть переменная __name__. Python задаёт её так:

• если файл запущен напрямую (python app.py или python -m app) — "__main__";
• если файл импортирован — имя модуля, например "app".

Поэтому код запуска прячут под проверку. Тогда файл можно импортировать, например в тестах, и пользоваться его функциями, не запуская программу.

Обычный шаблон — функция main() и вызов под проверкой. Это же нужно для multiprocessing: на Windows и macOS дочерний процесс заново импортирует главный модуль, и без проверки он снова запустил бы пул процессов.

Для пакетов точкой входа служит файл __main__.py: он выполняется при python -m package.

# app.py
def main():
    print("программа запущена")

def helper(x):
    return x * 2

if __name__ == "__main__":
    main()

# test_app.py
from app import helper     # main() не вызывается
assert helper(2) == 4