textProtocol: Printing a plain text or HTML version of an RUnit test run.

Description

printTextProtocol prints a plain text protocol of a test run. The resulting test protocol can be configured through the function arguments.

printHTMLProtocol prints an HTML protocol of a test run. For long outputs this version of the test protocol is slightly more readable than the plain text version due to links in the document. The resulting test protocol can be configured through the function arguments.

print prints the number of executed test functions and the number of failures and errors.

summary directly delegates the work to printTextProtocol.

getErrors returns a list containing the number of test functions, the number of deactivated functions (if there are any), the number of errors and the number of failures.

Usage

printTextProtocol(testData, fileName = "", separateFailureList = TRUE, showDetails = TRUE, traceBackCutOff=9)
  printHTMLProtocol(testData, fileName = "", separateFailureList = TRUE, traceBackCutOff=9, testFileToLinkMap=function(x) x )
  print.RUnitTestData(x, ...)
  summary.RUnitTestData(object, ...)
  getErrors(testData)

Arguments

concept

RUnit

Details

The text protocol can roughly be divided into three sections with an increasing amount of information. The first section just reports the number of executed test functions and the number of failures and errors. The second section describes all test suits. Optionally, all errors and failures that occured in some test suite are listed. In the optional third section details are given about all executed test functions and in the case of an error or failure as much debug information as possible is provided.

Examples

Run this code

## run some test suite
myTestSuite <- defineTestSuite("my test suite", "tests")
testData <- runTestSuite(myTestSuite)


## prints detailed text protocol
## to standard out:
printTextProtocol(testData, showDetails=TRUE)
## prints detailed html protocol
## to standard out
printHTMLProtocol(testData)