137 lines
2.7 KiB
Markdown
137 lines
2.7 KiB
Markdown
# 🛠️ 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:
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# Limpiar y verificar
|
|
./scripts/clean.sh
|
|
python scripts/dev.py test
|
|
```
|
|
|
|
### Configuración Inicial
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# Dar permisos de ejecución
|
|
chmod +x scripts/clean.sh
|
|
chmod +x scripts/dev.py
|
|
```
|
|
|
|
### Problemas con Python
|
|
```bash
|
|
# Verificar versión de Python
|
|
python --version
|
|
|
|
# Verificar que esté en el entorno virtual
|
|
which python
|
|
```
|
|
|
|
### Problemas con Bash
|
|
```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.
|