Metadata-Version: 2.4
Name: dubacengold
Version: 26.1
Summary: Biblioteca Python para calculos de datas uteis com calendario ANBIMA.
Author: dubacengold contributors
Keywords: anbima,datas,dias-uteis,financeiro,calendario
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# dubacengold

Biblioteca Python para calculos de dias uteis usando o calendario ANBIMA.

## O que a biblioteca faz

O pacote expoe funcoes simples para trabalhar com datas uteis:

- `help()`: mostra todos os comandos disponiveis na biblioteca.
- `hoje(offset=0)`: retorna o D0 util atual. Se hoje cair em fim de semana ou feriado, usa o ultimo dia util anterior.
- `hojenum(offset=0)`: retorna o serial numerico da data de `hoje()`, onde `1900-01-01 = 1`.
- `qdu(ordem, ano_mes)`: retorna o n-esimo dia util de um mes.
- `qdtu(inicio, fim)`: conta os dias uteis entre duas datas, incluindo as pontas.
- `qtdu(inicio, fim)`: alias de `qdtu`.

O calendario suportado cobre o intervalo de `2000-01-01` ate `2099-12-31`.

## Instalacao

```bash
python -m pip install dubacengold
```

## Versoes suportadas

Suporte garantido para Python `3.8+`.

## Uso rapido

```python
import dubacengold as du

du.help()
print(du.hoje())               # datetime do D0 util
print(du.hojenum())            # serial numerico do D0 util
print(du.hoje(-1))             # dia util anterior ao D0
print(du.qdu(5, "2026-04"))    # 5o dia util de abril de 2026
print(du.qdtu("2026-04-01", "2026-04-30"))
print(du.qtdu("2026-04-01", "2026-04-30"))
```

## Entradas aceitas

- string no formato `AAAA-MM-DD`
- string no formato `AAAA-MM` para `qdu`
- `datetime.date`
- `datetime.datetime`

## Regras importantes

- `help()` imprime a ajuda na tela.
- `hoje()` retorna um `datetime` em vez de `date`.
- `qdtu()` conta datas inicial e final quando elas forem dias uteis.
- Se `inicio > fim`, `qdtu()` retorna o valor negativo equivalente.
- `qdu()` gera erro quando a ordem pedida for maior que a quantidade de dias uteis do mes.
- Datas fora do intervalo suportado geram `ValueError`.

## Ajuda embutida

```python
import dubacengold as du

du.help()
```

A mensagem termina com:

```text
Salmo 90:12 - Ensina-nos a contar os nossos dias, para que alcancemos coracao sabio.
```
