RapidCheck
github.com
- Free plan
- Windows
- Linux
- Self-hosted
What RapidCheck is
RapidCheck is a free C++ framework for property-based testing. Developers define properties as callables passed to rc::check, and the framework repeatedly supplies generated inputs to look for counterexamples. Built-in generators cover common values, while combinators support custom generators. Arbitrary-value support includes vectors, maps, sets, tuples, pairs, strings, and chrono types. When a property fails, RapidCheck attempts to shrink the input and reports a smaller failing case. It also supports stateful testing by generating sequences of valid operations. Documented integrations include Boost Test, Google Test, Google Mock, and Catch. A property passes by default after 100 successful tests, and that number can be configured. RapidCheck uses CMake, can be added as a CMake subdirectory, and requires a C++11-compliant compiler. It runs on Linux and Windows and is distributed under a BSD 2-Clause license. The user guide describes the project as unfinished, with missing sections, and says the API may change because it has not stabilized.
Who it suits
RapidCheck suits C++ developers who want generated inputs, property checks, and reduced counterexamples. It fits projects already using CMake or the listed C++ test libraries.
Good to know, and what to watch
- Generates random test data
- Shrinks failures to counterexamples
- Supports stateful testing
- Includes STL type generators
- Integrates with major C++ test libraries
- API has not stabilized
- User guide is still unfinished
- Requires a C++11-compliant compiler
- Default is 100 successful tests
The verdict
RapidCheck adds generative and stateful testing to C++ projects, with shrinking that helps isolate failures. Its integrations and CMake setup are practical, while the unfinished documentation and changing API require tolerance for ongoing work.
What the maker publishes
- API stability
- The User Guide says the API has not stabilized and may change at any time. source
- Build
- RapidCheck uses CMake and can be added as a subdirectory to a CMake project. source
- Build requirements
- RapidCheck uses CMake and requires a C++11-compliant compiler; the README lists Clang 3.5, GCC 4.9 and Visual Studio 2015 as CI compiler versions. source
- Catch integration
- RapidCheck also documents basic integration with the Catch test library. source
- Counterexamples
- When it finds a failing case, RapidCheck tries to shrink it to a smaller counterexample. source
- Documentation status
- The User Guide says it is a work in progress and that some parts are still missing. source
- Features
- The README lists imperative property definitions, test case shrinking, STL support including maps and sets, and combinators for creating generators. source
- Generators
- RapidCheck includes generators for common types and combinators for building custom generators. source
- Integrations
- The README lists integrations with Boost Test, Google Test and Google Mock. source
- License
- The project is distributed under a BSD 2-Clause license. source
- License
- The repository identifies its license as BSD-2-Clause. source
- Limitations
- The user guide says it is a work in progress, and the API has not stabilized and may change at any time. source
- Property checks
- Properties are implemented as callables passed to rc::check, and RapidCheck repeatedly calls them with generated inputs. source
- Purpose
- RapidCheck is a C++ framework for property-based testing inspired by QuickCheck and similar frameworks. source
- Requirements
- RapidCheck uses C++11 and requires a compliant compiler. source
- Shrinking
- When a property fails, RapidCheck tries to find the smallest failing test case and displays it as a counterexample. source
- Stateful testing
- RapidCheck supports stateful testing by generating sequences of valid operations to test stateful systems. source
- Stateful testing
- The README describes stateful testing based on commands in the style of Erlang QuickCheck. source
- STL support
- Built-in arbitrary-value generation supports types including vectors, maps, sets, tuples, pairs, strings and chrono types. source
- Test defaults
- A property passes by default after 100 successful tests, and the number is configurable. source
- Test generation
- It generates random test data to search for inputs that falsify a property. source
- What it does
- RapidCheck is a C++ framework for property-based testing that generates random test data to find counterexamples to properties. source
Checked against the maker's pages on 30 Sept 2026.