Testing your code is normally painful and boring.
testthat tries to make testing as fun as possible, so that you get a visceral satisfaction from writing tests. Testing should be fun, not a drag, so you do it all the time. To make that happen,
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.
Can re-run tests automatically as you change your code or tests.
Displays test progress visually, showing a pass, fail or error for every expectation. If you're using the terminal, it'll even colour the output.
testthat draws inspiration from the xUnit family of testing packages, as well from many of the innovative ruby testing libraries, like rspec, testy, bacon and cucumber. I have used what I think works for R, and abandoned what doesn't, creating a testing environment that is philosophically centred in R.
Integration with R CMD check
If you're using testthat in a package, you need to adopt a specific structure to work with
R CMD check. This structure has changed recently to comply with new demands from CRAN, so please read closely if you submit your packages to CRAN. Previously, best practice was to put all test files in
inst/tests and ensure that
R CMD check ran them by putting the following code in
library(testthat) library(yourpackage) test_package("yourpackage")
Now, recommended practice is to put your tests in
tests/testthat, and ensure
R CMD check runs them by putting the following code in
The advantage of this new structure is that the user has control over whether or not tests are installed using the
--install-tests parameter to
R CMD install, or
INSTALL_opts = "--install-tests" argument to
install.packages(). I'm not sure why you wouldn't want to install the tests, but now you have the option.
You also need to add
Suggests: testthat to
DESCRIPTION as stated in the Writing R Extensions document. This avoids a
R CMD check warning about unspecified dependencies.