Metadata-Version: 2.4
Name: ao_currency
Version: 0.1.0
Summary: Biblioteca profissional para manipulação de Moeda Angolana (Kwanza)
Author-email: Cornelio Teixeira <cornelio.teixeira@example.com>
License: MIT
Project-URL: Homepage, https://github.com/cornelioteixeira/ao_currency
Project-URL: Documentation, https://cornelioteixeira.github.io/ao_currency/
Project-URL: Repository, https://github.com/cornelioteixeira/ao_currency.git
Project-URL: Issues, https://github.com/cornelioteixeira/ao_currency/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Office/Business :: Financial :: Accounting
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.0.0
Requires-Dist: num2words>=0.5.12
Dynamic: license-file

<p align="center">
  <img src="assets/logo.png" alt="AO Currency Logo" width="200" />
</p>

# ao_currency

Biblioteca profissional para manipulação de Moeda Angolana (Kwanza).

## CLI Interface

A biblioteca inclui uma ferramenta de linha de comando:

```bash
# Formatação rápida
python3 -m ao_currency.cli "1500,50" --formatar

# Conversão para extenso
python3 -m ao_currency.cli "2500000" --extenso

# Conversão inversa (Extenso para Número)
python3 -m ao_currency.cli "Dois milhões de kwanzas" --numero
```

## Instalação
```bash
pip install ao_currency
```

### Instalação Local (Desenvolvimento)
Se você deseja contribuir ou testar localmente:

```bash
git clone https://github.com/cornelioteixeira/ao_currency.git
cd ao_currency
pip install -e .
```

## Como usar

```python
from ao_currency import AngolaMoeda

# Criar a partir de string suja
moeda = AngolaMoeda(" Kz 1.250,50 ")

# Formatação
print(moeda.formatar())          # 1.250,50 Kz
print(moeda.formatar(usar_iso=True)) # 1.250,50 AOA

# Extenso
print(moeda.por_extenso())        # Um mil duzentos e cinquenta kwanzas e cinquenta cêntimos

# Criar a partir de extenso
moeda_v2 = AngolaMoeda.de_extenso("Mil quinhentos kwanzas")
print(moeda_v2.valor)             # 1500.00
```

## Funcionalidades
- **Sanitizador:** Limpa qualquer entrada (Excel, formatado AGT, string bruta).
- **Formatador:** Segue o padrão bancário angolano.
- **Motores Modularizados:** Fácil de estender e manter.
- **Tipagem Forte:** Usa Pydantic e Decimal para precisão financeira.
