The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
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[@]metanet.ch.

datasusr 0.1.0

CRAN review fixes

• DESCRIPTION now consistently single-quotes external software/API names (‘DATASUS’, ‘DBC’, ‘DBF’, ‘FTP’, ‘C’, ‘PKWare DCL’, ‘blast’, ‘zlib’) and unquotes the in-package function reference datasus_fetch(). The description field also now references the upstream sources (DATASUS file transfer site and Adler 2003 for the bundled blast decompressor).
• All examples switched from \dontrun{} to \donttest{}. Network- dependent examples are wrapped in tryCatch() and write to tempdir() so that running them never touches the user’s home filespace.
• The default cache directory is now a session-scoped subdirectory of tempdir() instead of tools::R_user_dir("datasusr", "cache"). To opt in to a persistent cache across sessions, set the DATASUSR_CACHE_DIR environment variable, the datasusr.cache_dir R option, or pass cache_dir explicitly.

Breaking changes

• Package version bumped to 0.1.0 to reflect the expanded scope beyond just reading DBC files.

New features

• datasus_fetch(): high-level convenience function that lists, downloads, and reads DATASUS files in a single call. Supports column selection, type specification, and row-binding of multiple files.
• DATASUSR_CACHE_DIR environment variable: the cache directory now respects the DATASUSR_CACHE_DIR env var in addition to the existing datasusr.cache_dir option.
• format_bytes() is now exported for general use.

Bug fixes

• Fixed SIM path templates: DOEXT, DOINF, and DOMAT previously pointed to the DOFET FTP directory. Each now has its own correct path.
• Fixed column/argument name shadowing in datasus_build_path(), datasus_file_types(), and datasus_list_files(). Column names like source and file_type no longer clash with function arguments thanks to proper use of .env$ pronouns.
• Download failures no longer abort the loop: individual FTP download errors are caught and reported without stopping the remaining downloads.
• Empty file lists now return immediately from datasus_download() instead of proceeding with zero iterations.

Improvements

• Removed all .data$ pronoun usage inside dplyr verbs. Columns are now referenced with bare (tidy evaluation) names, and external variables use .env$ where needed. This follows current tidyverse best practice.
• Replaced deprecated purrr functions: pmap_dfr() replaced with map2() |> list_rbind().
• Replaced purrr::map_lgl() in cache functions with base vapply() for fewer dependencies in hot paths.
• Improved CLI messages throughout: all user-facing messages now use cli::cli_abort() with structured hints (i bullets) instead of bare stop(). Progress messages are more concise and informative.
• Wrapped FTP connection errors with a user-friendly message suggesting a connectivity check.
• rlang is now an explicit dependency (was already an indirect dep via dplyr), making the %||% import explicit.
• Added rlang (>= 1.0.0) and dplyr (>= 1.1.0) minimum version constraints.
• Vignettes expanded with richer explanations and a new comparison article.
• pkgdown site structure updated with a comparison article.
• Compiled .o and .so files excluded from the source bundle via .Rbuildignore.

datasusr 0.0.7.3

• Fixed dplyr data-masking bugs in catalog and file listing helpers.
• Removed .data$ usage inside mutate pipelines and simplified tidyverse expressions.
• Improved verbose output in read_datasus_dbc() so row and column counts print on separate lines.

datasusr 0.0.7.1

• Fixed datasus_file_types(source = ...) filtering consistency.
• Improved cli spacing and summary formatting in key functions.
• Filtered invalid source/file type combinations earlier in datasus_list_files().

datasusr 0.0.7

• Standardized user-facing progress and status messages with cli.
• Added progress bars and cache-hit messages to datasus_download().
• Added optional verbose control to FTP, listing, and cache helpers.
• Improved cache summaries with human-readable sizes.

datasusr 0.0.6

• Added a configurable cache layer for DATASUS downloads.
• Added datasus_cache_dir(), datasus_cache_list(), datasus_cache_info(), datasus_cache_clear(), and datasus_cache_prune().
• Integrated cache-aware downloads into datasus_download().

datasusr 0.0.5

• Added DATASUS catalog helpers: datasus_sources(), datasus_modalities(), datasus_file_types(), and datasus_ufs().
• Added FTP helpers: datasus_ftp_ls(), datasus_build_path(), datasus_list_files(), and datasus_download().

datasusr 0.0.4

• Added guess_types, col_types, and parse_dates to read_datasus_dbc().
• Improved DBC handling for files with DBF headers plus compressed record areas.

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.