Yuri D'Elia ae17cef676 Update Catch2 v3.1.1 2 years ago
..
.conan ae17cef676 Update Catch2 v3.1.1 2 years ago
.github ae17cef676 Update Catch2 v3.1.1 2 years ago
CMake ae17cef676 Update Catch2 v3.1.1 2 years ago
data ae17cef676 Update Catch2 v3.1.1 2 years ago
docs ae17cef676 Update Catch2 v3.1.1 2 years ago
examples ae17cef676 Update Catch2 v3.1.1 2 years ago
extras ae17cef676 Update Catch2 v3.1.1 2 years ago
fuzzing ae17cef676 Update Catch2 v3.1.1 2 years ago
src ae17cef676 Update Catch2 v3.1.1 2 years ago
tests ae17cef676 Update Catch2 v3.1.1 2 years ago
third_party 7f1bd0f046 cmake: Update Catch2 2 years ago
tools ae17cef676 Update Catch2 v3.1.1 2 years ago
.bazelrc ae17cef676 Update Catch2 v3.1.1 2 years ago
.clang-format 7f1bd0f046 cmake: Update Catch2 2 years ago
.gitattributes 7f1bd0f046 cmake: Update Catch2 2 years ago
.gitignore ae17cef676 Update Catch2 v3.1.1 2 years ago
.gitrepo ae17cef676 Update Catch2 v3.1.1 2 years ago
BUILD.bazel ae17cef676 Update Catch2 v3.1.1 2 years ago
CMakeLists.txt ae17cef676 Update Catch2 v3.1.1 2 years ago
CMakePresets.json ae17cef676 Update Catch2 v3.1.1 2 years ago
CODE_OF_CONDUCT.md 7f1bd0f046 cmake: Update Catch2 2 years ago
Doxyfile ae17cef676 Update Catch2 v3.1.1 2 years ago
LICENSE.txt 7f1bd0f046 cmake: Update Catch2 2 years ago
README.md ae17cef676 Update Catch2 v3.1.1 2 years ago
SECURITY.md ae17cef676 Update Catch2 v3.1.1 2 years ago
WORKSPACE.bazel ae17cef676 Update Catch2 v3.1.1 2 years ago
appveyor.yml ae17cef676 Update Catch2 v3.1.1 2 years ago
codecov.yml ae17cef676 Update Catch2 v3.1.1 2 years ago
conanfile.py ae17cef676 Update Catch2 v3.1.1 2 years ago
mdsnippets.json ae17cef676 Update Catch2 v3.1.1 2 years ago
meson.build ae17cef676 Update Catch2 v3.1.1 2 years ago

README.md

Catch2 logo

Github Releases Linux build status Linux build status MacOS build status Build Status Code Coverage Try online

What's the Catch2?

Catch2 is mainly a unit testing framework for C++, but it also provides basic micro-benchmarking features, and simple BDD macros.

Catch2's main advantage is that using it is both simple and natural. Tests autoregister themselves and do not have to be named with valid identifiers, assertions look like normal C++ code, and sections provide a nice way to share set-up and tear-down code in tests.

Catch2 v3 is being developed!

You are on the devel branch, where the next major version, v3, of Catch2 is being developed. As it is a significant rework, you will find that parts of this documentation are likely still stuck on v2.

For stable (and documentation-matching) version of Catch2, go to the v2.x branch.

For migrating from the v2 releases to v3, you should look at our documentation. It provides a simple guidelines on getting started, and collects most common migration problems.

How to use it

This documentation comprises these three parts:

More