drake (version 6.2.1)

outdated: List the targets that are out of date.

Description

Outdated targets will be rebuilt in the next make().

Usage

outdated(config = drake::read_drake_config(), make_imports = TRUE,
  do_prework = TRUE)

Arguments

config

option internal runtime parameter list produced with drake_config(). You must use a fresh config argument with an up-to-date config$targets element that was never modified by hand. If needed, rerun drake_config() early and often. See the details in the help file for drake_config().

make_imports

logical, whether to make the imports first. Set to FALSE to save some time and risk obsolete output.

do_prework,

whether to do the prework normally supplied to make().

Value

Character vector of the names of outdated targets.

Details

outdated() is sensitive to the alternative triggers described at https://ropenscilabs.github.io/drake-manual/debug.html. For example, even if outdated(...) shows everything up to date, outdated(..., trigger = "always") will show all targets out of date. You must use a fresh config argument with an up-to-date config$targets element that was never modified by hand. If needed, rerun drake_config() early and often. See the details in the help file for drake_config().

See Also

drake_config(), missed(), drake_plan(), make()

Examples

# NOT RUN {
test_with_dir("Quarantine side effects.", {
load_mtcars_example() # Get the code with drake_example("mtcars").
# Recopute the config list early and often to have the
# most current information. Do not modify the config list by hand.
config <- drake_config(my_plan)
outdated(config = config) # Which targets are out of date?
config <- make(my_plan) # Run the projects, build the targets.
# Now, everything should be up to date (no targets listed).
outdated(config = config)
# outdated() is sensitive to triggers.
# See the debugging guide: https://ropenscilabs.github.io/drake-manual/debug.html # nolint
config$trigger <- "always"
outdated(config = config)
})
# }