Download and verify the necessary archive snapshots

Selects the newest available snapshots that cover the requested months. Forces are recorded as extraction filters; the source only offers full ZIPs. Checks publisher MD5 before recording local SHA-256. Existing files must match both the publisher and any recorded SHA-256; corrupt files are never replaced silently. The manifest and ZIPs are written to dir.

Usage

sl_archive_download(months, forces = NULL, dir = sl_cache_dir(), index = NULL)

Arguments

months

Character vector of YYYY-MM months.

forces

Force identifiers, or NULL for all forces.

dir

Cache directory.

index

Optional previously retrieved archive index.

Value

Manifest tibble, or NULL when a resource is unavailable.

See also

sl_archive_snapshot(), sl_list_versions()

Other ingest: sl_archive_index(), sl_archive_snapshot(), sl_assign_geography(), sl_boundaries(), sl_cache_clear(), sl_cache_dir(), sl_contract(), sl_exposure(), sl_list_versions(), sl_population(), sl_population_crosstab(), sl_read_records(), sl_sample(), sl_select_version()

Examples

index <- readRDS(system.file("extdata", "archive-index.rds",
  package = "searchlight"
))
index$archive_file[1]
#> [1] "2026-07.zip"