R/cached_get.R

In fozy81/NBN4R: National Biodiversity Network Atlas (UK and Ireland) Data and Resources in R

# HTTP GET with caching
#
# Convenience wrapper for web GET operations. Caching, setting the user-agent string, and basic checking of the result are handled.
#
# @param url string: the url of the page to retrieve
# @param type string: the expected content type. Either "text" (default), "json", or "filename" (this caches the content directly to a file and returns the filename without attempting to read it in)
# @param caching string: caching behaviour, by default from nbn_config()$caching
# @param on_redirect, on_server_error, on_client_error function: passed to check_status_code()
# @return for type=="text" the content is returned as text. For type=="json", the content is parsed using jsonlite::fromJSON. For "filename", the name of the stored file is returned.
# @details Depending on the value of caching, the page is either retrieved from the cache or from the url, and stored in the cache if appropriate. The user-agent string is set according to nbn_config()$user_agent. The returned response (if not from cached file) is also passed to check_status_code().
# @references \url{https://api.nbnatlas.org/}
# @examples
#
# out = cached_get(url="https://records-ws.nbnatlas.org/index/fields",type="json")
#
cached_get <- function(url,type="text",caching=nbn_config()$caching,verbose=nbn_config()$verbose,on_redirect=NULL,on_client_error=NULL,on_server_error=NULL,encoding=nbn_config()$text_encoding) {
  
  ALA4R:::cached_get(url,type,caching,verbose,on_redirect,on_client_error,on_server_error,encoding)
  
}