Script Python en ligne de commande robuste, avec tests

1. Expliquez la tâche avec un exemple réel d’entrée et de sortie.
2. Précisez si vous pouvez installer des dépendances ou si vous devez vous limiter à la bibliothèque standard.
3. Enregistrez le script et les tests, puis lancez pytest avant de l’utiliser sur de vraies données.
4. Essayez toujours d’abord avec --dry-run.

Script : renommer-factures · Tâche : renommer des factures PDF avec la date et le fournisseur indiqués dans un CSV · Bibliothèque standard uniquement.

2. Code (extrait de renommer_factures.py)

from __future__ import annotations

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

log = logging.getLogger("renommer-factures")


def nouveau_nom(date: str, fournisseur: str) -> str:
    """Fonction pure : '2025-03-14', 'Papeterie Soleil' -> '2025-03-14_papeterie-soleil.pdf'."""
    return f"{date}_{'-'.join(fournisseur.lower().split())}.pdf"


def lire_csv(chemin: Path) -> dict[str, str]:
    with chemin.open(newline="", encoding="utf-8") as f:
        return {ligne["fichier"]: nouveau_nom(ligne["date"], ligne["fournisseur"]) for ligne in csv.DictReader(f)}


def main(argv: list[str] | None = None) -> int:
    p = argparse.ArgumentParser(prog="renommer-factures", description="Renomme des factures PDF d'après un CSV.")
    p.add_argument("dossier", type=Path)
    p.add_argument("csv", type=Path)
    p.add_argument("--dry-run", action="store_true", help="affiche les changements sans les appliquer")
    niveau = p.add_mutually_exclusive_group()
    niveau.add_argument("-v", "--verbose", action="store_true")
    niveau.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:
        changements = lire_csv(args.csv)
    except (OSError, KeyError) as e:
        log.error("Impossible de lire le CSV : %s", e)
        return 2
    for ancien, nouveau in changements.items():
        source, cible = args.dossier / ancien, args.dossier / nouveau
        if not source.exists() or cible.exists():
            log.warning("Ignoré : %s", ancien)
            continue
        print(f"{ancien} -> {nouveau}")
        if not args.dry_run:
            source.rename(cible)
    return 0


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

Codes de sortie : 0 succès, 1 erreur d'utilisation (argparse renvoie 2 par défaut : [À COMPLÉTER] pour unifier), 2 erreur de données. Le format de date du CSV n'est pas précisé : [À COMPLÉTER]…