✧ Делаем программу с командами ✧

🚀 Запускаем

У git есть git add, git commit, git log: одно имя программы, много команд, у каждой свои аргументы. Так же можно устроить и свою. Запусти сумку героя с двумя командами; строки в списке — это то, что пользователь набирал бы в терминале по одной:

import argparse

parser = argparse.ArgumentParser(prog="bag")
commands = parser.add_subparsers(dest="command", required=True)

add = commands.add_parser("add", help="положить предмет")
add.add_argument("item")
add.add_argument("count", type=int, nargs="?", default=1)

commands.add_parser("show", help="показать сумку")

bag = {}
for line in ["add Мора 500", "add Руда", "add Руда 2", "show"]:
    args = parser.parse_args(line.split())
    if args.command == "add":
        bag[args.item] = bag.get(args.item, 0) + args.count
    else:
        for item, count in bag.items():
            print(item, count)
Мора 500
Руда 3

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

📜 Теория: команды, ввод и вывод, коды выхода

Подкоманды

import argparse

parser = argparse.ArgumentParser(prog="bag")
commands = parser.add_subparsers(dest="command", required=True)
add = commands.add_parser("add", help="положить предмет")
add.add_argument("item")

print(parser.parse_args(["add", "Мора"]))     # → Namespace(command='add', item='Мора')

add_subparsers создаёт «место для команд», а каждый add_parser — отдельный мини-разборщик со своими аргументами. В dest="command" попадёт название выбранной команды. required=True нужно, чтобы запуск без команды считался ошибкой, а не молча проходил. Справка у каждой команды своя: bag add -h покажет только аргументы add.

Функция на каждую команду

import argparse


def cmd_add(args):
    print("кладём", args.item, args.count)


def cmd_show(args):
    print("показываем сумку")


parser = argparse.ArgumentParser(prog="bag")
commands = parser.add_subparsers(dest="command", required=True)

add = commands.add_parser("add")
add.add_argument("item")
add.add_argument("count", type=int, nargs="?", default=1)
add.set_defaults(func=cmd_add)

show = commands.add_parser("show")
show.set_defaults(func=cmd_show)

args = parser.parse_args(["add", "Руда", "3"])
args.func(args)                                     # → кладём Руда 3

Цепочка if command == "add": … elif … растёт вместе с программой. Удобнее привязать к каждой команде свою функцию через set_defaults(func=…): после разбора остаётся вызвать args.func(args), и новая команда не требует правок в основном коде.

Ввод и вывод: stdout, stderr, stdin

import sys

print("Результат работы")                       # stdout: то, что другие программы могут подхватить
print("Файл не найден", file=sys.stderr)       # stderr: сообщения для человека, ошибки

text = sys.stdin.read()                         # всё, что передали на вход, целиком
for line in text.splitlines():
    print(line.upper())

У программы три «потока»: вход (stdin), выход (stdout) и поток ошибок (stderr). Результат принято печатать в stdout, а предупреждения и ошибки в stderr: тогда результат можно записать в файл или передать дальше (python tool.py > out.txt, python tool.py | sort), и ошибки в него не попадут. Читать вход можно через input() по одной строке, через sys.stdin.read() целиком или циклом for line in sys.stdin.

Код выхода

import argparse
import sys


def main(argv=None):
    parser = argparse.ArgumentParser()
    parser.add_argument("need", type=int)
    args = parser.parse_args(argv)
    if args.need < 0:
        print("Смолы не может быть меньше нуля", file=sys.stderr)
        return 1
    print("ok")
    return 0


print(main(["160"]))        # → ok и потом 0
print(main(["-5"]))         # сообщение уйдёт в stderr, а напечатается 1

Когда программа заканчивается, она сообщает оболочке число: 0 — всё хорошо, любое другое — что-то пошло не так (у argparse это 2). Другие программы и скрипты проверяют его: например, python check.py && python deploy.py запустит вторую, только если первая закончилась кодом 0. Поэтому принято делать функцию main, которая возвращает код, а в конце файла вызывать её так:

