targets (version 0.0.0.9000)

tar_prune: Remove targets that are no longer part of the pipeline.

Description

Remove target values from _targets/objects/ and target metadata from _targets/meta/meta for targets that are no longer part of the pipeline. Global objects and dynamic files outside the data store are unaffected. Also removes _targets/scratch/, which is only needed while tar_make(), tar_make_clustermq(), or tar_make_future() is running.

Usage

tar_prune(callr_function = callr::r, callr_arguments = list())

Arguments

callr_function

A function from callr to start a fresh clean R process to do the work. Set to NULL to run in the current session instead of an external process (but restart your R session just before you do in order to clear debris out of the global environment). callr_function needs to be NULL for interactive debugging, e.g. tar_option_set(debug = "your_target"). However, callr_function should not be NULL for serious reproducible work.

callr_arguments

A list of arguments to callr_function.

Value

NULL except if callr_function = callr::r_bg(), in which case a handle to the callr background process is returned. Either way, the value is invisibly returned.

Examples

# NOT RUN {
tar_dir({
tar_script(
  tar_pipeline(
    tar_target(y1, 1 + 1),
    tar_target(y2, 1 + 1),
    tar_target(z, y1 + y2)
  )
)
tar_make()
# Remove some targets from the pipeline.
tar_script(tar_pipeline(tar_target(y1, 1 + 1)))
# Keep only the remaining targets in the data store.
tar_prune()
})
# }