Learn R Programming

⚠️There's a newer version (2.3.2) of this package.Take me there.

checkmate

Fast and versatile argument checks for R.

Ever used an R function that produced a not-very-helpful error message, just to discover after minutes of debugging that you simply passed a wrong argument?

Blaming the laziness of the package author for not doing such standard checks (in a dynamically typed language such as R) is at least partially unfair, as R makes theses types of checks cumbersome and annoying. Well, that's how it was in the past.

Enter checkmate.

Virtually every standard type of user error when passing arguments into function can be caught with a simple, readable line which produces an informative error message in case. A substantial part of the package was written in C to minimize any worries about execution time overhead. Furthermore, the package provides over 30 expectations to extend the popular testthat package for unit tests.

Installation

For the stable release, just install the latest version from CRAN:

install.packages("checkmate")

For the development version, use devtools:

devtools::install_github("mllg/checkmate")

Resources

Copy Link

Version

Install

install.packages('checkmate')

Monthly Downloads

308,110

Version

1.9.4

License

BSD_3_clause + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Michel Lang

Last Published

July 4th, 2019

Functions in checkmate (1.9.4)

allMissing

Check if an object contains missing values
checkAtomic

Check that an argument is an atomic vector
checkAccess

Check file system access rights
AssertCollection

Collect multiple assertions
checkAtomicVector

Check that an argument is an atomic vector
asInteger

Convert an argument to an integer
checkArray

Check if an argument is an array
anyNaN

Check if an object contains NaN values
anyInfinite

Check if an object contains infinite values
assert

Combine multiple checks into one assertion
checkBit

Check if an argument is a bit vector
checkComplex

Check if an argument is a vector of type complex
checkCount

Check if an argument is a count
checkClass

Check the class membership of an argument
checkChoice

Check if an object is an element of a given set
checkFileExists

Check existence and access rights of files
checkFactor

Check if an argument is a factor
checkFormula

Check if an argument is a formula
checkFlag

Check if an argument is a flag
checkCharacter

Check if an argument is a vector of type character
checkDisjunct

Check if an argument is disjunct from a given set
checkDouble

Check that an argument is a vector of type double
checkDataTable

Check if an argument is a data table
checkFunction

Check if an argument is a function
checkDataFrame

Check if an argument is a data frame
checkNull

Check if an argument is NULL
checkInt

Check if an argument is a single integerish value
checkNamed

Check if an argument is named
checkList

Check if an argument is a list
checkNumber

Check if an argument is a single numeric value
checkLogical

Check if an argument is a vector of type logical
checkScalar

Check if an argument is a single atomic value
checkNames

Check names to comply to specific rules
checkTRUE

Check if an argument is TRUE
checkSetEqual

Check if an argument is equal to a given set
checkString

Check if an argument is a string
checkSubset

Check if an argument is a subset of a given set
checkR6

Check if an argument is a R6 class
checkRaw

Check if an argument is a raw vector
checkScalarNA

Check if an argument is a single missing value
checkMatrix

Check if an argument is a matrix
checkNumeric

Check that an argument is a vector of type numeric
checkMultiClass

Check the class membership of an argument
checkmate-package

checkmate: Fast and Versatile Argument Checks
makeExpectation

Turn a Check into an Expectation
makeAssertion

Turn a Check into an Assertion
makeTest

Turn a Check into a Test
checkOS

Check the operating system
checkDate

Check that an argument is a Date
matchArg

Partial Argument Matching
checkDirectoryExists

Check for existence and access rights of directories
checkFALSE

Check if an argument is FALSE
checkTibble

Check if an argument is a tibble
checkEnvironment

Check if an argument is an environment
checkInteger

Check if an argument is vector of type integer
checkIntegerish

Check if an object is an integerish vector
%??%

Coalesce operator
checkPOSIXct

Check that an argument is a date/time object in POSIXct format
checkPathForOutput

Check if a path is suited for creating an output file
qassert

Quick argument checks on (builtin) R types
qassertr

Quick recursive arguments checks on lists and data frames
checkVector

Check if an argument is a vector
wf

Get the index of the first/last TRUE
vname

Lookup a variable name