/
run-examples.r
76 lines (67 loc) · 2.73 KB
/
run-examples.r
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
#' Run all examples in a package.
#'
#' One of the most frustrating parts of `R CMD check` is getting all of your
#' examples to pass - whenever one fails you need to fix the problem and then
#' restart the whole process. This function makes it a little easier by
#' making it possible to run all examples from an R function.
#'
#' @param pkg package description, can be path or package name. See
#' \code{\link{as.package}} for more information
#' @param start Where to start running the examples: this can either be the
#' name of \code{Rd} file to start with (with or without extensions), or
#' a topic name. If omitted, will start with the (lexicographically) first
#' file. This is useful if you have a lot of examples and don't want to
#' rerun them every time you fix a problem.
#' @family example functions
#' @param show if \code{TRUE}, code in \code{\\dontshow{}} will be commented
#' out
#' @param test if \code{TRUE}, code in \code{\\donttest{}} will be commented
#' out. If \code{FALSE}, code in \code{\\testonly{}} will be commented out.
#' @param run if \code{TRUE}, code in \code{\\dontrun{}} will be commented
#' out.
#' @param fresh if \code{TRUE}, will be run in a fresh R session. This has
#' the advantage that there's no way the examples can depend on anything in
#' the current session, but interactive code (like \code{\link{browser}})
#' won't work.
#' @keywords programming
#' @export
run_examples <- function(pkg = ".", start = NULL, show = TRUE, test = FALSE,
run = TRUE, fresh = FALSE) {
pkg <- as.package(pkg)
document(pkg)
files <- rd_files(pkg)
if (!is.null(start)) {
start_path <- find_pkg_topic(pkg, start)
if (is.null(start_path)) {
stop("Couldn't find start position ", start, call. = FALSE)
}
start_pos <- which(names(files) == start_path)
if (length(start_pos) == 1) {
files <- files[- seq(1, start_pos - 1)]
}
}
if (length(files) == 0) return()
rule("Running ", length(files), " example files in ", pkg$package)
if (fresh) {
to_run <- substitute(devtools::run_examples(path), list(path = pkg$path))
eval_clean(to_run)
} else {
load_all(pkg, reset = TRUE, export_all = FALSE)
on.exit(load_all(pkg, reset = TRUE))
lapply(files, run_example, show = show, test = test, run = run)
}
invisible()
}
# If an error occurs, should print out the suspect line of code, and offer
# the following options:
# * skip to the next example
# * quit
# * browser
# * rerun example and rerun
# * reload code and rerun
rd_files <- function(pkg) {
path_man <- file.path(pkg$path, "man")
files <- dir(path_man, pattern = "\\.[Rr]d$", full.names = TRUE)
names(files) <- basename(files)
withr::with_collate("C", sort(files))
}