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
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 Properly unset tags variable. Jul 10, 2018
docs Document Approx's UDL support Jul 15, 2018
examples Add an example on providing streams with `CATCH_CONFIG_NOSTDOUT` Jul 8, 2018
include Add float/int literal for Approx Jul 15, 2018
misc Fixup various spelling errors (#1208) Mar 7, 2018
projects Add float/int literal for Approx Jul 15, 2018
scripts Changed approval tests path to match changes in CMakeLists.txt Jun 25, 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 Add Discord badge to README Jul 1, 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 Install contrib when installing Catch using conan Jul 1, 2018

README.md

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:

More