test_dir: Gather All Test Results From R Scripts#

Description#

Executes all R scripts in a given directory whose names match a given pattern and gathers all test result in a single list, which you can process however you desire.

The function does not fail if some tests are not met – you need to detect this yourself.

Usage#

test_dir(
  path = "tests",
  pattern = "^realtest-.*\\.R$",
  recursive = FALSE,
  ignore.case = FALSE
)

Arguments#

path

directory with scripts to execute

pattern

regular expression specifying the file names to execute

recursive

logical, see list.files

ignore.case

logical, see list.files

Value#

Returns a list of all test results (of class realtest_results), each being an object of class realtest_result, see E, with additional fields .file, .line, and .expr, giving the location and the source code of the test instance.

Author(s)#

Marek Gagolewski

See Also#

The official online manual of realtest at https://realtest.gagolewski.com/

Related functions: source2, summary.realtest_results

Examples#

# r <- test_dir("~/R/realtest/inst/realtest")  # some path
# s <- summary(r)  # summary.realtest_results
# print(s)  # print.realtest_results_summary
# stopifnot(!any(s[["match"]]=="fail"))  # halt if there are failed tests