Skip to contents

Cache status of sourcoise

Source: R/sourcoise_status.R
sourcoise_status.Rd

Given the current project, soucoise_status() collects all information about cache (could be project level, file level) and return a tibble with this data.

Usage

sourcoise_status(short = TRUE, quiet = TRUE, root = NULL, prune = TRUE)

Arguments

short

(boolean) (deafault TRUE) return a simplified tibble

quiet

(boolean) (default TRUE) no messages during execution

root

(string) (default NULL) force root to a defined path, advanced and not recommanded use

prune

(boolean) (default TRUE) clean up status to display only on relevant cache. However, does not clean other cache files.

Value

tibble of cached files (see details for structure)

Details

sourcoise_status() reflects what is on the disk (and results indeed from a scan of all cached files and their metadatas). So modifying the result of sourcoise_status() can produce complex bugs when it is passed to sourcoise_refresh() or sourcoise_clean().

Data returned is:

  • src: path to the source file (r script)

  • date: last execution date

  • valid: is cache valid ?

  • uid: id of user

  • index: index of cache

  • timing: last execution timing

  • size: size of the R object(s) returned

  • lapse: periodic refresh trigger

  • wd: wd setting for execution of r script

  • args: arguments passed to R script

  • json_file: path to the file keeping cache information

  • qmd_file: list of path to qmd files calling this script (relevant only for quarto projects)

  • src_in: localisation of cache option

  • data_file: path to data cached

  • data_date: date and time of last save of data

  • log_file: path to log file, if logging activated

  • root: path to the project root, used as reference for all paths

  • scr_hash: hash of the source file

  • track_hash: hash of the tracked files, if any

  • track: list of files tracked

  • args_hash: hash of arguments

  • data_hash: hash of data cached

See also

Other sourcoise: sourcoise(), sourcoise_clear(), sourcoise_clear_all(), sourcoise_refresh(), sourcoise_reset()

Examples

dir <- tempdir()
set_sourcoise_root(dir)
fs::file_copy(
    fs::path_package("sourcoise", "some_data.R"),
    dir,
    overwrite = TRUE)
# Force execution
data <- sourcoise("some_data.R", force_exec = TRUE)
# status returns the cache status
sourcoise_status()
#> # A tibble: 1 × 7
#>   valid priority src         last_exec last_update   file_size json_file        
#>   <lgl>    <int> <chr>       <chr>     <chr>       <fs::bytes> <chr>            
#> 1 TRUE        10 some_data.R 0s        0s                  242 .sourcoise/some_…