ibger: Access the IBGE Aggregate Data API from R

[milkway]

Submitting Author Name: André Leite
Submitting Author Github Handle: @milkway
Other Package Authors Github handles: (comma separated, delete if none) @marcoswasiliew, @hugoavmedeiros, @cagaf, @DiCarvalhoB
Repository: https://github.com/StrategicProjects/ibger
Version submitted: 0.2.0
Submission type: Standard
Editor: @beatrizmilz
Reviewers: @allanvc, @ddiannae

Due date for @allanvc: 2026-08-28

Due date for @ddiannae: 2026-09-04
Archive: TBD
Version accepted: TBD
Language: en

---

• Paste the full DESCRIPTION file inside a code block below:

Package: ibger
Title: Access the 'IBGE' Aggregate Data API from 'R'
Version: 0.2.0
Authors@R: c(
    person("Andre", "Leite", email = "leite@castlab.org", role = c("aut", "cre"),
           comment = c(ORCID = "0000-0002-4718-9766")),
    person("Marcos", "Wasiliew", email = "marcos.wasilew@gmail.com", role = "aut"),
    person("Hugo", "Vasconcelos", email = "hugo.vasconcelos@ufpe.br", role = "aut",
           comment = c(ORCID = "0000-0001-6249-0920")),
    person("Carlos", "Amorim", email = "carlos.agaf@ufpe.br", role = "aut",
           comment = c(ORCID = "0000-0001-6315-8305")),
    person("Diogo", "Bezerra", email = "diogo.bezerra@ufpe.br", role = "aut",
           comment = c(ORCID = "0000-0002-1216-8674")))
Description: 'Tidyverse'-friendly interface to the Brazilian Institute of Geography and Statistics ('IBGE') aggregate data 'API' 
    <https://servicodados.ibge.gov.br/api/docs/agregados?versao=3>. Query aggregates, variables, localities, periods, and metadata
    from surveys and censuses conducted by 'IBGE'.
License: MIT + file LICENSE
URL: https://github.com/StrategicProjects/ibger,
    https://strategicprojects.github.io/ibger/
BugReports: https://github.com/StrategicProjects/ibger/issues
Encoding: UTF-8
Roxygen: list(markdown = TRUE)
Depends: 
    R (>= 4.1.0)
Imports: 
    httr2 (>= 1.0.0),
    cli (>= 3.6.0),
    tibble,
    purrr,
    dplyr,
    rlang,
    glue
Suggests:
    knitr,
    rmarkdown,
    pkgdown,
    ggplot2,
    tidyr,
    shiny (>= 1.8.0),
    DT,
    bslib (>= 0.6.0),
    bsicons,
    rstudioapi,
    testthat (>= 3.0.0),
    httptest2,
    withr
Config/testthat/edition: 3
VignetteBuilder: knitr
Config/roxygen2/version: 8.0.0

Scope

• Please indicate which category or categories from our package fit policies this package falls under: (Please check an appropriate box below. If you are unsure, we suggest you make a pre-submission inquiry.):

  • data retrieval
  • data extraction
  • data munging
  • data deposition
  • data validation and testing
  • workflow automation
  • version control
  • citation management and bibliometrics
  • scientific software wrappers
  • field and lab reproducibility tools
  • database software bindings
  • geospatial data
  • translation
  • rOpenSci internal tools

• Explain how and why the package falls under these categories (briefly, 1-2 sentences):

  ibger retrieves Brazil's official statistics — census tables and recurring demographic, economic, social and agricultural surveys — from the Brazilian Institute of Geography and Statistics (IBGE) Aggregates API v3, returning tidy tibbles ready for analysis. It also covers the IBGE Metadata API (survey catalog and methodological documentation).

• Who is the target audience and what are scientific applications of this package?

  Researchers, statistical agencies, journalists and public-policy analysts working with Brazilian official statistics. Scientific applications include reproducible access to indicators such as consumer price inflation (IPCA), municipal GDP, census population counts and agricultural production series, at any geographic level from the whole country down to its 5,570 municipalities. The package grew out of the production needs of Pernambuco's Strategic Monitoring Data Science Team (doi:10.59490/dgo.2025.925).

