# Configuration

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 :

- Add `packages = "testex"` to the `Roxygen` field in `DESCRIPTION`, allowing `roxygen2` to make use of the `testex` tags.
- Add `testex` as a `Suggests` dependency
- Add settings to the `Config/testex/options` field in `DESCRIPTION`, enabling example tests during `R CMD check` by default.
- Add a `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:

# `testthat`

Running 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 check`

By 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)