Metadata-Version: 2.4
Name: gerador-token-tfc
Version: 0.1.0
Summary: Gerador de tokens únicos personalizados, baseado no Princípio Multiplicativo (TFC).
Author: Matias
License: MIT
Project-URL: Homepage, https://github.com/SEU_USUARIO/gerador-token-tfc
Keywords: token,gerador,combinatoria,principio-multiplicativo,tfc
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: colorama>=0.4.6
Dynamic: license-file

# gerador-token-tfc

Biblioteca Python para geração de tokens únicos personalizados, baseada no
**Princípio Multiplicativo** (Técnicas Fundamentais de Contagem).

O token tem sempre 8 dígitos, divididos entre três tipos de caractere:

- **Letras** maiúsculas de A-Z (26 possibilidades cada posição)
- **Números** de 0-9 (10 possibilidades cada posição)
- **Símbolos** entre `@ # $ % &` (5 possibilidades cada posição)

Você escolhe quantas posições de cada tipo quer usar, desde que a soma dê 8.

## Instalação

```bash
pip install gerador-token-tfc
```

## Uso como biblioteca

```python
from gerador_token_tfc import gerar_token, calcular_possibilidades

token = gerar_token(qtd_letras=4, qtd_numeros=2, qtd_simbolos=2)
print(token)  # ex: ABCD12@#

total = calcular_possibilidades(4, 2, 2)
print(total)  # 1.142.440.000 combinações possíveis
```

## Uso como programa interativo

Depois de instalado, o pacote registra um comando de terminal:

```bash
gerador-token
```

Ele vai perguntar quantas letras, números e símbolos você quer, gerar o
token com uma barrinha de progresso e mostrar quantas combinações são
possíveis com a composição escolhida.

## Desenvolvimento local

```bash
git clone https://github.com/SEU_USUARIO/gerador-token-tfc.git
cd gerador-token-tfc
pip install -e .
```

## Licença

MIT
