subincomeR 0.6.0
CRAN compliance
- All exported functions now fail gracefully when an internet resource
is unavailable, per CRAN policy:
getDOSE(),
getDOSE_geom() and matchDOSE() return
NULL invisibly with an informative message instead of
throwing an error when there is no internet connection, a download
fails, or a downloaded file is corrupt. stop() is still
used for invalid user input.
- The
regional-convergence vignette is now precomputed
(source in vignettes/regional-convergence.Rmd.orig,
regenerated with dev/precompute-vignettes.R), so no
network-dependent code runs at R CMD check time.
New features
- New
cache = TRUE argument in getDOSE(),
getDOSE_geom() and matchDOSE(): opt-in
persistent storage of downloaded data in
tools::R_user_dir("subincomeR", "cache"), so the data (up
to ~769 MB for the geometries) is reused across R sessions instead of
being re-downloaded every session. The default behavior (storage in
tempdir()) is unchanged.
- New helpers
subincomeR_cache_dir() and
subincomeR_cache_clear() to locate and delete the
persistent cache.
Other improvements
- The testthat suite now runs during
R CMD check (the
tests/testthat.R runner was missing), with new network-free
tests covering the offline and failed-download paths via mocked
connectivity.
- More robust downloads: the
download.file() fallback now
checks its return status, partial or corrupt downloads are always
removed, the download timeout is raised to 600s, and the deprecated
wininet method was dropped.
matchDOSE() now validates all its arguments before any
network activity.
subincomeR 0.5.0
- Updated DOSE dataset to version 2.14 (Zenodo record 20035157)
- Replaced the magrittr pipe (
%>%) with the native R
pipe (|>) in package code, addressing the CRAN NOTE
flagged after sf stopped re-exporting %>%
(see r-spatial/sf#2607)
- Declared a minimum R version of 4.1.0 (required by the native
pipe)
subincomeR 0.4.0
- Updated DOSE dataset to version 2.11
subincomeR 0.3.0
- Updated DOSE dataset to version 2.10
subincomeR 0.2.2
- Removed writing to user’s home filespace by default (using tempdir()
instead)
- Added explicit path parameter throughout to allow users to specify
custom storage locations
- Added download confirmation for large files with option to skip in
non-interactive sessions
subincomeR 0.2.1
- Fixed minor style issues in DESCRIPTION file
subincomeR 0.2.0
- Added the
getDOSE_geom() function to explicitly
download the geometries of the sub-national regions
subincomeR 0.1.3
- Updated DOSE dataset to version 2.9
- Improved download handling to better manage corrupted downloads and
connection issues
subincomeR 0.1.2
- Added the option to specify the path where the
.gpkg
file with the sub-national geometries would be stored
subincomeR 0.1.1
- Added the option to pre-specify country identifiers in
matchDOSE() to skip the first step of the geocoding
process
subincomeR 0.1.0