Metadata-Version: 2.4
Name: colorizador
Version: 1.0.0
Summary: Biblioteca nativa e ultra-leve em português para cores no terminal. (Finalizada em favor do estilizador v2.0)
Author-email: Dias Valente 96 <diasvalente96@gmail.com>
License: MIT
Keywords: terminal,cores,termux,portugues,cli,colorizador
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# colorizador 🎨

Uma biblioteca Python ultra-simples, em **português**, feita para facilitar a estilização de menus e saídas no terminal. Criada especialmente para ajudar iniciantes, desenvolvedores de scripts rápidos e a comunidade que utiliza o **Termux** no celular!

## 🛑 Status do Projeto: Versão Final Estável (Descontinuado)

O `colorizador` chegou ao fim da sua linha de desenvolvimento ativo. O código foi completamente limpo e agora roda de forma 100% nativa (**zero dependências externas**), tornando-se extremamente veloz e ideal para scripts simples.

**Por que mudou?**
O projeto cresceu e se transformou em um motor completo de componentes visuais CLI. Para refletir essa evolução, o desenvolvimento continuará exclusivamente na nova biblioteca **`estilizador`** a partir da versão 2.0.

👉 **Conheça e acompanhe o novo projeto:** [://github.com](https://github.com/diasval96/estilizador)

---

## 🚀 Como Instalar

```bash
pip install colorizador
```

## 🎨 Cores Disponíveis

Você pode usar as cores diretamente como variáveis no seu código.

| Cor de Texto (`estilos.nome`) | Cor de Fundo (`estilos.fundo_nome`) | Exemplo Visual Equivalente |
| :--- | :--- | :--- |
| `verde` | `fundo_verde` | Verde padrão |
| `azul` | `fundo_azul` | Azul padrão |
| `azul_claro` | *Não disponível* | Azul brilhante |
| `amarelo` | `fundo_amarelo` | Amarelo padrão |
| `vermelho` | `fundo_vermelho` | Vermelho padrão |
| `preto` | `fundo_preto` | Preto padrão |
| `branco` | `fundo_branco` *(Nova!)* | Branco padrão |
| `rosa` *(Nova!)* | *Não disponível* | Rosa / Magenta brilhante |
| `dourado` *(Nova!)* | *Não disponível* | Tom dourado (256-cores) |
| `laranja` *(Nova!)* | *Não disponível* | Tom laranja (256-cores) |

> **⚠️ Nota de Segurança:** Se você utilizar variáveis brutas de cores (como `estilos.verde`), lembre-se de concatenar `estilos.reset` no final, principalmente antes de chamadas de `input()`, para evitar vazamento de cores para o prompt e teclado do usuário!

## 💻 Como Usar

### 1. Usando as variáveis de cores diretas
```python
import colorizador

print(f"{colorizador.verde}Texto em verde!{colorizador.reset}")
print(f"{colorizador.fundo_amarelo}{colorizador.preto}Texto preto com fundo amarelo!{colorizador.reset}")
```

### 2. Usando as funções facilitadoras (Mais rápido para digitar no celular!)
As funções abaixo já limpam a formatação automaticamente no final da mensagem.

```python
import colorizador

# Atalhos rápidos com ícones inclusos
colorizador.sucesso("O arquivo foi baixado com sucesso!")
colorizador.erro("Falha ao conectar ao servidor.")
colorizador.aviso("O espaço em disco está acabando.")

# Customização total em uma linha
colorizador.colorir("Texto Personalizado", cor_texto=colorizador.azul_claro, cor_fundo=colorizador.fundo_preto)
```

## 🤝 Histórico e Contribuições

Este projeto teve sua base construída em código aberto! Agradecemos a todos da comunidade que apoiaram a v1.0.0. Para novos recursos, ferramentas visuais complexas (como barras de progresso e animações), por favor, envie suas contribuições diretamente para o repositório do **`estilizador`**.
