Исполнение Python кода: от терминала до автоматизации

Расширенные примеры запуска Python файлов

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

Пример 1: Обработка аргументов с argparse

Модуль argparse предоставляет удобный интерфейс для разбора параметров командной строки с автоматической генерацией справки.

#!/usr/bin/env python3
# file: greet.py
import argparse

parser = argparse.ArgumentParser(description='Приветствие пользователя')
parser.add_argument('--name', required=True, help='Имя')
parser.add_argument('--count', type=int, default=1, help='Количество повторений')
args = parser.parse_args()

for _ in range(args.count):
    print(f'Привет, {args.name}!')

$ python3 greet.py --name=Мир --count=3
Привет, Мир!
Привет, Мир!
Привет, Мир!

$ python3 greet.py --help
usage: greet.py [-h] --name NAME [--count COUNT]

Приветствие пользователя

Объяснение: argparse автоматически преобразует типы (int), проверяет обязательность аргументов (required=True) и выводит справку при ошибке. Это избавляет от ручного разбора sys.argv.

Пример 2: Запуск скрипта в фоновом режиме с перенаправлением вывода

Использование subprocess.Popen для асинхронного запуска и захвата логов в реальном времени.

import subprocess
import time

process = subprocess.Popen(
    ['python3', 'long_task.py'],
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    text=True
)

# Чтение вывода по мере появления
while True:
    output = process.stdout.readline()
    if output == '' and process.poll() is not None:
        break
    if output:
        print(f'[stdout] {output.strip()}')

return_code = process.poll()
print(f'Процесс завершён с кодом {return_code}')

Результат: строчки вывода long_task.py отображаются без ожидания завершения всего скрипта. Ошибки записываются в stderr и могут быть отдельно обработаны.

Пример 3: Запуск файла как модуля с помощью runpy

Функция run_path из модуля runpy позволяет выполнить файл, не импортируя его, и получить результат в виде словаря глобальных переменных.

from runpy import run_path

# Файл demo.py содержит: result = 42
globals_after = run_path('demo.py', init_globals={'x': 10})
print(globals_after['result'])   # 42
print(globals_after['x'])        # 10 (инициализированное значение)

Объяснение: run_path удобен для запуска конфигурационных скриптов или плагинов, так как изолирует глобальные переменные от основного пространства имён.

Пример 4: Запуск с профилированием (cProfile)

Для анализа производительности скрипта используется встроенный профилировщик:

python3 -m cProfile -s time myscript.py

Это выводит таблицу вызовов функций, отсортированную по затраченному времени. Для сохранения результатов в файл:

python3 -m cProfile -o output.prof myscript.py

Впоследствии файл анализируется через pstats или графические утилиты (snakeviz).

Пример 5: Запуск нескольких скриптов параллельно с concurrent.futures

import subprocess
from concurrent.futures import ThreadPoolExecutor

def run_script(name):
    result = subprocess.run(['python3', name], capture_output=True, text=True)
    return name, result.returncode, result.stdout

scripts = ['task1.py', 'task2.py', 'task3.py']
with ThreadPoolExecutor(max_workers=3) as executor:
    futures = {executor.submit(run_script, s): s for s in scripts}
    for future in concurrent.futures.as_completed(futures):
        name, code, out = future.result()
        print(f'{name}: returncode={code}, output={out[:50]}')

Этот подход полезен для автоматизации запуска независимых задач, например, обработки файлов или тестов.

Пример 6: Использование консольных точек входа (entry points)

При создании пакета Python можно определить исполняемую команду в setup.py или pyproject.toml:

# setup.py
from setuptools import setup

setup(
    name='myapp',
    version='1.0',
    py_modules=['myapp'],
    entry_points={
        'console_scripts': [
            'myapp = myapp:main'
        ]
    }
)

После установки пакета (pip install .) команда myapp становится доступна в терминале и запускает функцию main() из модуля myapp.py.

Результат: упрощение запуска для конечных пользователей, не требуется указывать путь или вызывать интерпретатор явно.