Learn R Programming

⚠️There's a newer version (3.2.1.1) of this package.Take me there.

testthat

Overview

Testing your code can be painful and tedious, but it greatly increases the quality of your code. testthat tries to make testing as fun as possible, so that you get a visceral satisfaction from writing tests. Testing should be addictive, so you do it all the time. To make that happen, testthat:

Provides functions that make it easy to describe what you expect a function to do, including catching errors, warnings, and messages.
Easily integrates in your existing workflow, whether it’s informal testing on the command line, building test suites, or using R CMD check.
Displays test progress visually, showing a pass, fail, or error for every expectation. If you’re using the terminal or a recent version of RStudio, it’ll even colour the output.

testthat draws inspiration from the xUnit family of testing packages, as well as from many of the innovative ruby testing libraries, like rspec, testy, bacon and cucumber.

testthat is the most popular unit testing package for R and is used by thousands of CRAN packages.

If you’re not familiar with testthat, the testing chapter in R packages gives a good overview, along with workflow advice and concrete examples.

Installation

# Install the released version from CRAN
install.packages("testthat")

# Or the development version from GitHub:
# install.packages("pak")
pak::pak("r-lib/testthat")

Usage

The easiest way to get started is with usethis. Assuming you’re in a package directory, just run usethis::use_test("name") to create a test file, and set up all the other infrastructure you need. If you’re using RStudio, press Cmd/Ctrl + Shift + T (or run devtools::test() if not) to run all the tests in a package.

Copy Link

Version

Install

install.packages('testthat')

Monthly Downloads

442,445

Version

3.1.10

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Repository

https://github.com/r-lib/testthat

Homepage

https://testthat.r-lib.org

Maintainer

Last Published

July 6th, 2023

Functions in testthat (3.1.10)

Test reporter: gather all errors silently.

equality-expectations

Does code return the expected value?

Does code return a vector with the specified length?

expect_less_than

Deprecated numeric comparison functions

describe: a BDD testing language

expect_invisible

Does code return a visible or invisible object?

Does code throw an error, warning, message, or other condition?

Capture the state of a directory.

Does an object inherit from a given class?

comparison-expectations

Does code return a number greater/less than the expected value?

Describe the context of a set of tests.

expect_known_output

Expectations: is the output or the value equal to a known good value?

expect_no_error

Does code run without error, warning, message, or other condition?

expect_setequal

Does code return a vector containing the expected values?

expect_reference

Does code return a reference to the expected object?

context_start_file

Start test context from a file name

default_reporter

Retrieve the default reporter

Does code return NULL?

The building block of all expect_ functions

expect_equivalent

Is an object equal to the expected value, ignoring attributes?

Compare two directory states.

Provide human-readable comparison of two objects

inheritance-expectations

Does code return an object inheriting from the expected base type, S3 class, or S4 class?

expect_snapshot_file

Snapshot testing for whole files

expect_snapshot_output

Snapshot helpers

Expect that a condition holds.

Default expectations that always succeed or fail.

Does code return a vector with the expected size and/or prototype?

Construct an expectation object

Negate an expectation

Old-style expectations.

is_informative_error

Is an error informative?

expect_output_file

Expectations: is the output or the value equal to a known good value?

local_mocked_bindings

local_test_context

Locally set options for maximal test reproducibility

Does code print output to the console?

expect_snapshot

Snapshot testing

Does code return a vector with (given) names?

local_test_directory

Locally set test directory options

find_test_scripts

Find test files

Does code execute silently?

Does a string match a regular expression?

evaluate_promise

Evaluate a promise, capturing all types of output.

set_state_inspector

State inspected

Compute a digest of a filename, returning NA if the file doesn't exist.

Find reporter object given name or object.

logical-expectations

Does code return TRUE or FALSE?

Tools for testing expectations

expect_snapshot_value

Snapshot testing for values

Determine testing status

reporter-accessors

Get and set active reporter.

Temporarily change the active testthat edition

Run all tests in a single file

expect_cpp_tests_pass

Do C++ tests past?

Test package examples

Run code before/after tests

local_snapshotter

Instantiate local snapshotting context

Quasi-labelling

snapshot_accept

Snapshot management

Run all tests in a directory

Superseded skip functions

make_expectation

Make an equality test.

Generate default testing environment.

Locate a file in the testing directory

Run all tests in a package

Set maximum number of test failures allowed before aborting the run

testthat_tolerance

Default numeric tolerance

Watch a directory for changes (additions, deletions & modifications).

Mock functions in a package.

Try evaluating an expressing multiple times until it succeeds.

Run code after all test files

testthat-package

An R package to make testing fun!

Use Catch for C++ Unit Testing

Objects exported from other packages

Source a file, directory of files, or various important subsets

takes_less_than

Does code take less than the expected amount of time to run?

testthat_results

Create a testthat_results object from the test results as stored in the ListReporter results field.

testthat_examples

Retrieve paths to built-in example test files

MinimalReporter

Test reporter: minimal.

Check reporter: 13 line summary of problems

Multi reporter: combine several reporters in one.

RStudioReporter

Test reporter: RStudio

Test reporter: summary of errors in jUnit XML format.

List reporter: gather all test results along with elapsed time and file information.

Test reporter: fail at end.

ProgressReporter

Test reporter: interactive progress bar of errors.

LocationReporter

Test reporter: location

Test reporter: start recovery.

Manage test reporting

TeamcityReporter

Test reporter: Teamcity format.

Test reporter: TAP format.

Test reporter: stop on error

SummaryReporter

Test reporter: summary of errors.

Watches code and tests for changes, rerunning tests as appropriate.

capture_condition

Capture conditions, including messages, warnings, expectations, and errors.

Capture output to console

auto_test_package

Watches a package for changes, rerunning tests as appropriate.