The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.

alepe

R-CMD-check CRAN status

Tidy access to the open data API of the Legislative Assembly of the State of Pernambuco, Brazil (ALEPE): representatives, staff, positions, departments, remuneration, contracts, procurement, and legislative propositions — as tibbles with clean names and parsed types.

Installation

# CRAN (once accepted)
install.packages("alepe")

# Development version
pak::pak("StrategicProjects/alepe")

Quick start

library(alepe)
library(dplyr)

# Current representatives
alepe_representatives()

# Permanent staff, largest departments
alepe_staff(status = "permanent") |>
  count(nome_lotacao, sort = TRUE)

# Contracts active today
alepe_contracts() |>
  filter(vigencia_inicio <= Sys.Date(), vigencia_fim >= Sys.Date())

# Bills of a given year
alepe_bills(year = 2024)

Filter values use an English vocabulary ("permanent", "commissioned", "seconded"), but the original API terms ("efetivo", "comissionado", "a-disposicao") are accepted as well. Column names keep the official Portuguese field names, normalized to snake_case, so results stay traceable to the source.

How it works

Every exported function is a thin wrapper over the same core: a cached, retrying request whose response is typed into a tibble by a documented schema. When the API cannot be reached, the call warns and returns a zero-row tibble with those same columns instead of raising an error.

A call to alepe_contracts() goes through alepe_req(), which adds the user agent, a 60 second timeout, a six-hour cache and retries, then alepe_perform() talks to the ALEPE API. A 2xx response is parsed by alepe_fetch_json() and typed by records_to_tibble() into a tibble with data; a timeout or an error surviving the retries produces a classed warning and a zero-row tibble with the same columns.

Architecture

Three layers. The endpoint layer holds R/people.R, R/money.R, R/propositions.R and R/cache.R, which export one function per endpoint. They share a core layer: R/req.R for requests, caching, retries and graceful failure, and R/utils.R for naming, typing and Brazilian number and date formats. Below sit the ALEPE open data API and the on-disk response cache.

Em português

Cada função tem um alias com o nome do próprio endpoint da API, para quem prefere manter o pipeline inteiro em português. Mesmos argumentos, mesmos padrões, mesmo resultado:

alepe_parlamentares()
alepe_servidores(status = "efetivo")
alepe_contratos()
alepe_projetos(ano = 2024)

alepe_cargos(), alepe_lotacoes(), alepe_remuneracao(), alepe_licitacoes(), alepe_indicacoes(), alepe_requerimentos() and alepe_limpar_cache() complete the set — see ?alepe_aliases.

alepe belongs to a family of R clients for Brazilian public data that share the same httr2/cli design and the same graceful-failure contract. All of them are on CRAN:

Package Covers
tceper Pernambuco Court of Accounts
BigDataPE Pernambuco state data platform
transferegovr Federal transfers (‘TransfereGov’)
tesouror National Treasury
obrasgovr Federal public works (‘ObrasGov’)
comexr Foreign trade statistics (‘ComexStat’)
datasusr Public health data (‘DATASUS’)
ibger ‘IBGE’ aggregate data
pixr Central Bank ‘PIX’ open data

Developed at CASTLab/UFPE and published under StrategicProjects.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By contributing you agree to abide by its terms.

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.