Глава 23 · Часть III · Создаём Python-проект

Командная строка SafeSort

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

SafeSort будет управляться пятью подкомандами: scan, plan, apply, duplicates и undo. За разбор аргументов командной строки отвечает модуль argparse из стандартной библиотеки — он же формирует текст --help.

def build_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(
        prog="safesort",
        description=(
            "SafeSort: a safe, non-destructive file organizer. "
            "scan/plan/duplicates are read-only; 'apply' sorts and 'undo' restores files."
        ),
    )
    subparsers = parser.add_subparsers(dest="command", required=True)

    scan_parser = subparsers.add_parser("scan", help="...")
    scan_parser.add_argument("root", type=Path, help="Directory to scan.")
    # ...аналогично для plan, apply, duplicates, undo
    return parser

От разобранных аргументов к результату

Каждой подкоманде соответствует одна функция-обработчик, и словарь связывает имя команды с нужной функцией:

_HANDLERS = {
    "scan": cmd_scan,
    "plan": cmd_plan,
    "apply": cmd_apply,
    "duplicates": cmd_duplicates,
    "undo": cmd_undo,
}

def main(argv: list[str] | None = None) -> int:
    parser = build_parser()
    args = parser.parse_args(argv)
    handler = _HANDLERS[args.command]
    return handler(args)

Такой словарь — тот же приём, что и в игре «Камень, ножницы, бумага» из приложения к этой главе: вместо цепочки if args.command == "scan": ... elif ... нужную функцию просто ищут по ключу.

Каждая обработчик-функция возвращает целое число: 0 при успехе, отличное от нуля значение при ошибке — это и есть код возврата программы, который видит операционная система и любой сценарий, вызывающий safesort из другого места.

Установим пакет и запустим команду — argparse уже формирует текст помощи сам, без единой написанной вручную строки: