Script CLI robusto en Python con tests

1. Explica la tarea con un ejemplo real de entrada y salida.
2. Indica si puedes instalar dependencias o solo usar la biblioteca estándar.
3. Guarda el script y los tests, y ejecuta pytest antes de usarlo con datos reales.
4. Prueba siempre primero con --dry-run.

Script: renombrar-facturas · Tarea: renombrar PDF de facturas con fecha y proveedor leídos de un CSV · Solo biblioteca estándar.

2. Código (extracto de renombrar_facturas.py)

from __future__ import annotations

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

log = logging.getLogger("renombrar-facturas")


def nuevo_nombre(fecha: str, proveedor: str) -> str:
    """Función pura: '2025-03-14', 'Papelería Sol' -> '2025-03-14_papelería-sol.pdf'."""
    return f"{fecha}_{'-'.join(proveedor.lower().split())}.pdf"


def leer_csv(ruta: Path) -> dict[str, str]:
    with ruta.open(newline="", encoding="utf-8") as f:
        return {fila["archivo"]: nuevo_nombre(fila["fecha"], fila["proveedor"]) for fila in csv.DictReader(f)}


def main(argv: list[str] | None = None) -> int:
    p = argparse.ArgumentParser(prog="renombrar-facturas", description="Renombra facturas PDF según un CSV.")
    p.add_argument("carpeta", type=Path)
    p.add_argument("csv", type=Path)
    p.add_argument("--dry-run", action="store_true", help="muestra los cambios sin aplicarlos")
    nivel = p.add_mutually_exclusive_group()
    nivel.add_argument("-v", "--verbose", action="store_true")
    nivel.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:
        cambios = leer_csv(args.csv)
    except (OSError, KeyError) as e:
        log.error("No se puede leer el CSV: %s", e)
        return 2
    for viejo, nuevo in cambios.items():
        origen, destino = args.carpeta / viejo, args.carpeta / nuevo
        if not origen.exists() or destino.exists():
            log.warning("Omitido: %s", viejo)
            continue
        print(f"{viejo} -> {nuevo}")
        if not args.dry_run:
            origen.rename(destino)
    return 0


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

Códigos de salida: 0 éxito, 1 error de uso (lo gestiona argparse con 2 por defecto: [COMPLETAR] si quieres unificarlo), 2 error de datos. El formato de fecha del CSV no está descrito: [COMPLETAR]…