Metadata-Version: 2.4
Name: DadosAbertosBrasil
Version: 3.0.0rc1
Summary: Pacote Python para acesso a dados abertos e APIs do governo brasileiro.
Author-email: Gustavo Furtado <gustavofurtado2@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/GusFurtado/DadosAbertosBrasil
Project-URL: Documentation, https://www.gustavofurtado.com/DadosAbertosBrasil/
Project-URL: Download, https://github.com/GusFurtado/DadosAbertosBrasil/archive/2.3.0.tar.gz
Keywords: brasil,ibge,ipea,ipeadata,camara,deputados,senado,senadores,bacen,bcb,bancocentral,dadosabertos,dadosgovbr
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Portuguese (Brazilian)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: pydantic>=2.0.0
Requires-Dist: requests>=2.3.3
Requires-Dist: urllib3>=2.8.0
Provides-Extra: pandas
Requires-Dist: pandas>=2.0.0; extra == "pandas"
Provides-Extra: polars
Requires-Dist: polars>=1.0.0; extra == "polars"
Dynamic: license-file

<p align="center">
  <a href="https://www.gustavofurtado.com/DadosAbertosBrasil/"><img src="https://www.gustavofurtado.com/assets/img/projects/dab.png" alt="Dados Abertos Brasil" width="640"></a>
</p>

<p align="center">
  <b>A forma mais simples de acessar dados abertos e APIs do governo brasileiro com Python.</b>
</p>

<p align="center">
  <a href="https://pypi.org/project/DadosAbertosBrasil/"><img src="https://img.shields.io/pypi/v/DadosAbertosBrasil" alt="PyPI"></a>
  <a href="https://pypi.org/project/DadosAbertosBrasil/"><img src="https://img.shields.io/pypi/pyversions/DadosAbertosBrasil" alt="Versões do Python"></a>
  <a href="https://pepy.tech/projects/DadosAbertosBrasil"><img src="https://static.pepy.tech/badge/DadosAbertosBrasil/month" alt="Downloads"></a>
  <a href="https://github.com/GusFurtado/DadosAbertosBrasil/actions/workflows/testes.yml"><img src="https://github.com/GusFurtado/DadosAbertosBrasil/actions/workflows/testes.yml/badge.svg" alt="Testes"></a>
  <a href="https://github.com/GusFurtado/DadosAbertosBrasil/blob/master/LICENSE.txt"><img src="https://img.shields.io/pypi/l/DadosAbertosBrasil" alt="Licença"></a>
</p>

<p align="center">
  <b><a href="https://www.gustavofurtado.com/DadosAbertosBrasil/">Documentação</a></b>
</p>

Pacote open-source que padroniza o acesso às APIs do IBGE, do Ipea, do Banco Central, da Câmara
dos Deputados e do Senado Federal, além de dados da Wikipedia e do Wikidata. As consultas devolvem
registros (`json`), modelos Pydantic ou DataFrames do pandas e do polars.

## Instalação

```sh
pip install DadosAbertosBrasil

# Para resultados em DataFrames
pip install "DadosAbertosBrasil[pandas]"   # ou [polars]
```

Vindo do 2.x? Veja o [guia de migração para o 3.0](https://www.gustavofurtado.com/DadosAbertosBrasil/migracao/).

## Módulos

- **`ibge`**: localidades, malhas, população, nomes e tabelas do SIDRA.
- **`ipea`**: séries temporais do IpeaData.
- **`bacen`**: câmbio, expectativas de mercado e séries do SGS do Banco Central.
- **`camara`**: deputados, partidos, proposições, votações e eventos da Câmara.
- **`senado`**: senadores, legislaturas, partidos e orçamentos do Senado.
- **`favoritos`**: atalhos para as consultas mais comuns, como IPCA, Selic e PIB.
- **`wiki`**: governadores, ministros, tribunais, partidos, UFs e municípios, da Wikipedia e do Wikidata.
- **`uf`**: a classe `UF`, que reúne os dados de um estado num só objeto.

Veja a [referência](https://www.gustavofurtado.com/DadosAbertosBrasil/referencia/ibge/) de cada
módulo e os [exemplos](https://github.com/GusFurtado/DadosAbertosBrasil-wiki/tree/2.x/exemplos).
