Download files from a taxonAlign data release
Source:R/data_release_helpers.R
download_data_release_files.RdDownloads (or finds already cached) any files from a data release – the ready datasets
load_taxonomic_resources() reads, or the verbatim source exports stored alongside them (e.g.
"nsl_fungi_taxon.parquet"), which taxonAlign.dataprep rebuilds references from. Most users
never need this directly. data_release_versions() lists the releases; each release's
manifest.csv lists its files.
Usage
download_data_release_files(
files,
version = NULL,
refresh_cache = FALSE,
cache_dir = tools::R_user_dir("taxonAlign", "cache"),
quiet = FALSE
)Arguments
- files
Character vector of file names in the release.
- version
Data release to load, a date (
"YYYY-MM-DD"); seedata_release_versions(). Defaults to the latest release, or, with no internet connection, the newest release already downloaded.- refresh_cache
Logical; if
TRUE, re-downloads the files even if they're cached. Defaults toFALSE.- cache_dir
Directory downloaded release files are cached in. Defaults to
tools::R_user_dir("taxonAlign", "cache").- quiet
Logical; suppress progress messages. Defaults to
FALSE.
Value
A named character vector of local file paths, one per file. Downloaded files are cached
under <cache_dir>/data_release/<version>/; if the latest release can't be downloaded, the newest
release already cached that has every file is used instead (never when version is given).
Examples
# \donttest{
# needs the internet: the release's manifest, into a temporary cache
if (curl::has_internet()) {
download_data_release_files("manifest.csv", version = "2026-11-14", cache_dir = tempfile())
}
#> Downloading manifest.csv (data release 2026-11-14)...
#> manifest.csv
#> "/tmp/RtmpwCYYHT/file19144669f772/data_release/2026-11-14/manifest.csv"
# }