driving-academy/scripts/README.md

🛠️ Scripts de Utilidades

Este directorio contiene scripts útiles para el desarrollo y mantenimiento del proyecto Balotario.

📁 Scripts Disponibles

🐍 dev.py

Script principal de desarrollo en Python

Comandos:

# Limpiar cache y archivos temporales
python scripts/dev.py clean

# Ejecutar todos los tests de Python
python scripts/dev.py test

# Verificar dependencias instaladas
python scripts/dev.py deps

# Iniciar servidor de desarrollo
python scripts/dev.py dev

# Mostrar ayuda
python scripts/dev.py help

Funcionalidades:

• ✅ Limpieza automática de __pycache__ y archivos .pyc
• ✅ Ejecución de tests de Python
• ✅ Verificación de dependencias
• ✅ Inicio del servidor de desarrollo
• ✅ Ayuda integrada

🧹 clean.sh

Script de limpieza rápida en Bash

Uso:

# Ejecutar limpieza completa
./scripts/clean.sh

# O con bash explícito
bash scripts/clean.sh

Funcionalidades:

• ✅ Elimina __pycache__ recursivamente
• ✅ Elimina archivos .pyc, .pyo
• ✅ Elimina archivos temporales (.tmp, .temp, *~)
• ✅ Elimina archivos del sistema (.DS_Store)
• ✅ Elimina logs (.log)
• ✅ Muestra estadísticas del proyecto

🚀 Uso Rápido

Desarrollo Diario

# 1. Limpiar proyecto
./scripts/clean.sh

# 2. Verificar que todo esté bien
python scripts/dev.py test

# 3. Iniciar desarrollo
python scripts/dev.py dev

Antes de Commit

# Limpiar y verificar
./scripts/clean.sh
python scripts/dev.py test

Configuración Inicial

# Verificar dependencias
python scripts/dev.py deps

# Si faltan dependencias
pip install -r requirements.txt

🔧 Personalización

Agregar Nuevos Comandos a dev.py

1. Crear nueva función en dev.py
2. Agregar comando en main()
3. Documentar en show_help()

Modificar clean.sh

• Agregar nuevos patrones de archivos a limpiar
• Modificar las estadísticas mostradas
• Agregar verificaciones adicionales

📊 Estadísticas

El script clean.sh muestra:

• 📁 Directorio actual
• 📄 Número de archivos Python
• 🌐 Número de archivos HTML
• 🎨 Número de archivos CSS
• ⚡ Número de archivos JavaScript
• 🧪 Número de tests

🐛 Troubleshooting

Permisos en Linux/macOS

# Dar permisos de ejecución
chmod +x scripts/clean.sh
chmod +x scripts/dev.py

Problemas con Python

# Verificar versión de Python
python --version

# Verificar que esté en el entorno virtual
which python

Problemas con Bash

# Ejecutar con bash explícito
bash scripts/clean.sh

# Verificar sintaxis
bash -n scripts/clean.sh

---

Nota: Estos scripts están diseñados para facilitar el desarrollo. Úsalos regularmente para mantener el proyecto limpio y organizado.