Un script se convierte en una herramienta cuando otra persona puede ejecutarlo con sus propios datos: python export.py orders.csv --limit 50 --dry-run. El módulo argparse de la biblioteca estándar lee esas palabras, las convierte y muestra un mensaje de uso cuando son incorrectas.
Describes las entradas una sola vez: un argumento posicional como path, opciones como --limit con un type y un default, e indicadores como --dry-run con action="store_true". Los guiones se convierten en guiones bajos, así que --dry-run se lee como args.dry_run.
parse_args() lee la línea de comandos real. Aquí le pasas una lista, parser.parse_args(argv), que es también como se prueba una herramienta. Cuando la entrada es incorrecta, argparse muestra el problema y lanza SystemExit. Una buena herramienta pone su trabajo en main(argv) y devuelve 0 si todo va bien y otro número si falla.
Out: ('orders.csv', 50, False). El texto "50" se convirtió en número, y el indicador que no se pasó vale False.