R/caching.R

Defines functions print.ccafs_cache_info getsize file_info_ cc_cache_details cc_cache_delete_all cc_cache_delete cc_cache_list

Documented in cc_cache_delete cc_cache_delete_all cc_cache_details cc_cache_list

#' Manage cached CCAFS files
#'
#' @export
#' @name cc_cache
#' @param files (character) one or more complete file names
#' @param force (logical) Should files be force deleted? Default: `TRUE`
#'
#' @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 [rappdirs::user_cache_dir()], find your
#' cache folder by executing `rappdirs::user_cache_dir("ccafs")`
#'
#' @section Functions:
#'
#' - `cc_cache_list()` returns a character vector of full path file
#'  names
#' - `cc_cache_delete()` deletes one or more files, returns nothing
#' - `cc_cache_delete_all()` delete all files, returns nothing
#' - `cc_cache_details()` prints file name and file size for each
#'  file, supply with one or more files, or no files (and get details for
#'  all available)
#'
#' @examples \dontrun{
#' # list files in cache
#' cc_cache_list()
#'
#' # List info for single files
#' cc_cache_details(files = cc_cache_list()[1])
#' cc_cache_details(files = cc_cache_list()[2])
#'
#' # List info for all files
#' cc_cache_details()
#'
#' # delete files by name in cache
#' # cc_cache_delete(files = cc_cache_list()[1])
#'
#' # delete all files in cache
#' # cc_cache_delete_all()
#' }

#' @export
#' @rdname cc_cache
cc_cache_list <- function() {
  list.files(cc_cache_path(), ignore.case = TRUE, include.dirs = TRUE,
             recursive = TRUE, full.names = TRUE)
}

#' @export
#' @rdname cc_cache
cc_cache_delete <- function(files, force = TRUE) {
  if (!all(file.exists(files))) {
    stop("These files don't exist or can't be found: \n",
         strwrap(files[!file.exists(files)], indent = 5), call. = FALSE)
  }
  unlink(files, force = force, recursive = TRUE)
}

#' @export
#' @rdname cc_cache
cc_cache_delete_all <- function(force = TRUE) {
  files <- list.files(cc_cache_path(), ignore.case = TRUE, include.dirs = TRUE,
                      full.names = TRUE, recursive = TRUE)
  unlink(files, force = force, recursive = TRUE)
}

#' @export
#' @rdname cc_cache
cc_cache_details <- function(files = NULL) {
  if (is.null(files)) {
    files <- list.files(cc_cache_path(), ignore.case = TRUE, include.dirs = TRUE,
                        full.names = TRUE, recursive = TRUE)
    structure(lapply(files, file_info_), class = "ccafs_cache_info")
  } else {
    structure(lapply(files, file_info_), class = "ccafs_cache_info")
  }
}

file_info_ <- function(x) {
  if (file.exists(x)) {
    fs <- file.size(x)
  } else {
    fs <- type <- NA
    x <- paste0(x, " - does not exist")
  }
  list(file = x,
       type = "tif",
       size = if (!is.na(fs)) getsize(fs) else NA
  )
}

getsize <- function(x) {
  round(x/10 ^ 6, 3)
}

#' @export
print.ccafs_cache_info <- function(x, ...) {
  cat("<ccafs cached files>", sep = "\n")
  cat(sprintf("  directory: %s\n", cc_cache_path()), sep = "\n")
  for (i in seq_along(x)) {
    cat(paste0("  file: ", sub(cc_cache_path(), "", x[[i]]$file)), sep = "\n")
    cat(paste0("  size: ", x[[i]]$size, if (is.na(x[[i]]$size)) "" else " mb"),
        sep = "\n")
    cat("\n")
  }
}
ropensci/ccafs documentation built on May 18, 2022, 9:49 a.m.