py-help-commands 0.1.0
Paquete con comandos útiles para automatizar tareas en entornos de desarrollo Python.
Requires Python: >=3.9

# Python Help Commands - Herramientas para desarrollo Python

## Versión actual
La versión actual de la librería es `0.1.0`.

[![Python Versions](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Una herramienta de línea de comandos para automatizar tareas comunes en entornos de desarrollo Python.

## Características

- 🔄 **Actualizar dependencias**: Actualiza automáticamente todos los paquetes desactualizados de tu entorno
- 🗑️ **Limpiar caché**: Elimina archivos y carpetas de caché de Python (`__pycache__`, `.pyc`, `.pyo`)
- 🎨 **Interfaz colorida**: Feedback visual claro con colores y spinners
- 🔧 **Modo verboso**: Opción para mostrar información detallada
- ✅ **Confirmaciones**: Pregunta antes de realizar cambios importantes
- ⚡ **Múltiples formas de uso**: Usa `commands` como prefijo o ejecuta comandos directamente

## Instalación

### Desde PyPI (recomendado)

```bash
pip install commands
```

### Desde el repositorio

**Opción 1: Clonar el repositorio**
```bash
git clone https://github.com/SurivZ/commands.git
cd commands
pip install -e .
```

**Opción 2: Descargar ZIP**
1. Ve a [https://github.com/SurivZ/commands](https://github.com/SurivZ/commands)
2. Descarga el código como ZIP
3. Descomprime y ejecuta:
```bash
cd commands
pip install -e .
```

## Uso

### Formas de ejecución

Puedes usar los comandos de dos formas:

**1. Con prefijo `commands` (recomendado para claridad):**
```bash
commands update
commands clear-cache
```

**2. Directamente (más rápido y conveniente):**
```bash
update
clear-cache
```

Ambas formas son completamente equivalentes y ofrecen las mismas funcionalidades.

### Comando principal
```bash
commands
```
Muestra todos los comandos disponibles.

### Actualizar dependencias
```bash
# Ambas formas son válidas:
commands update
update
```
Actualiza todos los paquetes desactualizados del entorno.

**Opciones:**
- `-y, --yes`: Confirmar automáticamente
- `-V, --verbose`: Mostrar información detallada

**Ejemplos:**
```bash
update
update --yes
update --verbose
commands update --verbose --yes
```

### Limpiar caché
```bash
# Ambas formas son válidas:
commands clear-cache
clear-cache
```
Elimina archivos y carpetas de caché de Python del proyecto actual.

**Opciones:**
- `-V, --verbose`: Mostrar información detallada

**Ejemplo:**
```bash
clear-cache --verbose
commands clear-cache
```

### Opciones globales

- `-v, --version`: Mostrar versión
- `-h, --help`: Mostrar ayuda

**Ejemplos:**
```bash
commands --version
update --help
```

## Comandos disponibles

| Comando | Descripción | Formas de uso |
|---------|-------------|---------------|
| `update` | Actualizar todas las dependencias del entorno | `commands update` o `update` |
| `clear-cache` | Eliminar archivos y carpetas de caché de Python | `commands clear-cache` o `clear-cache` |

## Desarrollo

### Estructura del proyecto
```
commands/
├── commands/
│   ├── __init__.py
│   ├── __main__.py
│   ├── cli_args.py
│   ├── console_colors.py
│   ├── console_spinner.py
│   ├── update_all_dependencies.py
│   └── clear_python_cache.py
├── setup.py
├── pyproject.toml
├── README.md
├── CHANGELOG.md
├── LICENSE.md
├── .gitignore
└── requirements.txt
```

### Configurar entorno de desarrollo

1. Clona el repositorio:
```bash
git clone https://github.com/SurivZ/commands.git
cd commands
```

2. Instala en modo desarrollo:
```bash
pip install -e .
```

### Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Haz un fork del proyecto
2. Crea una rama para tu feature (`git checkout -b feature/AmazingFeature`)
3. Commit tus cambios (`git commit -m 'Add some AmazingFeature'`)
4. Push a la rama (`git push origin feature/AmazingFeature`)
5. Abre un Pull Request

## Licencia

Distribuido bajo la Licencia MIT. Ver `LICENSE` para más información.

## Autor

**David Serrano** - [SurivZ](https://github.com/SurivZ)

- Email: franklinserrano23@email.com
- GitHub: [@SurivZ](https://github.com/SurivZ)