• Are there other R packages that accomplish the same thing? If so, how does yours differ or meet our criteria for best-in-category?

  sidrar is the closest package. It accesses the legacy SIDRA API and inherits its constraints: a 20,000-value per-request limit with no built-in work-around, metadata discovery via HTML scraping, no pre-flight validation, and positional string-coded parameters. ibger uses the modern Aggregates API v3 (structured JSON metadata endpoints) and differs in three main ways: (1) parameters are validated against cached table metadata before any request, producing informative errors that list allowed values; (2) large queries are automatically split into multiple requests and combined (the API rejects requests above ~50,000 values in practice), removing the practical size ceiling; and (3) parse_sidra_url()/fetch_sidra_url() translate legacy SIDRA URLs into equivalent ibger calls, easing migration from sidrar scripts and the SIDRA Query Builder. A detailed comparison table is in the README. Packages such as PNADcIBGE/SIPDIBGE target survey microdata, a different data product; geobr covers spatial data and censobr census microdata — none accesses the SIDRA aggregate tables. A Python sibling with a mirrored API is maintained by the same team (https://github.com/StrategicProjects/ibgepy).

• (If applicable) Does your package comply with our guidance around Ethics, Data Privacy and Human Subjects Research?

  Not applicable: the package retrieves aggregate, public, official statistics only (no microdata or personal data). IBGE itself suppresses disclosive cells (code "X"), which parse_ibge_value() preserves as NA.

• If you made a pre-submission inquiry, please paste the link to the corresponding issue, forum post, or other discussion, or @tag the editor you contacted.

  None.

• Explain reasons for any pkgcheck items which your package is unable to pass.

  All pkgcheck items pass. One note: most function examples use \dontrun{} because every fetch function calls the live IBGE API; offline behaviour is instead covered by the test suite, which runs against recorded httptest2 fixtures (~87% coverage, reported on Codecov). Happy to convert examples to @examplesIf interactive() if preferred.

Technical checks

Confirm each of the following by checking the box.

• I have read the rOpenSci packaging guide.
• I have read the author guide and I expect to maintain this package for at least 2 years or to find a replacement.

This package:

• does not violate the Terms of Service of any service it interacts with.
• has a CRAN and OSI accepted license.
• contains a README with instructions for installing the development version.
• includes documentation with examples for all functions, created with roxygen2.
• contains a vignette with examples of its essential functions and uses.
• has a test suite.
• has continuous integration, including reporting of test coverage.

Use of Generative AI

• Generative AI tools were used to produce some of the material in this submission.

Claude Code (Anthropic) was used as a development assistant: it helped scaffold the httptest2-based test suite (fixtures recorded from live IBGE API responses), draft and revise documentation and vignettes, prepare the accompanying JOSS paper.md, and draft this submission text. All AI-assisted material was reviewed by the human authors and validated through R CMD check, the test suite, and rOpenSci pkgcheck.

Publication options

• Do you intend for this package to go on CRAN? (already on CRAN, version 0.2.0)

• Do you intend for this package to go on Bioconductor?

• Do you wish to submit an Applications Article about your package to Methods in Ecology and Evolution?

We intend to submit the accompanying short paper (paper.md in the package root) to the Journal of Open Source Software after the rOpenSci review process is over, per the rOpenSci–JOSS collaboration.

Code of conduct

• I agree to abide by rOpenSci's Code of Conduct during the review process and in maintaining my package should it be accepted.

[ropensci-review-bot]

Thanks for submitting to rOpenSci, our editors and @ropensci-review-bot will reply soon. Type @ropensci-review-bot help for help.

[ropensci-review-bot]

🚀

Editor check started

👋

[ropensci-review-bot]

Five most similar rOpenSci packages

• rdhs 'API Client and Dataset Management for the Demographic and Health
  Survey (DHS) Data' (v0.8.1, released 2023-11-21)
• prism 'Access Data from the Oregon State Prism Climate Project' (v0.3.0, released 2025-11-14)
• patentsview 'An R Client to the 'PatentsView' API' (v1.0.0, released 2026-02-26)
• comtradr 'Interface with the United Nations Comtrade API' (v1.0.5, released 2025-12-15)
• rnassqs 'Access Data from the NASS 'Quick Stats' API' (v0.6.3, released 2024-08-30)

Five most similar CRAN packages

• ibger 'Access the 'IBGE' Aggregate Data API from 'R'' (v0.1.0, published 2026-07-08)
• datazoom.amazonia 'Simplify Access to Data from the Amazon Region' (v1.2.0, published 2026-07-03)
• sensortowerR 'Interface to 'Sensor Tower' Mobile App Intelligence API' (v1.0.1, published 2026-05-14)
• ipumsr 'An R Interface for Downloading, Reading, and Handling IPUMS Data' (v0.10.0, published 2026-03-13)
• healthbR 'Access Brazilian Public Health Data' (v0.2.0, published 2026-02-15)

---

Matches are generated by the 'pkgmatch' package, based on inverse-term frequencies; see the main function documentation for details.

[mpadge]

@ropensci-review-bot check package

[ropensci-review-bot]

Thanks, about to send the query.

[ropensci-review-bot]

🚀

Editor check started

👋

[maurolepore]

@ropensci-review-bot check package

[ropensci-review-bot]

Thanks, about to send the query.

[ropensci-review-bot]

🚀

Editor check started

👋

[ropensci-review-bot]

Checks for ibger (v0.2.0)

git hash: 3c64923b

• ✔️ Package is already on CRAN.
• ✔️ has a 'contributing' file.
• ✔️ uses 'roxygen2'.
• ✔️ 'DESCRIPTION' has a URL field.
• ✔️ 'DESCRIPTION' has a BugReports field.
• ✔️ Package has at least one HTML vignette
• ✔️ All functions have examples.
• ✔️ Repository has a website
• ✔️ Package has continuous integration checks.
• ✖️ Package coverage is 58.5% (should be at least 75%).
• ✔️ R CMD check found no errors.
• ✔️ R CMD check found no warnings.
• 👀 Some goodpractice linters failed.
• 👀 Examples should not use \dontrun{} unless really necessary.

Important: All failing checks above must be addressed prior to proceeding

(Checks marked with 👀 may be optionally addressed.)

Package License: MIT + file LICENSE

---

1. Package Dependencies

Details of Package Dependency Usage (click to open)

The table below tallies all function calls to all packages ('ncalls'), both internal (r-base + recommended, along with the package itself), and external (imported and suggested packages). 'NA' values indicate packages to which no identified calls to R functions could be found. Note that these results are generated by an automated code-tagging system which may not be entirely accurate.

type	package	ncalls
internal	base	456
internal	ibger	144
internal	stats	45
internal	utils	43
internal	Matrix	10
internal	graphics	4
imports	purrr	59
imports	cli	27
imports	tibble	18
imports	httr2	14
imports	rlang	1
imports	glue	1
imports	dplyr	NA
suggests	shiny	2
suggests	knitr	NA
suggests	rmarkdown	NA
suggests	pkgdown	NA
suggests	ggplot2	NA
suggests	tidyr	NA
suggests	DT	NA
suggests	bslib	NA
suggests	bsicons	NA
suggests	rstudioapi	NA
suggests	testthat	NA
suggests	httptest2	NA
suggests	withr	NA
linking_to	NA	NA

Click below for tallies of functions used in each package. Locations of each call within this package may be generated locally by running 's <- pkgstats::pkgstats(<path/to/repo>)', and examining the 'external_calls' table.

base

list (55), c (42), character (42), nrow (27), if (26), call (24), length (21), units (20), paste0 (15), return (15), is.null (12), for (11), paste (11), row (10), as.character (8), rep (8), names (7), seq_len (7), unlist (7), as.numeric (6), min (6), as.integer (5), is.na (5), strsplit (5), cat (4), setdiff (4), sub (4), toupper (4), tryCatch (4), vapply (4), order (3), conditionMessage (2), drop (2), emptyenv (2), floor (2), get (2), new.env (2), sort (2), unique (2), which (2), abs (1), any (1), gregexpr (1), identical (1), is.character (1), is.numeric (1), lengths (1), levels (1), max (1), nchar (1), range (1), regmatches (1), sum (1), suppressWarnings (1), system.file (1), tolower (1)

ibger

pluck_chr (45), ibge_request (9), get_meta (6), ibge_metadados_request (5), extract_numeric_periods (3), format_localities (3), get_cached_locality_ids (3), get_cached_metadata (3), get_cached_survey_periods (3), ibge_metadata (3), split_in_groups (3), units_to_localities_str (3), body (2), build_ibger_call (2), estimate_n_categories (2), estimate_n_variables (2), extract_levels (2), format_classification (2), format_periods (2), format_variable (2), get_cached_period_ids (2), get_cached_survey_catalog (2), is_error (2), parse_classifications (2), parse_sidra_url (2), parse_variables (2), resolve_chunk_limit (2), resolve_localities_for_chunking (2), resolve_period_ids (2), as_chr (1), build_chunk_plan (1), estimate_n_periods (1), fetch_sidra_url (1), ibge_aggregates (1), ibge_clear_cache (1), ibge_explorer (1), ibge_localities (1), ibge_periods (1), ibge_subjects (1), ibge_survey_metadata (1), ibge_survey_periods (1), ibge_surveys (1), ibge_variables (1), parse_ibge_value (1), parse_variables_default (1), parse_variables_flat (1), print.ibge_metadata (1), print.ibge_survey_metadata (1), print.sidra_query (1), validate_classifications (1)

purrr

map_dfr (21), map (11), map_chr (9), imap_chr (8), imap (4), imap_dbl (2), compact (1), map_int (1), map_lgl (1), pluck (1)

stats

aggregate (20), end (7), start (7), frequency (5), var (4), na.omit (1), setNames (1)

utils

data (42), adist (1)

cli

cli_abort (23), cli_bullets (3), cli_warn (1)

tibble

tibble (17), tribble (1)

httr2

req_retry (4), resp_body_json (4), resp_status (4), request (2)

Matrix

collapse (10)

graphics

segments (4)

shiny

paneViewer (1), runApp (1)

glue

glue (1)

rlang

hash (1)

NOTE: Some imported packages appear to have no associated function calls; please ensure with author that these 'Imports' are listed appropriately.

---

2. Statistical Properties

This package features some noteworthy statistical properties which may need to be clarified by a handling editor prior to progressing.

Details of statistical properties (click to open)

The package has:

• code in R (100% in 15 files) and
• 5 authors
• 4 vignettes
• no internal data file
• 7 imported packages
• 14 exported functions (median 32 lines of code)
• 45 non-exported functions in R (median 16 lines of code)

---

Statistical properties of package structure as distributional percentiles in relation to all current CRAN packages
The following terminology is used:

• loc = "Lines of Code"
• fn = "function"
• exp/not_exp = exported / not exported

All parameters are explained as tooltips in the locally-rendered HTML version of this report generated by the checks_to_markdown() function

The final measure (fn_call_network_size) is the total number of calls between functions (in R), or more abstract relationships between code objects in other languages. Values are flagged as "noteworthy" when they lie in the upper or lower 5th percentile.

measure	value	percentile	noteworthy
files_R	13	80.0
files_inst	2	85.3
files_vignettes	8	98.7
files_tests	9	93.6
loc_R	1698	89.0
loc_inst	204	65.1
loc_vignettes	1034	90.4
loc_tests	660	82.6
num_vignettes	4	96.5	TRUE
n_fns_r	59	88.1
n_fns_r_exported	14	74.7
n_fns_r_not_exported	45	93.2
n_fns_per_file_r	5	83.9
num_params_per_fn	1	44.6
loc_per_fn_r	17	72.0
loc_per_fn_r_exp	32	79.5
loc_per_fn_r_not_exp	16	86.4
doclines_per_fn_exp	32	62.3
doclines_per_fn_not_exp	1	80.1
fn_call_network_size	105	87.4

---

2a. Network visualisation

Click to see the interactive network visualisation of calls between objects in package

---

3. goodpractice and other checks

Details of goodpractice checks (click to open)

3a. Continuous Integration Badges

GitHub Workflow Results

id	name	conclusion	sha	run_number	date
29015762369	Draft JOSS PDF	success	3c6492	6	2026-07-09
29015762406	pkgdown.yaml	success	3c6492	13	2026-07-09
29015762434	R-CMD-check.yaml	success	3c6492	8	2026-07-09
29015762443	test-coverage.yaml	success	3c6492	8	2026-07-09

---

3b. goodpractice results

Test coverage with covr

Package coverage: 58.49

The following files are not completely covered by tests:

file	coverage
R/agregados.R	0%
R/localidades.R	0%
R/metadados.R	32.31%
R/periodos.R	0%
R/surveys.R	0%
R/utils.R	53.09%
R/variaveis.R	51.16%

Cyclocomplexity with cyclocomp

The following functions have cyclocomplexity >= 15:

function	cyclocomplexity
parse_sidra_url	33
extract_numeric_periods	32
ibge_survey_metadata	29
build_ibger_call	25
print.ibge_survey_metadata	22
print.sidra_query	21
ibge_metadata	20
fetch_sidra_url	18
estimate_n_periods	17
validate_classifications	17
resolve_chunk_limit	16

Static code analyses with lintr

lintr found the following 226 potential issues:

message	number of times
!all(x) is better than any(!x).	1
!any(x) is better than all(!x).	1
Avoid duplicate arguments in function calls.	4
Avoid undesirable function "require".	5
Avoid undesirable operator <<-.	2
Lines should not be more than 80 characters.	87
Pass pluck_chr directly as a symbol to map_chr() instead of wrapping it in an unnecessary anonymous function.	2
Replace unnecessary c() by NULL or, whenever possible, vector() seeded with the correct type and/or length.	1
toString(.) is more expressive than paste(., collapse = ", ").	4
Use "-" with fixed = TRUE here.	2
Use "," with fixed = TRUE here.	4
Use "/" with fixed = TRUE here.	1
Use "	" with fixed = TRUE here.
Use "5434" with fixed = TRUE here.	1
Use "CD" with fixed = TRUE here.	1
Use "Fake aggregate" with fixed = TRUE here.	1
Use "Produto das lavouras" with fixed = TRUE here.	1
Use "SIDRA Query" with fixed = TRUE here.	1
Use expect_identical(x, y) by default; resort to expect_equal() only when needed, e.g.	105

Other goodpractice checks

✖️ Avoid duplicated @param documentation across functions

---

Package Versions

package	version
pkgstats	0.2.3.2
pkgcheck	0.1.3.6

---

Editor-in-Chief Instructions:

Processing may not proceed until the items marked with ✖️ have been resolved.

This package has some noteworthy properties, see 'Package Statistics' details above.

[milkway]

@maurolepore Thanks for running the checks!

Regarding the failing coverage check (58.5%): this appears to be an artifact of the check environment rather than missing tests. All API tests live in tests/testthat/test-api.R, which starts with skip_if_not_installed("httptest2") — httptest2 is in Suggests, and the recorded fixtures replay offline, so no network access is needed. Running covr locally with that single file removed reproduces the bot's number exactly (58.49%, with identical per-file values, including 0% for R/agregados.R, R/localidades.R, R/periodos.R and R/surveys.R, which are only exercised there). So the whole file seems to have been skipped in the check environment, presumably because httptest2 was not available when covr ran.

With the full suite, coverage for the same commit (3c64923) is 87.1% on Codecov: https://app.codecov.io/gh/StrategicProjects/ibger

I'll ask the bot to re-run the checks in case this was a transient dependency-installation failure.

[milkway]

@ropensci-review-bot check package

[ropensci-review-bot]

Thanks, about to send the query.

[ropensci-review-bot]

🚀

Editor check started

👋

[ropensci-review-bot]

Checks for ibger (v0.2.0)

git hash: 3c64923b

• ✔️ Package is already on CRAN.
• ✔️ has a 'contributing' file.
• ✔️ uses 'roxygen2'.
• ✔️ 'DESCRIPTION' has a URL field.
• ✔️ 'DESCRIPTION' has a BugReports field.
• ✔️ Package has at least one HTML vignette
• ✔️ All functions have examples.
• ✔️ Repository has a website
• ✔️ Package has continuous integration checks.
• ✔️ Package coverage is 87.1%.
• ✔️ R CMD check found no errors.
• ✔️ R CMD check found no warnings.
• 👀 Some goodpractice linters failed.
• 👀 Examples should not use \dontrun{} unless really necessary.

(Checks marked with 👀 may be optionally addressed.)

Package License: MIT + file LICENSE

---

1. Package Dependencies

Details of Package Dependency Usage (click to open)

The table below tallies all function calls to all packages ('ncalls'), both internal (r-base + recommended, along with the package itself), and external (imported and suggested packages). 'NA' values indicate packages to which no identified calls to R functions could be found. Note that these results are generated by an automated code-tagging system which may not be entirely accurate.

type	package	ncalls
internal	base	456
internal	ibger	144
internal	stats	45
internal	utils	43
internal	Matrix	10
internal	graphics	4
imports	purrr	59
imports	cli	27
imports	tibble	18
imports	httr2	14
imports	rlang	1
imports	glue	1
imports	dplyr	NA
suggests	shiny	2
suggests	knitr	NA
suggests	rmarkdown	NA
suggests	pkgdown	NA
suggests	ggplot2	NA
suggests	tidyr	NA
suggests	DT	NA
suggests	bslib	NA
suggests	bsicons	NA
suggests	rstudioapi	NA
suggests	testthat	NA
suggests	httptest2	NA
suggests	withr	NA
linking_to	NA	NA

Click below for tallies of functions used in each package. Locations of each call within this package may be generated locally by running 's <- pkgstats::pkgstats(<path/to/repo>)', and examining the 'external_calls' table.

base

list (55), c (42), character (42), nrow (27), if (26), call (24), length (21), units (20), paste0 (15), return (15), is.null (12), for (11), paste (11), row (10), as.character (8), rep (8), names (7), seq_len (7), unlist (7), as.numeric (6), min (6), as.integer (5), is.na (5), strsplit (5), cat (4), setdiff (4), sub (4), toupper (4), tryCatch (4), vapply (4), order (3), conditionMessage (2), drop (2), emptyenv (2), floor (2), get (2), new.env (2), sort (2), unique (2), which (2), abs (1), any (1), gregexpr (1), identical (1), is.character (1), is.numeric (1), lengths (1), levels (1), max (1), nchar (1), range (1), regmatches (1), sum (1), suppressWarnings (1), system.file (1), tolower (1)

ibger

pluck_chr (45), ibge_request (9), get_meta (6), ibge_metadados_request (5), extract_numeric_periods (3), format_localities (3), get_cached_locality_ids (3), get_cached_metadata (3), get_cached_survey_periods (3), ibge_metadata (3), split_in_groups (3), units_to_localities_str (3), body (2), build_ibger_call (2), estimate_n_categories (2), estimate_n_variables (2), extract_levels (2), format_classification (2), format_periods (2), format_variable (2), get_cached_period_ids (2), get_cached_survey_catalog (2), is_error (2), parse_classifications (2), parse_sidra_url (2), parse_variables (2), resolve_chunk_limit (2), resolve_localities_for_chunking (2), resolve_period_ids (2), as_chr (1), build_chunk_plan (1), estimate_n_periods (1), fetch_sidra_url (1), ibge_aggregates (1), ibge_clear_cache (1), ibge_explorer (1), ibge_localities (1), ibge_periods (1), ibge_subjects (1), ibge_survey_metadata (1), ibge_survey_periods (1), ibge_surveys (1), ibge_variables (1), parse_ibge_value (1), parse_variables_default (1), parse_variables_flat (1), print.ibge_metadata (1), print.ibge_survey_metadata (1), print.sidra_query (1), validate_classifications (1)

purrr

map_dfr (21), map (11), map_chr (9), imap_chr (8), imap (4), imap_dbl (2), compact (1), map_int (1), map_lgl (1), pluck (1)

stats

aggregate (20), end (7), start (7), frequency (5), var (4), na.omit (1), setNames (1)

utils

data (42), adist (1)

cli

cli_abort (23), cli_bullets (3), cli_warn (1)

tibble

tibble (17), tribble (1)

httr2

req_retry (4), resp_body_json (4), resp_status (4), request (2)

Matrix

collapse (10)

graphics

segments (4)

shiny

paneViewer (1), runApp (1)

glue

glue (1)

rlang

hash (1)

NOTE: Some imported packages appear to have no associated function calls; please ensure with author that these 'Imports' are listed appropriately.

---

2. Statistical Properties

This package features some noteworthy statistical properties which may need to be clarified by a handling editor prior to progressing.

Details of statistical properties (click to open)

The package has:

• code in R (100% in 15 files) and
• 5 authors
• 4 vignettes
• no internal data file
• 7 imported packages
• 14 exported functions (median 32 lines of code)
• 45 non-exported functions in R (median 16 lines of code)

---

Statistical properties of package structure as distributional percentiles in relation to all current CRAN packages
The following terminology is used:

• loc = "Lines of Code"
• fn = "function"
• exp/not_exp = exported / not exported

All parameters are explained as tooltips in the locally-rendered HTML version of this report generated by the checks_to_markdown() function

The final measure (fn_call_network_size) is the total number of calls between functions (in R), or more abstract relationships between code objects in other languages. Values are flagged as "noteworthy" when they lie in the upper or lower 5th percentile.

measure	value	percentile	noteworthy
files_R	13	80.0
files_inst	2	85.3
files_vignettes	8	98.7
files_tests	9	93.6
loc_R	1698	89.0
loc_inst	204	65.1
loc_vignettes	1034	90.4
loc_tests	660	82.6
num_vignettes	4	96.5	TRUE
n_fns_r	59	88.1
n_fns_r_exported	14	74.7
n_fns_r_not_exported	45	93.2
n_fns_per_file_r	5	83.9
num_params_per_fn	1	44.6
loc_per_fn_r	17	72.0
loc_per_fn_r_exp	32	79.5
loc_per_fn_r_not_exp	16	86.4
doclines_per_fn_exp	32	62.3
doclines_per_fn_not_exp	1	80.1
fn_call_network_size	105	87.4

---

2a. Network visualisation

Click to see the interactive network visualisation of calls between objects in package

---

3. goodpractice and other checks

Details of goodpractice checks (click to open)

3a. Continuous Integration Badges

GitHub Workflow Results

id	name	conclusion	sha	run_number	date
29015762369	Draft JOSS PDF	success	3c6492	6	2026-07-09
29015762406	pkgdown.yaml	success	3c6492	13	2026-07-09
29015762434	R-CMD-check.yaml	success	3c6492	8	2026-07-09
29015762443	test-coverage.yaml	success	3c6492	8	2026-07-09

---

3b. goodpractice results

Test coverage with covr

Package coverage: 87.1

Cyclocomplexity with cyclocomp

The following functions have cyclocomplexity >= 15:

function	cyclocomplexity
parse_sidra_url	33
extract_numeric_periods	32
ibge_survey_metadata	29
build_ibger_call	25
print.ibge_survey_metadata	22
print.sidra_query	21
ibge_metadata	20
fetch_sidra_url	18
estimate_n_periods	17
validate_classifications	17
resolve_chunk_limit	16

Static code analyses with lintr

lintr found the following 226 potential issues:

message	number of times
!all(x) is better than any(!x).	1
!any(x) is better than all(!x).	1
Avoid duplicate arguments in function calls.	4
Avoid undesirable function "require".	5
Avoid undesirable operator <<-.	2
Lines should not be more than 80 characters.	87
Pass pluck_chr directly as a symbol to map_chr() instead of wrapping it in an unnecessary anonymous function.	2
Replace unnecessary c() by NULL or, whenever possible, vector() seeded with the correct type and/or length.	1
toString(.) is more expressive than paste(., collapse = ", ").	4
Use "-" with fixed = TRUE here.	2
Use "," with fixed = TRUE here.	4
Use "/" with fixed = TRUE here.	1
Use "	" with fixed = TRUE here.
Use "5434" with fixed = TRUE here.	1
Use "CD" with fixed = TRUE here.	1
Use "Fake aggregate" with fixed = TRUE here.	1
Use "Produto das lavouras" with fixed = TRUE here.	1
Use "SIDRA Query" with fixed = TRUE here.	1
Use expect_identical(x, y) by default; resort to expect_equal() only when needed, e.g.	105

Other goodpractice checks

✖️ Avoid duplicated @param documentation across functions

---

Package Versions

package	version
pkgstats	0.2.3.2
pkgcheck	0.1.3.6

---

Editor-in-Chief Instructions:

This package is in top shape and may be passed on to a handling editor.

This package has some noteworthy properties, see 'Package Statistics' details above.