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
Martin Hořeňovský 849f2848bd
Rework how warning suppression in macros is done
Previously, each warning suppression was self-contained, with its
own pair of `SUPPRESS_X_WARNING` and `UNSUPPRESS_X_WARNING` macros.
This had the obvious advantage of being self-containing, but it
also meant that if we needed to suppress more than one warning
in a single place, then we would manipulate the compiler's warning
state multiple times, even though logically we would only need one
layer.

The new way of suppressing warnings in macros is to push compiler's
warning state with `CATCH_INTERNAL_START_WARNINGS_SUPPRESSION` macro,
then disable whatever macros we need with the
`CATCH_INTERNAL_SUPPRESS_X_WARNINGS` macro, and then return to the
previous state using `CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION`.
2019-10-27 21:07:21 +01:00
.conan Fix typos identified by codespell. 2019-04-10 09:42:11 +02:00
.github Add a FUNDING file 2019-06-07 19:15:35 +02:00
CMake Fix typos identified by codespell. 2019-04-10 09:42:11 +02:00
artwork Optimize in-repo PNGs 2019-09-06 12:12:47 +02:00
contrib Fix CTest command issue with square brackets 2019-07-21 16:29:46 +02:00
docs Add SonarQube Generic Test Data reporter 2019-10-27 10:02:41 +01:00
examples Merge pull request #1336 from ax3l/topic-overrideVirtualRedundant 2019-04-18 14:10:24 +02:00
include Rework how warning suppression in macros is done 2019-10-27 21:07:21 +01:00
misc Fix escaping of quotes in coverage helper 2019-09-21 23:19:45 +02:00
projects Rework how warning suppression in macros is done 2019-10-27 21:07:21 +01:00
scripts Add SonarQube Generic Test Data reporter 2019-10-27 10:02:41 +01:00
single_include/catch2 v2.10.2 2019-10-24 18:41:25 +02:00
third_party Fix vendored dep because upstream is non-responsive 2019-04-10 20:17:25 +02:00
.gitattributes Update gitattributes 2018-07-23 10:15:52 +02:00
.gitignore Update Conan recipe 2018-11-19 15:27:47 +01:00
.travis.yml Do not explicitly install conan 2019-10-03 00:00:17 +02:00
CMakeLists.txt v2.10.2 2019-10-24 18:41:25 +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.10.2 2019-10-24 18:41:25 +02:00
appveyor.yml No longer allow failures for VS2017 on AppVeyor 2018-08-29 13:39:24 +02:00
codecov.yml Add SonarQube Generic Test Data reporter 2019-10-27 10:02:41 +01:00
conanfile.py Have conan test-build the package in a separate subdirectory 2019-05-25 19:58:49 +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 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