RUnit v0.4.31


Monthly downloads



by Roman Zenka

R Unit Test Framework

R functions implementing a standard Unit Testing framework, with additional code inspection and report generation tools.



CRAN_Status_Badge CRAN Downloads Travis-CI Build Status

RUnit is a testing package for R code, inspired by the xUnit family of testing tools.

Originally implemented by Thomas Koenig, Klaus Juenemann, and Matthias Burger, this package has served the R community for over a decade.

Since RUnit is no longer actively developed, I provide maintenance of this package mostly to support older projects that still rely on RUnit.

Using RUnit

To make RUnit work with R CMD check, create a following file in the tests subdirectory. This would run the actual tests stored in the packages inst/tests subdirectory.

# Our package. Used for the test suite name
pkgname <- "your package name"
require(pkgname, quietly=TRUE, character.only=TRUE) || stop("package '", pkgname, "' not found")

# How to determine which files to load (have to start with test_ and end with .R)
pattern <- "^test_.*\\.R$"

# Which functions to run. Have to start with 'test.'
testFunctionRegexp = "^test.+"

# Path to the unit tests folder in the package
dir <- system.file(subdir, package=pkgname)

# Define RUnit test suite
suite <- defineTestSuite(name=paste(pkgname, "RUnit Tests"),
                         testFuncRegexp = testFunctionRegexp,

# Run tests
result <- runTestSuite(suite)

# Display result tests on the console

# Write results in JUnit-like xml format
printJUnitProtocol(result, fileName="junit.xml")

A typical unit test would then live for example in inst/tests/test.operations.R. Each such file can contain multiple functions like so:

test.additionWorks <- function() {
  checkEquals(2, 1+1, "one plus one must be two")

test.divisionByZeroFails <- function() {
  checkException(1/0, "division by zero is expected to fail")

Functions in RUnit

Name Description
RUnit-internal Internal functions
printHTML.trackInfo Write HTML pages of the tracking result.
.setUp Definition of RUnit Test Case code files.
RUnit RUnit - Package Description
options RUnit options
textProtocol Printing a plain text, HTML or JUnit-like XML version of an RUnit test run protocol.
tracker Tracking the results of the inspect process.
inspect Track the executed code lines of a function or method.
checkFuncs RUnit check functions
runTestSuite Definition and execution of RUnit test suites.
No Results!

Last month downloads


Date 2015-11-05
LazyLoad yes
License GPL-2
NeedsCompilation no
Packaged 2015-11-06 03:01:34 UTC; m044910
Repository CRAN
Date/Publication 2015-11-06 05:49:48

Include our badge in your README