У 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), и новая команда не требует правок в основном коде.
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) отвечает на вопрос «что это и как этим пользоваться» без чтения кода.drop ПРЕДМЕТ и посмотри, что будет, если вызвать её для предмета, которого нет (KeyError). Как предупредить пользователя понятным сообщением в stderr?parser.parse_args(["bag"]) и parser.parse_args([]). Чем различаются сообщения об ошибках?set_defaults(func=…) и избавься от цепочки if.Утилита 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. Выполни команду
Утилита 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()).
Дальше работа с файлами и папками: копировать, переносить и обходить целые деревья.