Metadata-Version: 2.4
Name: ascii-title-generator
Version: 1.0.0
Summary: Crea títulos ascii para aplicacions de termial
Author-email: Jaime Feldman <jaimefel@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/jaimefeldman/ascii-title
Project-URL: Repository, https://github.com/jaimefeldman/ascii-title
Project-URL: Issues, https://github.com/jaimefeldman/ascii-title/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyfiglet>=1.0.2
Dynamic: license-file

# ascii-title

Librería Python para generar títulos ASCII art con gradientes de color en la terminal. Ideal para darle estilo visual a aplicaciones de línea de comandos.

## Características

- Renderiza texto como arte ASCII usando fuentes de [pyfiglet](https://github.com/pwaller/pyfiglet)
- Aplica gradientes de color 24-bit RGB mediante códigos ANSI
- 13 paletas de colores predefinidas
- Usable como librería Python o como comando de terminal

## Instalación

```bash
pip install ascii-title
```

### Modo desarrollo

```bash
git clone https://github.com/jaimefeldman/ascii-title
cd ascii-title
pip install -e .
```

## Uso como librería

```python
import ascii_title

# Imprime directamente en la terminal (paleta y fuente con valores por defecto)
ascii_title.imprimir_titulo("MI APP")

# Con paleta y fuente personalizadas
ascii_title.imprimir_titulo("MI APP", paleta="nebula", fuente="slant")

# Devuelve el string con códigos ANSI (útil para componer output)
titulo = ascii_title.renderizar_titulo("MI APP", paleta="sunset")
print(titulo)

# Obtiene un dict con todas las paletas disponibles {nombre: [hex, ...]}
paletas = ascii_title.get_paletas()
```

### Parámetros

| Parámetro | Tipo   | Valor por defecto | Descripción                          |
|-----------|--------|-------------------|--------------------------------------|
| `texto`   | `str`  | —                 | Texto a renderizar                   |
| `paleta`  | `str`  | `"sunset"`        | Nombre de la paleta de colores       |
| `fuente`  | `str`  | `"ansi_shadow"`   | Fuente de pyfiglet                   |

## Uso como CLI

```bash
# Título con texto y paleta personalizados
ascii-title -t "MI TÍTULO" -c sunset

# Especificar también la fuente
ascii-title -t "HOLA" -c nebula -f slant

# Listar todas las paletas disponibles (con vista previa de color)
ascii-title -l
```

### Opciones CLI

| Opción              | Descripción                          |
|---------------------|--------------------------------------|
| `-t`, `--text`      | Texto a convertir (default: `ASCII TITLE`) |
| `-c`, `--color`     | Paleta de colores (default: `sunset`) |
| `-f`, `--font`      | Fuente de pyfiglet (default: `ansi_shadow`) |
| `-l`, `--list`      | Muestra las paletas disponibles con vista previa |

## Paletas de colores disponibles

| Nombre       | Colores                          |
|--------------|----------------------------------|
| `grad-blue`  | Azul claro → azul índigo         |
| `sunset`     | Naranja → rojo → ámbar           |
| `dawn`       | Celeste → azul                   |
| `nebula`     | Púrpura → rosa suave             |
| `mono`       | Rosa uniforme                    |
| `ocean`      | Azul lavanda → violeta           |
| `fire`       | Rojo → salmón                    |
| `forest`     | Verde azulado → verde claro      |
| `gold`       | Naranja → amarillo dorado        |
| `purple`     | Azul grisáceo → azul eléctrico   |
| `mint`       | Cyan → azul medio                |
| `coral`      | Rosa claro → lila pálido         |
| `matrix`     | Verde brillante → verde oscuro   |

## Dependencias

- `pyfiglet >= 1.0.2` — renderizado de fuentes ASCII art

## Licencia

Este proyecto está bajo la licencia MIT.
