test_package {tinytest}R Documentation

Test a package during R CMD check or after installation

Description

Run all tests in an installed package. Throw an error and print all failed test results when one or more tests fail if not in interactive mode (e.g. when R CMD check tests a package). This function is intended to be used by R CMD check or by a user that installed a package that uses the tinytest test infrastructure.

Usage

test_package(pkgname, testdir = "tinytest", at_home = FALSE,
  ncpu = NULL, ...)

Arguments

pkgname

[character] scalar. Name of the package

testdir

[character] scalar. Path to installed directory, relative to the working directory of R CMD check.

at_home

[logical] scalar. Are we at home? (see Details)

ncpu

A positive integer, or a makeCluster object.

...

extra arguments passed to run_test_dir (e.g. ncpu).

Value

If interactive(), a tinytests object. If not interactive(), an error is thrown when at least one test fails.

Details

We set at_home=FALSE by default so R CMD check will run the same as at CRAN. See the package vignette (Section 4) for tips on how to set up the package structure. vignette("using_tinytest",package="tinytest").

See Also

setup_tinytest

Other test-files: build_install_test, exit_file, run_test_dir, run_test_file, summary.tinytests

Examples

## Not run: 
# Create a file with the following content, to use
# tinytest as your unit testing framework:
  if (requireNamespace("tinytest", quietly=TRUE))
    tinytest::test_package("your package name")

## End(Not run)
[Package tinytest version 1.1.0 Index]