Check Source Packages and Their Reverse Dependencies
Check source packages in a given directory, optionally with their reverse dependencies.
check_packages_in_dir(dir, check_args = character(), check_args_db = list(), reverse = NULL, check_env = character(), xvfb = FALSE, Ncpus = getOption("Ncpus", 1L), clean = TRUE, ...)
summarize_check_packages_in_dir_results(dir, all = TRUE, full = FALSE) summarize_check_packages_in_dir_timings(dir, all = FALSE, full = FALSE) summarize_check_packages_in_dir_depends(dir, all = FALSE, which = c("Depends", "Imports", "LinkingTo"))
check_packages_in_dir_changes(dir, old, outputs = FALSE, sources = FALSE)
- a character string giving the path to the directory with
.tar.gzfiles to be checked.
- a character vector with arguments to be passed to
R CMD check, or a list of length two of such character vectors to be used for checking packages and reverse dependencies, respectively.
- a named list of character vectors with arguments
to be passed to
R CMD check, with names the respective package names.
- a list with names partially matching
"recursive", giving the repositories to use for locating reverse dependencies (default:
getOption("repos")), the types of reverse dependencies (default:
c("Depends", "Imports", "LinkingTo"), with shorthands
package_dependencies), and indicating whether to also check reverse dependencies of reverse dependencies and so on (default:
NULL(default), in which case no reverse dependencies are checked.
- a character vector of name=value strings to set environment variables for checking, or a list of length two of such character vectors to be used for checking packages and reverse dependencies, respectively.
- a logical indicating whether to perform checking inside a virtual framebuffer X server (Unix only), or a character vector of Xvfb options for doing so.
- the number of parallel processes to use for parallel installation and checking.
- a logical indicating whether to remove the downloaded reverse dependency sources.
- currently not used.
- a logical indicating whether to also summarize the reverse dependencies checked.
- a logical indicating whether to also give details for checks with non-ok results, or summarize check example timings (if available).
- a character string giving the path to the directory of a
- a logical indicating whether to analyze changes in the outputs of the checks performed, or only (default) the status of the checks.
- a logical indicating whether to also investigate the
changes in the source files checked (default:
check_packages_in_dir allows to conveniently check source
.tar.gz files in the given directory
with their reverse dependencies as controlled by
"which" component of
reverse can also be a list, in
which case reverse dependencies are obtained for each element of the
list and the corresponding element of the
reverse (which is recycled as needed). If needed, the source
.tar.gz files of the reverse dependencies
to be checked as well are downloaded into
dir (and removed at
the end if
clean is true). Next, all packages (additionally)
needed for checking are installed to the
dir. Then, all
.tar.gz files are checked using the
given arguments and environment variables, with outputs and messages
to files in the
Outputs subdirectory of
*.Rcheck directories with the check results of the reverse
dependencies are renamed by prefixing their base names with
rdepends_. Results and timings can conveniently be summarized using
summarize_check_packages_in_dir_timings, respectively. Installation and checking is performed in parallel if
greater than one: this will use
parLapply on Windows.
check_packages_in_dir returns an object inheriting from class
"check_packages_in_dir" which has
check_packages_in_dir_changes allows to analyze the effect of
changing (some of) the sources. With
paths to the directories with the new and old sources, respectively,
and the corresponding check results, possible changes in the check
results can conveniently be analyzed as controlled via options
This functionality is still experimental: interfaces may change in future versions.
## Not run: ------------------------------------ # ## Check packages in dir without reverse dependencies: # check_packages_in_dir(dir) # ## Check packages in dir and their reverse dependencies using the # ## defaults (all repositories in getOption("repos"), all "strong" # ## reverse dependencies, no recursive reverse dependencies): # check_packages_in_dir(dir, reverse = list()) # ## Check packages in dir with their reverse dependencies from CRAN, # ## using all strong reverse dependencies and reverse suggests: # check_packages_in_dir(dir, # reverse = list(repos = getOption("repos")["CRAN"], # which = "most")) # ## Check packages in dir with their reverse dependencies from CRAN, # ## using '--as-cran' for the former but not the latter: # check_packages_in_dir(dir, # check_args = c("--as-cran", ""), # reverse = list(repos = getOption("repos")["CRAN"])) ## ---------------------------------------------