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)
Clone or download
Latest commit 461843b Dec 10, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.conan #926 Fix Conan package reference Nov 28, 2018
.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 Add the optional variable OptionalCatchTestLauncher Oct 25, 2018
docs Docs: added docs for TEMPLATE_PRODUCT_TEST_CASE Dec 10, 2018
examples Add example for TeamCity reporter and refer to it Sep 27, 2018
include Template tests: added TEMPLATE_PRODUCT_TEST_CASE Dec 10, 2018
misc Simplify the Appveyor configuration batch script Sep 9, 2018
projects Template tests: added TEMPLATE_PRODUCT_TEST_CASE Dec 10, 2018
scripts Remove remains of the old conan things from release script Nov 26, 2018
single_include/catch2 v2.5.0 Nov 26, 2018
third_party Update Clara to v1.1.5 to fix TextFlow bugs Oct 26, 2018
.gitattributes Update gitattributes Jul 23, 2018
.gitignore Update Conan recipe Nov 19, 2018
.travis.yml Deprecated 'sudo: false' removed from travis config. Nov 26, 2018
CMakeLists.txt v2.5.0 Nov 26, 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.5.0 Nov 26, 2018
appveyor.yml No longer allow failures for VS2017 on AppVeyor Aug 29, 2018
codecov.yml Fix broken YAML in a way that codecov understands May 10, 2018
conanfile.py Update Conan recipe Nov 19, 2018


catch logo

Github Releases Build Status Build status codecov Try online Join the chat in Discord: https://discord.gg/4CWS9zD

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: