Skip to contents

A storage cache for pegboard::Lesson objects and other pre-computed items for use by other internal functions while sandpaper is working.

Usage

this_lesson(path)

clear_this_lesson()

set_this_lesson(path)

set_resource_list(path)

clear_resource_list(path)

Arguments

path

a path to the current lesson

Lesson Object Storage

this_lesson() will return a pegboard::Lesson object if it has previously been stored. There are three values that are cached:

The function this_lesson() first checks if .this_diff is different than the output of gert::git_diff_patch(), then checks if there are any changes to gert::git_status(), and then finally checks if the commits are identical. If there are differences or the values are not previously cached, the lesson is loaded into memory, otherwise, it is fetched from the previously stored lesson.

The storage cache is in a global package object called .store, which is initialised when sandpaper is loaded via .lesson_store()

If there have been no changes git is aware of, the lesson remains the same.

Pre-Computed Object Storage

A side-effect of this_lesson() is that it will also initialise pre-computed objects that pertain to the lesson itself. These are initialised via set_globals(). These storage objects are:

  • .resources: a list of markdown resources for the lesson derived from get_resource_list() via set_resource_list()

  • this_metadata: metadata with template for including in the pages. initialised in initialise_metadata() via set_globals()

  • learner_globals: variables for the learner version of the pages initialised in set_globals()

  • instructor_globals: variables for the instructor version of the pages initialised in set_globals()

Examples

tmp <- tempfile()
create_lesson(tmp, open = FALSE, rmd = FALSE)
#> → Creating Lesson in /tmp/RtmpYTv6Az/file1725486dfa7a...
#>  No schedule set, using Rmd files in episodes/ directory.
#> → Creating Lesson in /tmp/RtmpYTv6Az/file1725486dfa7a...

#> To remove this message, define your schedule in config.yaml or use `set_episodes()` to generate it.
#> → Creating Lesson in /tmp/RtmpYTv6Az/file1725486dfa7a...

#> ────────────────────────────────────────────────────────────────────────
#> → Creating Lesson in /tmp/RtmpYTv6Az/file1725486dfa7a...

#>  To save this configuration, use
#> 
#> set_episodes(path = path, order = ep, write = TRUE)
#> → Creating Lesson in /tmp/RtmpYTv6Az/file1725486dfa7a...

#>  Edit /tmp/RtmpYTv6Az/file1725486dfa7a/episodes/introduction.md.
#> → Creating Lesson in /tmp/RtmpYTv6Az/file1725486dfa7a...

#>  First episode created in /tmp/RtmpYTv6Az/file1725486dfa7a/episodes/introduction.md
#> → Creating Lesson in /tmp/RtmpYTv6Az/file1725486dfa7a...

#>  Workflows up-to-date!
#> → Creating Lesson in /tmp/RtmpYTv6Az/file1725486dfa7a...

#>  Lesson successfully created in /tmp/RtmpYTv6Az/file1725486dfa7a
#> → Creating Lesson in /tmp/RtmpYTv6Az/file1725486dfa7a...

#> /tmp/RtmpYTv6Az/file1725486dfa7a
# Read the lesson into cache
system.time(sandpaper:::this_lesson(tmp))
#>    user  system elapsed 
#>   0.120   0.005   0.125 
system.time(sandpaper:::this_lesson(tmp)) # less time to read in once cached
#>    user  system elapsed 
#>   0.002   0.001   0.004 
l <- sandpaper:::this_lesson(tmp)
l
#> <Lesson>
#>   Public:
#>     blocks: function (type = NULL, level = 0, path = FALSE) 
#>     built: NULL
#>     challenges: function (path = FALSE, graph = FALSE, recurse = TRUE) 
#>     children: NULL
#>     clone: function (deep = FALSE) 
#>     episodes: list
#>     extra: list
#>     files: active binding
#>     get: function (element = NULL, collection = "episodes") 
#>     handout: function (path = NULL, solution = FALSE) 
#>     has_children: active binding
#>     initialize: function (path = ".", rmd = FALSE, jekyll = TRUE, ...) 
#>     isolate_blocks: function () 
#>     load_built: function () 
#>     n_problems: active binding
#>     overview: FALSE
#>     path: /tmp/RtmpYTv6Az/file1725486dfa7a
#>     reset: function () 
#>     rmd: FALSE
#>     sandpaper: TRUE
#>     show_problems: active binding
#>     solutions: function (path = FALSE) 
#>     summary: function (collection = "episodes") 
#>     thin: function (verbose = TRUE) 
#>     trace_lineage: function (episode_path) 
#>     validate_divs: function () 
#>     validate_headings: function (verbose = TRUE) 
#>     validate_links: function () 
#>   Private:
#>     deep_clone: function (name, value) 
# clear the cache
sandpaper:::clear_this_lesson()
system.time(sandpaper:::this_lesson(tmp)) # have to re-read the lesson
#>    user  system elapsed 
#>   0.124   0.002   0.126 
system.time(sandpaper:::this_lesson(tmp))
#>    user  system elapsed 
#>   0.002   0.002   0.004 
unlink(tmp)