import sys

if __name__ == "__main__":
    sys.exit(main())     # main — функция из примера выше

Проверка __name__ знакома по модулям: файл можно и запустить, и импортировать. Параметр argv=None нужен, чтобы тесты могли вызвать main(["160", "--have", "40"]) без терминала.

Как устроена хорошая утилита

  • Результат печатает в stdout, ошибки в stderr, сообщает код выхода.
  • Всё, что можно настроить, принимает аргументами, а не спрашивает через input(): так её удобно вызывать из скриптов.
  • Логика (вычисления) живёт в обычных функциях, а разбор аргументов — в main. Тогда логику можно проверять тестами, как в уроке про тесты.
  • Справка (-h) отвечает на вопрос «что это и как этим пользоваться» без чтения кода.

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

★★★

🎯 Задача: Сумка с командами

10 очков

Утилита bag управляет сумкой. Команды вводят по одной строке; первая строка ввода — число команд N, затем N строк.

  • add ПРЕДМЕТ [КОЛИЧЕСТВО] — положить предмет (количество по умолчанию 1);
  • use ПРЕДМЕТ [КОЛИЧЕСТВО] — потратить предмет (по умолчанию 1). Если предмета не хватает, выведи Не хватает: ПРЕДМЕТ и ничего не меняй;
  • show — напечатать сумку: по строке ПРЕДМЕТ: КОЛИЧЕСТВО для каждого предмета, в алфавитном порядке. Предметы, которых не осталось, не показываются. Если сумка пуста, выведи Сумка пуста.

Если строка не похожа на команду (неизвестная команда, не хватает аргумента, количество не число), выведи Неверная команда и иди дальше.

Разбор команд сделай через argparse с подкомандами. Названия предметов — одно слово.

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

6
add Мора 500
add Руда
add Руда 2
use Мора 200
show
use Алмаз

Вывод:

Мора: 300
Руда: 3
Не хватает: Алмаз

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

import argparse

# 1. Создай разборщик с подкомандами add, use и show

bag = {}
n = int(input())
for _ in range(n):
    line = input()
    # 2. Разбери команду; если argparse завершил программу (SystemExit), выведи «Неверная команда»
    # 3. Выполни команду
★★★

🎯 Задача: Топ из потока

25 очков

Утилита top читает таблицу очков. Первая строка ввода — аргументы утилиты, остальные строки — записи (в программе они приходят через sys.stdin, как у настоящих утилит в конвейере).

Аргументы (через argparse): --min (целое, по умолчанию 0) — не показывать записи с меньшим числом; --top (целое, по умолчанию 3) — сколько лучших показать.

Каждая запись — строка вида ИМЯ ЧИСЛО: два слова, второе состоит из цифр. Остальные строки (пустые, с лишними словами, с нецифровым числом) — мусор: про каждую напиши Пропускаю строку: <строка> в поток ошибок (stderr), а не в обычный вывод, и иди дальше.

В обычный вывод напечатай лучших: по строке <место>. <имя> — <число>; сортировка по числу от большего к меньшему, при равенстве по имени. Если ни одна запись не подошла, выведи Ничего не найдено.

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

--min 50 --top 2
Эмбер 80
Лиза 90
Кли 70
Барбара 40

Вывод:

1. Лиза — 90
2. Эмбер — 80

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

import argparse
import sys

# 1. Первая строка ввода — аргументы утилиты (--min, --top): разбери их через argparse

# 2. Остальные строки читай из sys.stdin. Неверные строки пропускай, сообщая о них в поток ошибок

# 3. Отбери записи, отсортируй и выведи лучших

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

Команды вида программа команда аргументы делаются через add_subparsers; к каждой удобно привязать свою функцию через set_defaults(func=…). Результаты уходят в stdout, ошибки в stderr, а вход можно читать из stdin. Хорошая утилита возвращает код выхода (0 — успех) из функции main(argv=None), которую вызывают как sys.exit(main()).

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

⟵ Принимаем аргументы командной строки Наводим порядок в папках ⟶