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ý cfb6956698
v2.12.0
--- Improvements ---
* Running tests in random order (`--order rand`) has been reworked significantly (#1908)
  * Given same seed, all platforms now produce the same order
  * Given same seed, the relative order of tests does not change if you select only a subset of them
* Vector matchers support custom allocators (#1909)
* `|` and `&` (bitwise or and bitwise and) are now supported in `CHECK` and `REQUIRE`
  * The resulting type must be convertible to `bool`

--- Fixes ---
* Fixed computation of benchmarking column widths in ConsoleReporter (#1885, #1886)
* Suppressed clang-tidy's `cppcoreguidelines-pro-type-vararg` in assertions (#1901)
  * It was a false positive trigered by the new warning support workaround
* Fixed bug in test specification parser handling of OR'd patterns using escaping (#1905)

--- Miscellaneous ---
* Worked around IBM XL's codegen bug (#1907)
  * It would emit code for _destructors_ of temporaries in an unevaluated context
* Improved detection of stdlib's support for `std::uncaught_exceptions` (#1911)
2020-04-21 16:33:15 +02: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 Change PARSE_CATCH_TESTS_ADD_FIXTURE_IN_TEST_NAME conditional. 2020-03-27 09:55:06 +01:00
docs v2.12.0 2020-04-21 16:33:15 +02:00
examples Some refactorings: 2020-01-25 09:01:04 +01:00
include v2.12.0 2020-04-21 16:33:15 +02:00
misc Fix escaping of quotes in coverage helper 2019-09-21 23:19:45 +02:00
projects Support bitand and bitor in REQUIRE/CHECK 2020-04-21 11:00:08 +02:00
scripts Move all scripts to Python3 2020-03-19 12:36:30 +01:00
single_include/catch2 v2.12.0 2020-04-21 16:33:15 +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.12.0 2020-04-21 16:33:15 +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.12.0 2020-04-21 16:33:15 +02:00
appveyor.yml Use newer version of Python on AppVeyor 2019-11-13 20:58:15 +01: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