A modern, C++-native, header-only, test framework for unit-tests, TDD and BDD - using C++11, C++14, C++17 and later (or C++03 on the Catch1.x branch)
C++ CMake Python Objective-C++ C Roff Other
horenmar Separate Catch2Config from targets
This lets us add the installed helper scripts to the cmake module
path, letting CMake users just include them after requiring Catch2
package.
Latest commit 1af60ef Jun 24, 2018
Permalink
Failed to load latest commit information.
.github Added "How to test changes in PR" section to documentation Jun 26, 2017
CMake Separate Catch2Config from targets Jun 24, 2018
artwork Tweaked logo Nov 7, 2017
contrib do not strip spaces from cmake discovered test names May 9, 2018
docs Update CMake and build documentation Jun 24, 2018
examples Integrate CMake with `<catch2/catch.hpp>` include paths Jun 24, 2018
include Replaced use of std::rand with std::mt19937 Jun 15, 2018
misc Fixup various spelling errors (#1208) Mar 7, 2018
projects Integrate CMake with `<catch2/catch.hpp>` include paths Jun 24, 2018
scripts Integrate CMake with `<catch2/catch.hpp>` include paths Jun 24, 2018
single_include/catch2 Integrate CMake with `<catch2/catch.hpp>` include paths Jun 24, 2018
test_package Integrate CMake with `<catch2/catch.hpp>` include paths Jun 24, 2018
third_party Bring in Clara v1.1.4 Mar 9, 2018
.gitattributes Keep .py files with LF endings so they can be executed from bash Feb 9, 2018
.gitignore Exclude benchmark dir Jan 5, 2018
.travis.yml Integrate CMake with `<catch2/catch.hpp>` include paths Jun 24, 2018
CMakeLists.txt Separate Catch2Config from targets Jun 24, 2018
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Aug 17, 2017
LICENSE.txt Renamed licence file, license should now be detected by github Mar 20, 2017
README.md v2.2.3 Jun 6, 2018
appveyor.yml Disable PIP's version check on AppVeyor Mar 22, 2018
codecov.yml Fix broken YAML in a way that codecov understands May 10, 2018
conanfile.py Stop conan package from installing Catch's helpers Jun 24, 2018

README.md

catch logo

Github Releases Build Status Build status codecov Try online

The latest version of the single header can be downloaded directly using this link

Catch2 is released!

If you've been using an earlier version of Catch, please see the Breaking Changes section of the release notes before moving to Catch2. You might also like to read this blog post for more details.

What's the Catch?

Catch2 stands for C++ Automated Test Cases in a Header and is a multi-paradigm test framework for C++. which also supports Objective-C (and maybe C). It is primarily distributed as a single header file, although certain extensions may require additional headers.

How to use it

This documentation comprises these three parts:

More