Robustes Python-CLI-Skript mit Tests

1. Erklären Sie die Aufgabe mit einem echten Beispiel für Ein- und Ausgabe.
2. Sagen Sie, ob Sie Abhängigkeiten installieren dürfen oder bei der Standardbibliothek bleiben müssen.
3. Speichern Sie Skript und Tests und führen Sie pytest aus, bevor Sie echte Daten verarbeiten.
4. Probieren Sie es immer zuerst mit --dry-run aus.

Skript: rechnungen-umbenennen · Aufgabe: Rechnungs-PDFs anhand von Datum und Lieferant aus einer CSV umbenennen · Nur Standardbibliothek.

2. Code (Auszug aus rechnungen_umbenennen.py)

from __future__ import annotations

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

log = logging.getLogger("rechnungen-umbenennen")


def neuer_name(datum: str, lieferant: str) -> str:
    """Reine Funktion: '2025-03-14', 'Papier Sonne' -> '2025-03-14_papier-sonne.pdf'."""
    return f"{datum}_{'-'.join(lieferant.lower().split())}.pdf"


def csv_lesen(pfad: Path) -> dict[str, str]:
    with pfad.open(newline="", encoding="utf-8") as f:
        return {zeile["Datei"]: neuer_name(zeile["Datum"], zeile["Lieferant"]) for zeile in csv.DictReader(f)}


def main(argv: list[str] | None = None) -> int:
    p = argparse.ArgumentParser(prog="rechnungen-umbenennen", description="Benennt Rechnungs-PDFs anhand einer CSV um.")
    p.add_argument("ordner", type=Path)
    p.add_argument("csv", type=Path)
    p.add_argument("--dry-run", action="store_true", help="Änderungen nur anzeigen")
    stufe = p.add_mutually_exclusive_group()
    stufe.add_argument("-v", "--verbose", action="store_true")
    stufe.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:
        aenderungen = csv_lesen(args.csv)
    except (OSError, KeyError) as e:
        log.error("CSV kann nicht gelesen werden: %s", e)
        return 2
    for alt, neu in aenderungen.items():
        quelle, ziel = args.ordner / alt, args.ordner / neu
        if not quelle.exists() or ziel.exists():
            log.warning("Übersprungen: %s", alt)
            continue
        print(f"{alt} -> {neu}")
        if not args.dry_run:
            quelle.rename(ziel)
    return 0


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

Exit-Codes: 0 Erfolg, 1 Bedienfehler (argparse liefert standardmäßig 2: [AUSFÜLLEN], falls vereinheitlicht werden soll), 2 Datenfehler. Das Datumsformat in der CSV ist nicht beschrieben: [AUSFÜLLEN] …