Learn R Programming

⚠️There's a newer version (2.3.4) 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

1,340,729

Version

2.3.1

License

BSD_3_clause + file LICENSE

Issues

Pull Requests

Stars

Forks

Repository

https://github.com/mllg/checkmate

Homepage

https://mllg.github.io/checkmate/

Maintainer

Michel Lang

Last Published

December 4th, 2023

Functions in checkmate (2.3.1)

Check if an argument is a data table

Check that an argument is a Date

Check if an argument is a count

Check the class membership of an argument

Check if an argument is disjunct from a given set

Check if an argument is a data frame

Check if an object is an element of a given set

checkDirectoryExists

Check for existence and access rights of directories

Check if an argument is a vector of type character

Check if an argument is a vector of type complex

Check if an argument is a single integerish value

checkFileExists

Check existence and access rights of files

Check if an argument is vector of type integer

checkEnvironment

Check if an argument is an environment

Check if an argument is FALSE

Check if an argument is a flag

Check that an argument is a vector of type double

Check if an argument is a formula

Check if an argument is a function

Check if an argument is a factor

checkMultiClass

Check the class membership of an argument

checkIntegerish

Check if an object is an integerish vector

Check if an argument is a list

Check names to comply to specific rules

Check if an argument is NULL

Check if an argument is a single numeric value

Check if an argument is a vector of type logical

Check that an argument is a vector of type numeric

Check if an argument is a matrix

Check if an argument is named

checkPathForOutput

Check if a path is suited for creating an output file

Check if an argument is an R6 class

Check if an argument is equal to a given set

Check if an argument is a string

Check if an argument is a raw vector

Check the operating system

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

checkPermutation

Check if the arguments are permutations of each other.

checkmate-package

checkmate: Fast and Versatile Argument Checks

Coalesce operator

Check if an argument is a single missing value

Check if an argument is a single atomic value

Turn a Check into a Test

Partial Argument Matching

Get the index of the first/last TRUE

Check if an argument is a vector

Check if an argument is a tibble

register_test_backend

Select Backend for Unit Tests

Lookup a variable name

Quick recursive arguments checks on lists and data frames

Check if an argument is TRUE

Quick argument checks on (builtin) R types

Check if an argument is a subset of a given set

Turn a Check into an Assertion

makeExpectation

Turn a Check into an Expectation

Convert an argument to an integer

AssertCollection

Collect multiple assertions

Check if an object contains infinite values

Check that an argument is an atomic vector

Check if an object contains NaN values

Check file system access rights

checkAtomicVector

Check that an argument is an atomic vector

Check if an argument is an array

Combine multiple checks into one assertion

Check if an object contains missing values