A modern, C++-native, test framework for unit-tests, TDD and BDD - using C++14, C++17 and later (C++11 support is in v2.x branch, and C++03 on the Catch1.x branch)
Go to file
Stephane Del Pino 544c7d7cbf Add the optional variable OptionalCatchTestLauncher
This variable is set to allow the use of the nice ParseAndAddCatchTests script
in the case where a launcher is needed to execute  the script.

This is introduced to allow to launch unit tests using mpi. In this case one can
write for instance
  set(OptionalCatchTestLauncher ${MPIEXEC} ${MPIEXEC_NUMPROC_FLAG} ${NUMPROC})
before calling the ParseAndAddCatchTests function.
2018-10-25 15:51:15 +02:00
.github Added "How to test changes in PR" section to documentation 2017-06-22 18:56:10 +02:00
CMake Separate Catch2Config from targets 2018-06-24 12:32:22 +02:00
artwork Tweaked logo 2017-11-07 11:41:49 +00:00
contrib Add the optional variable OptionalCatchTestLauncher 2018-10-25 15:51:15 +02:00
docs Add the optional variable OptionalCatchTestLauncher 2018-10-25 15:51:15 +02:00
examples Add example for TeamCity reporter and refer to it 2018-09-27 23:20:02 +02:00
include Catch's CLI now checks whether requested reporter exists 2018-10-25 15:43:30 +02:00
misc Simplify the Appveyor configuration batch script 2018-09-09 10:18:30 +02:00
projects Catch's CLI now checks whether requested reporter exists 2018-10-25 15:43:30 +02:00
scripts Improve path normalization for approvalTests.py 2018-10-19 12:46:06 +02:00
single_include/catch2 v2.4.1 2018-09-28 15:52:51 +02:00
test_package v2.4.1 2018-09-28 15:52:51 +02:00
third_party Bring in Clara v1.1.4 2018-03-09 10:37:56 +01:00
.gitattributes Update gitattributes 2018-07-23 10:15:52 +02:00
.gitignore Exclude benchmark dir 2018-01-05 14:39:59 +00:00
.travis.yml Add StringMaker for std::variant, std::monostate (#1380) 2018-09-20 14:13:35 +02:00
CMakeLists.txt v2.4.1 2018-09-28 15:52:51 +02:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2017-08-17 07:45:12 +01:00
LICENSE.txt Renamed licence file, license should now be detected by github 2017-03-20 08:59:25 +01:00
README.md v2.4.1 2018-09-28 15:52:51 +02:00
appveyor.yml No longer allow failures for VS2017 on AppVeyor 2018-08-29 13:39:24 +02:00
codecov.yml Fix broken YAML in a way that codecov understands 2018-05-10 14:49:40 +02:00
conanfile.py v2.4.1 2018-09-28 15:52:51 +02:00

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