R Observatory: Metrics for cagedr version 0.1.0

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

cagedr

0.1.0Package record

Access Novo CAGED Microdata from the Brazilian Ministry of Labour

0packages depend

445downloads / year

86.5%test coverage

13/13flavors OK

Overview

About

Maintained by Andre LeiteCRAN page ↗GitHub ↗Website ↗Issues ↗

Download and read the public, non-identified microdata of the Novo CAGED (Cadastro Geral de Empregados e Desempregados), the monthly registry of formal employment movements published by the Brazilian Ministry of Labour and Employment through the PDET FTP server <ftp://ftp.mtps.gov.br/pdet/microdados/>. Lists the reference months available on the server, downloads the three monthly files (movements declared on time, declared late, and exclusions) with an idempotent local cache, and reads the national 7z archives as a stream, filtering by state and selecting columns before anything is kept in memory, so that a single state can be extracted without loading the full national file. Also provides the official record layout and a helper to consolidate admissions, separations and net balance by reference month.

Changes in 0.1.0

Initial release.

caged_available() lists the reference months published on the PDET/MTE FTP server, with folder modification dates.
caged_download() fetches the MOV, FOR and EXC archives of one or more months into an idempotent local cache (caged_cache_dir(), caged_cache_list(), caged_cache_clear()).
caged_read() stream-reads a national .7z archive, filtering by state and selecting columns chunk by chunk, with normalised column names and typed codes; caged_fetch() combines download and read for several months.
caged_balance() consolidates admissions, separations and net balance by competenciamov, inverting the sign of exclusion records.
caged_layout() documents the 30 columns of the official record layout.

Show all changes in 0.1.0Hide the rest of the changes in 0.1.0

Sample archives in inst/extdata allow every reading function to be tried offline.

From NEWS.md in the release

Install

R (CRAN)pak (dev)Fedora (COPR)

install.packages("cagedr", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("StrategicProjects/cagedr")

Development version from StrategicProjects/cagedr. Installs pak first if it is not already available.

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-cagedr

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

Health

CRAN checks

13OK

CRAN check page ↗

Slowest check: 2.2 min · r-oldrel-macos-x86_64

Status changes

OK13 OKNow
OK5 OK2026-10-01

Advisories

none known

How this is measured·How advisories are found

Documentation

In release 0.1.0

READMEYes · 542 wordsVignettesYes · 2 · dynamicNEWSYes · 67% structured · mentions 0.1.0Citation fileNoWebsiteYes · pkgdown

Help pages: 11 (1 internal)includes a package overview page
Examples that run: 70%7 run in a plain check · 3 only when donttest examples are enabled (R CMD check --as-cran)
Exported functions with examples: 100%
Documented parameters: 89%
Return-value docs: 100%
Help pages citing references: 0%

Vignettes (2)

Getting started with cagedr HTML
Streaming, cache and data vintages HTML

How these are measured

Downloads

445

CRAN downloads in the past year

Rank #25,013 · ~1/day · ~37/mo

cagedr Releases R versions

Daily download trend is not available in this view yet.

44530 days

44590 days

4451 year

Compare downloads with other packages →

How downloads are counted

Repository

strategicprojects/cagedr ↗Organization: StrategicProjects

0Stars

0Forks

0Open issues

0Open PRs

0Releases

Last activity 2026-09-29

Responsiveness

not measured

How these are measured

PracticesBeta

9 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/strategicprojects/cagedr on 2026-10-25.

Continuous integration (2)

GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Docs source (3)

pkgdown

GitHub Pages site last deployed 2026-09-29 · The repository has a site deploy workflow

pkgdown site last built 2026-09-29, before release 0.1.0 (2026-09-30)

Reproducibility and dev environment (1)

data-raw/

CRAN release process (2)

cran-comments.mdCRAN-SUBMISSION

Show all practicesHide 1 practice

Lint, format, editor (1)

RStudio project

How this is detected·Detection ruleset v4 (2026-10-20)

AI coding toolsBeta

This repository shows signs of AI coding tools.

Claude Codefirst seen 2026-09-11
Named in .Rbuildignore: CLAUDE.md
Named in .gitignore: .claude, CLAUDE.md
Commits: at least 10 crediting it in the message

Models named in its commits

Claude Fable 5.18 commits · Sep 2026
Claude Opus 5.52 commits · Sep 2026

Counts are commits, not lines of code. Commits by a tool's accounts count once across all of its accounts. Commits crediting it are the largest count among its credit lines, a minimum.How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies

12 external dependencies (excludes base and recommended)

Installing cagedr adds 27 packages (16 with compiled code, 19 MB of source tarballs). Heaviest: stringi 11 MB, vctrs 1.0 MB, rlang 766 KB.

Depends (1)

R >= 4.1.0

Imports (7)

archive cli curl readr (>= 2.1.0)rlang stringi tibble

LinkingTo (0)

none

Suggests (5)

dplyr knitr rmarkdown testthat withr

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

How these are counted

Code & Tests

People & History

People (6)

Andre Leite

Author, Maintainer since 0.1.0 (2026)

Carlos Amorim

Author

Diogo Bezerra

Author

Júlia Nascimento Barreto

Author

Hugo Vasconcelos

Author

Marcos Wasiliew

Author

Releases (1)

0.1.0Latest
record
2026-09-30 · current release
R
R 4.6.0 released · 2026-04-24

Package metadata

First published: 2026-09-30
Total releases: 1 / 1 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 4.1.0
Download size: 43 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("cagedr")

Format

Leite, A., Amorim, C., Bezerra, D., Nascimento Barreto, J., Vasconcelos, H., & Wasiliew, M. (2026). cagedr: Access Novo CAGED Microdata from the Brazilian Ministry of Labour (Version 0.1.0) [Computer software]. https://doi.org/10.32614/CRAN.package.cagedr

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

Format

APA

Balamuta, J. J. (2026). R Observatory: Metrics for cagedr version 0.1.0 [Data set]. HJJB, LLC. Data release v2026-10-26. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-26, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →