To make the most of testex, there are a few configuration steps you might consider. These are made simple by using:
testex::use_testex()which will :
packages = "testex" to the Roxygen field in DESCRIPTION, allowing roxygen2 to make use of the testex tags.testex as a Suggests dependencyConfig/testex/options field in DESCRIPTION, enabling example tests during R CMD check by default.test-testex.R test file if you’re using testthat, enabling example tests during testthat test evaluation.Though if you prefer you can configure all of this yourself:
testthatRunning tests using testthat is simple. Just use
testex::use_testex_as_testthat()This will add a simple, one-line file to your tests/testthat directory containing
testex::test_examples_as_testthat()By adding this single line to a testthat test file (such as tests/testthat/test-testex.R), your example tests will be included as part of your test suite.
When run this way, testex tests are embedded with additional metadata including the original file location of the examples so that testthat is able to provide more informative error messages.
R CMD checkBy default, your tests will run when your run examples using R CMD check. However, R CMD check will stop on the first error and truncates error output, which can be inconvenient for debugging. If you’d prefer not to run tests during checking, you can add the following line to your DESCRIPTION.
Config/testex/options: list(check = FALSE)