# gusfurtado/dadosabertosbrasil architecture

> Architecture diagram of the GitHub repository gusfurtado/dadosabertosbrasil, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gusfurtado/dadosabertosbrasil
- Repository: https://github.com/gusfurtado/dadosabertosbrasil

## Overview

DadosAbertosBrasil is a Python client that standardizes queries to Brazilian public-data APIs and Wikipedia/Wikidata. Users select a domain function or object, provide query parameters, and receive raw JSON, normalized records, Pydantic models, or pandas/polars DataFrames. Its domain modules cover economic indicators, statistics, legislative data, and state-level aggregation. Internals provide shared HTTP requests, parameter/record modeling, output conversion, and configuration. The map follows the README and source-index references; unsampled modules are represented by their existing paths, without inferring their internal call chains.

Main entry points: [`DadosAbertosBrasil/__init__.py`](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/__init__.py) (Package interface), [`DadosAbertosBrasil/utils/requisicao.py`](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/requisicao.py) (HTTP requests), [`DadosAbertosBrasil/uf/_uf.py`](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/uf/_uf.py) (State aggregator), [`DadosAbertosBrasil/bacen`](https://github.com/gusfurtado/dadosabertosbrasil/tree/master/DadosAbertosBrasil/bacen) (Central bank)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_economy["Economic data"]
  node_bacen["Central bank"]
  node_ipea["Ipea series"]
  node_favorites["Common queries<br/>[__init__.py]"]
end

subgraph group_legislative["Legislatures"]
  node_camara["Chamber data"]
  node_senado["Senate data"]
end

subgraph group_reference["Places and reference"]
  node_ibge["IBGE statistics"]
  node_wiki["Wiki datasets<br/>[_datasets.py]"]
  node_uf["State aggregator<br/>[_uf.py]"]
end

subgraph group_runtime["Shared runtime"]
  node_package["Package interface<br/>[__init__.py]"]
  node_config["Global settings<br/>[_config.py]"]
  node_request["HTTP requests<br/>[requisicao.py]"]
  node_output["Output conversion<br/>[saida.py]"]
  node_models["Record models<br/>[modelos.py]"]
  node_parsing["Parameter parsing<br/>[parse.py]"]
  node_objects["API objects<br/>[objeto.py]"]
  node_cache[("Response cache<br/>[cache.py]")]
end

node_user(("Python user"))
node_government{{"Government APIs"}}
node_wikimedia{{"Wikipedia/Wikidata"}}
node_dataframe{{"DataFrame libraries"}}

node_user -->|"queries through"| node_package
node_package -->|"exposes"| node_bacen
node_package -->|"exposes"| node_camara
node_package -->|"exposes"| node_ibge
node_package -->|"exposes"| node_ipea
node_package -->|"exposes"| node_senado
node_package -->|"exposes"| node_uf
node_package -->|"exposes"| node_wiki
node_package -->|"exposes"| node_favorites
node_bacen -->|"requests data"| node_request
node_ipea -->|"requests data"| node_request
node_camara -->|"requests data"| node_request
node_senado -.->|"requests data"| node_request
node_ibge -->|"requests data"| node_request
node_wiki -.->|"reads datasets"| node_government
node_bacen -->|"queries APIs"| node_government
node_ipea -->|"queries APIs"| node_government
node_camara -->|"queries APIs"| node_government
node_senado -->|"queries APIs"| node_government
node_ibge -->|"queries APIs"| node_government
node_wiki -->|"uses datasets"| node_wikimedia
node_uf -.->|"aggregates"| node_ibge
node_uf -->|"aggregates"| node_camara
node_uf -.->|"aggregates"| node_senado
node_uf -->|"aggregates"| node_wiki
node_favorites -->|"preconfigures queries"| node_bacen
node_request -->|"resolves settings"| node_config
node_request -->|"reads and writes"| node_cache
node_output -->|"consumes response"| node_request
node_output -->|"validates records"| node_models
node_output -->|"converts results"| node_dataframe
node_parsing -->|"supports validation"| node_models
node_objects -->|"loads details"| node_request

click node_bacen "https://github.com/gusfurtado/dadosabertosbrasil/tree/master/DadosAbertosBrasil/bacen"
click node_ipea "https://github.com/gusfurtado/dadosabertosbrasil/tree/master/DadosAbertosBrasil/ipea"
click node_favorites "https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/favoritos/__init__.py"
click node_camara "https://github.com/gusfurtado/dadosabertosbrasil/tree/master/DadosAbertosBrasil/camara"
click node_senado "https://github.com/gusfurtado/dadosabertosbrasil/tree/master/DadosAbertosBrasil/senado"
click node_ibge "https://github.com/gusfurtado/dadosabertosbrasil/tree/master/DadosAbertosBrasil/ibge"
click node_wiki "https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/wiki/_datasets.py"
click node_uf "https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/uf/_uf.py"
click node_package "https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/__init__.py"
click node_config "https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/_config.py"
click node_request "https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/requisicao.py"
click node_output "https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/saida.py"
click node_models "https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/modelos.py"
click node_parsing "https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/parse.py"
click node_objects "https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/objeto.py"
click node_cache "https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/cache.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_bacen,node_ipea,node_favorites,node_user toneBlue
class node_camara,node_senado toneAmber
class node_ibge,node_wiki,node_uf,node_government toneMint
class node_package,node_config,node_request,node_output,node_models,node_parsing,node_objects,node_cache toneRose
class node_wikimedia,node_dataframe toneIndigo
```

## Components

### Economic data

- [Central bank](https://github.com/gusfurtado/dadosabertosbrasil/tree/master/DadosAbertosBrasil/bacen): `DadosAbertosBrasil/bacen`
- [Ipea series](https://github.com/gusfurtado/dadosabertosbrasil/tree/master/DadosAbertosBrasil/ipea): `DadosAbertosBrasil/ipea`
- [Common queries](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/favoritos/__init__.py): `DadosAbertosBrasil/favoritos/__init__.py`

### Legislatures

- [Chamber data](https://github.com/gusfurtado/dadosabertosbrasil/tree/master/DadosAbertosBrasil/camara): `DadosAbertosBrasil/camara`
- [Senate data](https://github.com/gusfurtado/dadosabertosbrasil/tree/master/DadosAbertosBrasil/senado): `DadosAbertosBrasil/senado`

### Places and reference

- [IBGE statistics](https://github.com/gusfurtado/dadosabertosbrasil/tree/master/DadosAbertosBrasil/ibge): `DadosAbertosBrasil/ibge`
- [Wiki datasets](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/wiki/_datasets.py): `DadosAbertosBrasil/wiki/_datasets.py`
- [State aggregator](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/uf/_uf.py): `DadosAbertosBrasil/uf/_uf.py`

### Shared runtime

- [Package interface](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/__init__.py): `DadosAbertosBrasil/__init__.py`
- [Global settings](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/_config.py): `DadosAbertosBrasil/_config.py`
- [HTTP requests](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/requisicao.py): `DadosAbertosBrasil/utils/requisicao.py`
- [Output conversion](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/saida.py): `DadosAbertosBrasil/utils/saida.py`
- [Record models](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/modelos.py): `DadosAbertosBrasil/utils/modelos.py`
- [Parameter parsing](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/parse.py): `DadosAbertosBrasil/utils/parse.py`
- [API objects](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/objeto.py): `DadosAbertosBrasil/utils/objeto.py`
- [Response cache](https://github.com/gusfurtado/dadosabertosbrasil/blob/master/DadosAbertosBrasil/utils/cache.py): `DadosAbertosBrasil/utils/cache.py`

### Other components

- **Python user**
- **Government APIs**
- **Wikipedia/Wikidata**
- **DataFrame libraries**

## Connections

- Python user → Package interface: queries through
- Package interface → Central bank: exposes (evidence: `DadosAbertosBrasil/__init__.py`)
- Package interface → Chamber data: exposes (evidence: `DadosAbertosBrasil/__init__.py`)
- Package interface → IBGE statistics: exposes (evidence: `DadosAbertosBrasil/__init__.py`)
- Package interface → Ipea series: exposes (evidence: `DadosAbertosBrasil/__init__.py`)
- Package interface → Senate data: exposes (evidence: `DadosAbertosBrasil/__init__.py`)
- Package interface → State aggregator: exposes (evidence: `DadosAbertosBrasil/__init__.py`)
- Package interface → Wiki datasets: exposes (evidence: `DadosAbertosBrasil/__init__.py`)
- Package interface → Common queries: exposes (evidence: `DadosAbertosBrasil/__init__.py`)
- Central bank → HTTP requests: requests data (evidence: `DadosAbertosBrasil/bacen/_cambio.py`)
- Ipea series → HTTP requests: requests data (evidence: `DadosAbertosBrasil/ipea/_serie.py`)
- Chamber data → HTTP requests: requests data (evidence: `DadosAbertosBrasil/camara/_deputados.py`)
- Senate data → HTTP requests: requests data (evidence: `DadosAbertosBrasil/senado/_comum.py`)
- IBGE statistics → HTTP requests: requests data (evidence: `DadosAbertosBrasil/ibge/_sidra.py`)
- Wiki datasets → Government APIs: reads datasets
- Central bank → Government APIs: queries APIs
- Ipea series → Government APIs: queries APIs
- Chamber data → Government APIs: queries APIs
- Senate data → Government APIs: queries APIs
- IBGE statistics → Government APIs: queries APIs
- Wiki datasets → Wikipedia/Wikidata: uses datasets
- State aggregator → IBGE statistics: aggregates (evidence: `DadosAbertosBrasil/uf/_uf.py`)
- State aggregator → Chamber data: aggregates (evidence: `DadosAbertosBrasil/uf/_uf.py`)
- State aggregator → Senate data: aggregates (evidence: `DadosAbertosBrasil/uf/_uf.py`)
- State aggregator → Wiki datasets: aggregates (evidence: `DadosAbertosBrasil/uf/_uf.py`)
- Common queries → Central bank: preconfigures queries (evidence: `DadosAbertosBrasil/favoritos/__init__.py`)
- HTTP requests → Global settings: resolves settings (evidence: `DadosAbertosBrasil/utils/requisicao.py`)
- HTTP requests → Response cache: reads and writes (evidence: `DadosAbertosBrasil/utils/requisicao.py`)
- Output conversion → HTTP requests: consumes response (evidence: `DadosAbertosBrasil/utils/saida.py`)
- Output conversion → Record models: validates records (evidence: `DadosAbertosBrasil/utils/saida.py`)
- Output conversion → DataFrame libraries: converts results (evidence: `DadosAbertosBrasil/utils/saida.py`)
- Parameter parsing → Record models: supports validation (evidence: `DadosAbertosBrasil/utils/modelos.py`)
- API objects → HTTP requests: loads details (evidence: `DadosAbertosBrasil/utils/objeto.py`)
