testInstalledPackage

0th

Percentile

Test Installed Packages

These functions allow an installed package to be tested, or all base and recommended packages.

Keywords
utilities
Usage
testInstalledPackage(pkg, lib.loc = NULL, outDir = ".", types = c("examples", "tests", "vignettes"), srcdir = NULL, Ropts = "", ...)
testInstalledPackages(outDir = ".", errorsAreFatal = TRUE, scope = c("both", "base", "recommended"), types = c("examples", "tests", "vignettes"), srcdir = NULL, Ropts = "", ...)
testInstalledBasic(scope = c("basic", "devel", "both", "internet"))
Arguments
pkg
name of an installed package.
lib.loc
library path(s) in which to look for the package. See library.
outDir
the directory into which to write the output files: this should already exist.
types
type(s) of tests to be done.
errorsAreFatal
logical: should testing terminate at the first error?
srcdir
Optional directory to look for .save files.
Ropts
Additional options such as -d valgrind to be passed to R CMD BATCH when running examples or tests.
...
additional arguments use when preparing the files to be run, e.g.\ifelse{latex}{\out{~}}{ } commentDontrun and commentDonttest.
scope
Which set(s) should be tested? Can be abbreviated.
Details

These tests depend on having the package example files installed (which is the default). If package-specific tests are found in a ‘tests’ directory they can be tested: these are not installed by default, but will be if R CMD INSTALL --install-tests was used. Finally, the R code in any vignettes can be extracted and tested.

Package tests are run in a ‘pkg-tests’ subdirectory of ‘outDir’, and leave their output there.

testInstalledBasic runs the basic tests, if installed. This should be run with LC_COLLATE=C set: the function tries to set this by it may not work on all OSes. For non-English locales it may be desirable to set environment variables LANGUAGE to en and LC_TIME to C to reduce the number of differences from reference results.

Except on Windows, if the environment variable TEST_MC_CORES is set to an integer greater than one, testInstalledPackages will run the package tests in parallel using its value as the maximum number of parallel processes.

unix The package-specific tests for the base and recommended packages are not normally installed, but make install-tests is provided to do so (as well as the basic tests). windows The package-specific tests for the base and recommended packages are an optional part of the install. Currently testing requires a Unix-like diff for a full report if more than simple differences are found.

Value

Invisibly 0L for success, 1L for failure.

Aliases
  • testInstalledPackage
  • testInstalledPackages
  • testInstalledBasic
  • TEST_MC_CORES
Documentation reproduced from package tools, version 3.2.3, License: Part of R 3.2.3

Community examples

Looks like there are no examples yet.