Skip to contents

Manage cached datasets

Source: R/data_cache.R
hockeystick_cache.Rd

Manage cached datasets

Usage

hockeystick_cache_list()

hockeystick_cache_delete(files, force = TRUE)

hockeystick_cache_delete_all(force = TRUE)

hockeystick_cache_details(files = NULL)

hockeystick_update_all()

Arguments

files

(character) one or more complete file names

force

(logical) Should files be force deleted? Default: TRUE

Value

hockeystick_cache_list() returns a character vector of full path filenames in cache.

hockeystick_cache_delete() no return value, called for side effect.

hockeystick_cache_delete_all() no return value, called for side effect.

hockeystick_cache_details() returns list of filenames and sizes of cached files.

hockeystick_update_all() updates all datasets and caches them. No return value, called for side effect.

Details

cache_delete only accepts 1 file name, while cache_delete_all doesn't accept any names, but deletes all files. For deleting many specific files, use cache_delete in a lapply() type call

We cache using tools::R_user_dir(), find your cache folder by executing tools::R_user_dir("hockeystick","cache")

Functions

  • hockeystick_cache_list() returns a character vector of full path file names in cache

  • hockeystick_cache_delete() deletes one or more files, returns nothing

  • hockeystick_cache_delete_all() delete all files, returns nothing

  • hockeystick_cache_details() prints file name and file size of each file, supply with one or more files, or no files (and get details for all available)

  • hockeystick_update_all() updates the cache with the latest co2, temperature, sea level, and sea ice data.

References

Caching data sets: ROpenSci guide to persistent config and data for R packages: https://blog.r-hub.io/2020/03/12/user-preferences/

Examples

# \donttest{
# list files in cache
hockeystick_cache_list()
#> character(0)

# List info for single files
hockeystick_cache_details(files = hockeystick_cache_list()[1])
#> <hockeystick cached files>
#>   directory: /home/runner/.cache/R/hockeystick
#> 
#>   file: NA
#>   size: NA kB
#>   date: NA
#> 
hockeystick_cache_details(files = hockeystick_cache_list()[2])
#> <hockeystick cached files>
#>   directory: /home/runner/.cache/R/hockeystick
#> 
#>   file: NA
#>   size: NA kB
#>   date: NA
#> 

# List info for all files
hockeystick_cache_details()
#> <hockeystick cached files>
#>   directory: /home/runner/.cache/R/hockeystick
#> 

# Delete cached files by name
hockeystick_cache_delete(files = hockeystick_cache_list()[1])
#> These files don't exist or can't be found: 
#>      NAFALSE

# Update all hockeystick data and place in cache
hockeystick_update_all()
#> Retrieving remote data requires internet connectivity.
#> Retrieving remote data requires internet connectivity.

# Delete all cached data
hockeystick_cache_delete_all()
# }