s3 (version 1.1.0)

s3_get_files: download several s3 files

Description

Progress messages for downloading several S3 objects at once cannot be silenced. Like s3_get, S3 objects that have already been downloaded will not be re downloaded

Usage

s3_get_files(
  s3_uri,
  region = "us-east-2",
  progress = FALSE,
  force = FALSE,
  confirm = TRUE,
  public = FALSE,
  data_dir = tools::R_user_dir("s3", "data")
)

Value

data.frame (or tibble) with s3_uris and corresponding file paths to downloaded files (invisibly)

Arguments

s3_uri

vector of S3 object URIs

region

AWS region for bucket containing the file (defaults to "us-east-2", but only required for private files)

progress

show download progress for each individual file? (currently only for public objects)

force

force download to overwrite existing S3 objects

confirm

ask user to interactively confirm downloads? (only possible when session is interactive)

public

defaults to FALSE; if TRUE, ignore any environment variables specifying AWS credentials and attempt to download the file as publicly available

data_dir

root directory for downloaded files (defaults to tools::R_user_dir("s3", "data"))

Examples

# \donttest{
Sys.setenv("R_USER_DATA_DIR" = tempdir())
the_files <- s3_get_files(c(
    "s3://geomarker/testing_downloads/mtcars.rds",
    "s3://geomarker/testing_downloads/mtcars.fst"
))
unlink(the_files$file_path)
# }