drake (version 7.5.2)

progress: Get the build progress of your targets during a make().

Description

Objects that drake imported, built, or attempted to build are listed as "done" or "running". Skipped objects are not listed.

Usage

progress(..., list = character(0), no_imported_objects = NULL,
  path = NULL, search = NULL, cache = drake::drake_cache(path = path,
  verbose = verbose), verbose = 1L, jobs = 1, progress = NULL)

Arguments

...

Objects to load from the cache, as names (unquoted) or character strings (quoted). Similar to ... in remove() and rm().

list

Character vector naming objects to be loaded from the cache. Similar to the list argument of remove().

no_imported_objects

Logical, whether to only return information about imported files and targets with commands (i.e. whether to ignore imported objects that are not files).

path

Path to a drake cache (usually a hidden .drake/ folder) or NULL.

search

Deprecated.

cache

drake cache. See new_cache(). If supplied, path is ignored.

verbose

Integer, control printing to the console/terminal.

• 0: print nothing.

• 1: print targets, retries, and failures.

• 2: also show a spinner when preprocessing tasks are underway.

jobs

Number of jobs/workers for parallel processing.

progress

Character vector for filtering the build progress results. Defaults to NULL (no filtering) to report progress of all objects. Supported filters are "done", "running", "failed" and "none".

Value

The build progress of each target reached by the current make() so far.

See Also

diagnose(), drake_get_session_info(), cached(), readd(), drake_plan(), make()

Examples

# NOT RUN {
isolate_example("Quarantine side effects.", {
if (suppressWarnings(require("knitr"))) {
load_mtcars_example() # Get the code with drake_example("mtcars").
make(my_plan) # Run the project, build the targets.
# Watch the changing progress() as make() is running.
progress() # List all the targets reached so far.
progress(small, large) # Just see the progress of some targets.
progress(list = c("small", "large")) # Same as above.
progress(no_imported_objects = TRUE) # Ignore imported R objects.
}
})
# }