smart-file-organizer

Lección **03-01 — Organiza archivos por extensión**

## Objetivo
Mover archivos a carpetas con vista previa.

## Conceptos
- pathlib

• shutil

• dry run

• colisiones

  Librerías

  • pathlib

• shutil

  Estructura

  01-start/      reconstrucción
  03-complete/   referencia funcional
  04-challenge/  extensión
  05-solution/   solución de comparación
  screenshots/   evidencia para portafolio
  

  Ejecutar

  python -m venv .venv
  # Windows: .venv\Scripts\activate
  # macOS/Linux: source .venv/bin/activate
  pip install -r 03-complete/requirements.txt
  python 03-complete/main.py
  

  En FastAPI:

  fastapi dev 03-complete/main.py
  

  Ingeniería inversa

  1. Ejecuta la referencia.
  2. Identifica entrada, proceso y salida.
  3. Modifica un dato.
  4. Provoca el error controlado.
  5. Repara.
  6. Reconstruye en 01-start.
  7. Completa el desafío.

  Error controlado

  Usa una carpeta de prueba y compara dry_run=True contra False.

  Cursor

  Explica este proyecto como tutor. Describe entrada, procesamiento y salida. Revisa una función por vez. No cambies código sin mi autorización.

  GitHub

  Incluye captura, problema, solución, instalación, arquitectura, aprendizaje y mejoras futuras.