Script Python da riga di comando robusto, con test

1. Spiega il compito con un esempio reale di input e output.
2. Indica se puoi installare dipendenze o devi restare nella libreria standard.
3. Salva lo script e i test ed esegui pytest prima di usarlo su dati reali.
4. Provalo sempre prima con --dry-run.

Script: rinomina-fatture · Compito: rinominare i PDF delle fatture usando data e fornitore presenti in un CSV · Solo libreria standard.

2. Codice (estratto di rinomina_fatture.py)

from __future__ import annotations

import argparse
import csv
import logging
import sys
from pathlib import Path

log = logging.getLogger("rinomina-fatture")


def nuovo_nome(data: str, fornitore: str) -> str:
    """Funzione pura: '2025-03-14', 'Cartoleria Sole' -> '2025-03-14_cartoleria-sole.pdf'."""
    return f"{data}_{'-'.join(fornitore.lower().split())}.pdf"


def leggi_csv(percorso: Path) -> dict[str, str]:
    with percorso.open(newline="", encoding="utf-8") as f:
        return {riga["file"]: nuovo_nome(riga["data"], riga["fornitore"]) for riga in csv.DictReader(f)}


def main(argv: list[str] | None = None) -> int:
    p = argparse.ArgumentParser(prog="rinomina-fatture", description="Rinomina i PDF delle fatture da un CSV.")
    p.add_argument("cartella", type=Path)
    p.add_argument("csv", type=Path)
    p.add_argument("--dry-run", action="store_true", help="mostra le modifiche senza applicarle")
    livello = p.add_mutually_exclusive_group()
    livello.add_argument("-v", "--verbose", action="store_true")
    livello.add_argument("-q", "--quiet", action="store_true")
    args = p.parse_args(argv)
    logging.basicConfig(level=logging.DEBUG if args.verbose else logging.ERROR if args.quiet else logging.INFO)

    try:
        modifiche = leggi_csv(args.csv)
    except (OSError, KeyError) as e:
        log.error("Impossibile leggere il CSV: %s", e)
        return 2
    for vecchio, nuovo in modifiche.items():
        origine, destinazione = args.cartella / vecchio, args.cartella / nuovo
        if not origine.exists() or destinazione.exists():
            log.warning("Saltato: %s", vecchio)
            continue
        print(f"{vecchio} -> {nuovo}")
        if not args.dry_run:
            origine.rename(destinazione)
    return 0


if __name__ == "__main__":
    sys.exit(main())

Codici di uscita: 0 successo, 1 errore d'uso (argparse restituisce 2 di default: [DA COMPLETARE] se vuoi uniformarli), 2 errore nei dati. Il formato della data nel CSV non è descritto: [DA COMPLETARE]…