✧ Запускаем другие программы ✧

🚀 Запускаем

Python может не только считать сам, но и вызвать другую программу и забрать её ответ. Так скрипты управляют git, конвертируют видео через ffmpeg, ставят пакеты через pip. Запусти: наша программа запускает другой экземпляр Python и читает, что он напечатал.

import subprocess
import sys

result = subprocess.run(
    [sys.executable, "-c", "print(2 + 2)"],
    capture_output=True,
    text=True,
)

print("код выхода:", result.returncode)
print("вывод:", repr(result.stdout))
print("ошибки:", repr(result.stderr))
код выхода: 0
вывод: '4\n'
ошибки: ''

sys.executable — это путь к тому самому Python, который запустил нас; -c говорит ему выполнить строку как программу. Замени print(2 + 2) на 1 / 0 и посмотри, что изменится: код выхода станет ненулевым, а текст ошибки окажется в result.stderr.

📜 Теория: subprocess

Команда — это список

import subprocess

subprocess.run(["ls", "-l", "my folder"])        # каждый кусок — отдельный элемент списка
subprocess.run("ls -l my folder")                # так нельзя: Python будет искать программу с таким именем

Команду записывают списком: первым идёт имя программы, дальше её аргументы. Каждый аргумент остаётся целым, даже если в нём пробелы, и ничего не нужно экранировать. Есть и другой способ — shell=True, когда строку разбирает оболочка. Мы им не пользуемся: если в строку попадёт чужой текст (имя файла, ввод пользователя), в ней может оказаться лишняя команда, и программа выполнит её. Такая уязвимость называется инъекцией команд.

В песочнице курса доступны только базовые программы (ls, echo и подобные) и сам Python, без сети. На своём компьютере будет всё, что у тебя установлено.

Что вернёт run

import subprocess

result = subprocess.run(["ls", "/work"], capture_output=True, text=True)
print(result.returncode)     # 0 — успех, остальное — ошибка
print(result.stdout)         # то, что программа напечатала
print(result.stderr)         # то, что она написала в поток ошибок

capture_output=True собирает вывод, а не печатает его на экран; text=True возвращает строки вместо байтов. Без capture_output программа печатает прямо в твой терминал, и stdout окажется None. Код выхода returncode — то самое число, о котором мы говорили в уроке про команды: 0 — успех.

Передать ввод и поймать сбой

import subprocess
import sys

child = "n = int(input()); print(n * 2)"

ok = subprocess.run([sys.executable, "-c", child], input="21\n", capture_output=True, text=True)
print(ok.stdout)                 # → 42

try:
    subprocess.run([sys.executable, "-c", child], input="много\n",
                   capture_output=True, text=True, check=True)
except subprocess.CalledProcessError as error:
    print("упала с кодом", error.returncode)     # → упала с кодом 1
    print(error.stderr.splitlines()[-1])         # → ValueError: invalid literal for int() with base 10: 'много'

input="…" подаёт программе текст на вход (так же, как input() получает строки от пользователя). С check=True ненулевой код выхода превращается в исключение CalledProcessError: удобно, когда без успеха этого шага продолжать нельзя. Последняя строка stderr — обычно самая полезная (мы читали трассировки снизу вверх).

Не ждать вечно

import subprocess
import sys

try:
    subprocess.run([sys.executable, "-c", "import time; time.sleep(5)"], timeout=1)
except subprocess.TimeoutExpired:
    print("не дождались, программу остановили")

Параметр timeout (в секундах) страхует от зависших программ: если время вышло, run останавливает процесс и бросает TimeoutExpired. Для программ, которые писал не ты, таймаут лучше ставить всегда.

Запустить свой скрипт

import subprocess
import sys
from pathlib import Path

Path("double.py").write_text(
    "import sys\n"
    "print(int(sys.argv[1]) * 2)\n"
)

result = subprocess.run([sys.executable, "double.py", "21"], capture_output=True, text=True)
print(result.stdout.strip())      # → 42

Скрипт, который ты написал в одном файле, легко вызвать из другого: имя файла и его аргументы (они попадут в sys.argv, как в уроке про argparse). На этом строятся системы сборки, тесты и автоматизация: одна программа запускает десяток других и собирает отчёт. Каждый такой запуск — отдельный процесс со своей памятью: общих переменных у них нет, обмениваются только текстом и кодом выхода.

🧪 Попробуй сам

★★★

🎯 Задача: Запуск дочерней программы

10 очков

В папке лежит программа child.py: она читает одно целое число и печатает его квадрат. Для отрицательного числа она пишет сообщение в stderr и завершается с кодом 3, а если ввести не число, упадёт с кодом 1.

Твоя задача — в файле runner.py написать функцию run_child(value). Она запускает child.py отдельным процессом тем же интерпретатором, что и сама программа, подаёт на ввод строку value (с переводом строки в конце) и возвращает пару (код выхода, вывод без пробелов и переводов строки по краям).

Файлы main.py и child.py менять не нужно: main.py читает значения из ввода, вызывает твою функцию и печатает результат.

Пример. Ввод:

3
4
-2
abc

Вывод:

4 -> 16
-2 -> ошибка (код 3)
abc -> ошибка (код 1)

Заготовка (кнопка у блока отправит её в песочницу):

from runner import run_child

for _ in range(int(input())):
    value = input()
    code, output = run_child(value)
    if code == 0:
        print(f"{value} -> {output}")
    else:
        print(f"{value} -> ошибка (код {code})")
★★★

🎯 Задача: Сборка с таймаутом

25 очков

Скрипт sleeper.py притворяется долгой задачей: он спит столько секунд, сколько ему передали первым аргументом командной строки, и печатает ok. Для отрицательного числа он упадёт с ошибкой.

В файле runner.py напиши функцию run_job(seconds) (seconds — строка вроде 0.1). Она запускает sleeper.py отдельным процессом (тем же интерпретатором, значение передаёт аргументом) и ждёт не больше 0,5 секунды. Верни строку:

  • готово — задача закончилась вовремя и успешно;
  • превысила лимит — не уложилась в 0,5 секунды;
  • сбой — закончилась вовремя, но с ненулевым кодом выхода.

Файлы main.py и sleeper.py менять не нужно: main.py читает задачи из ввода (название секунды) и печатает результат каждой.

Пример. Ввод:

3
сборка 0.1
линковка 3
тесты -1

Вывод:

сборка: готово
линковка: превысила лимит
тесты: сбой

Заготовка (кнопка у блока отправит её в песочницу):

from runner import run_job

for _ in range(int(input())):
    name, seconds = input().split()
    print(f"{name}: {run_job(seconds)}")

✅ Что мы узнали

subprocess.run запускает другую программу: команда — список строк, capture_output=True, text=True собирают вывод, input= подаёт ввод, returncode сообщает об успехе. check=True превращает сбой в исключение, timeout= не даёт ждать вечно, а shell=True с чужим текстом не используют. Собственный Python вызывают через sys.executable.

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

⟵ Наводим порядок в папках Ищем по шаблону ⟶