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ý a3ffc20f57
Provide CTest a hint on test costs (and thus ordering)
When running tests in parallel, CTest runs the tests in decreasing
order of cost (time required), to get the largest speed up from
parallelism. However, the initial cost estimates for all tests are
0, and they are only updated after a test run. This works on a dev
machine, where the tests are ran over and over again, because
eventually the estimates become quite precise, but CI always does
a clean build with 0 estimates.

Because we have 2 slow tests, we want them to run first to avoid
losing parallelism. To do this, we provide them with a cost estimate
manually.
2020-02-03 09:07:23 +01:00
.conan [conan] Fix the Conan package for multiple static library use 2020-01-25 22:39:50 +01: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
data/artwork Move artwork/ to data/artwork/ 2019-12-06 11:36:12 +01:00
docs Remove the !hide special tag 2020-01-28 20:48:32 +01:00
examples Use std::make_unique instead of our polyfill or naked new 2020-02-01 23:34:00 +01:00
extras Rename contrib/ to extras/ 2019-12-05 16:24:57 +01:00
single_include/catch2 v2.10.2 2019-10-24 18:41:25 +02:00
src Outline Config destructor to avoid including superfluous header 2020-02-02 14:43:26 +01:00
tests Provide CTest a hint on test costs (and thus ordering) 2020-02-03 09:07:23 +01:00
third_party Fix vendored dep because upstream is non-responsive 2019-04-10 20:17:25 +02:00
tools OpenCppCoverage skips coverage of non-source directories 2020-02-02 23:15:22 +01: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 Try uploading in-development versions of v3 as testing packages 2020-01-25 21:09:48 +01:00
CMakeLists.txt Have the in-development version report as v3.0.0 2020-01-25 09:15:46 +01: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 Move artwork/ to data/artwork/ 2019-12-06 11:36:12 +01:00
appveyor.yml Fix coverage collection on AppVeyor 2020-01-31 14:44:40 +01:00
codecov.yml Do not count test files into coverage 2020-02-02 14:51:41 +01:00
conanfile.py [conan] Fix the Conan package for multiple static library use 2020-01-25 22:39:50 +01: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