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ý 2f4a7dda68
Have the in-development version report as v3.0.0
Because some of the tooling used by Catch2 does not properly support
version postfixes, such as `preview-1`, we will report the
in-development version is `v3.0.0`, and the first real release will
have to be `v3.0.1`.

Closes #1824
2020-01-25 09:15:46 +01:00
.conan Redo build matrix on .travis for C++14 and up 2019-10-31 16:19:56 +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 CATCH_CONFIG_DISABLE_MATCHERS 2020-01-25 09:07:36 +01:00
examples Convert examples to piecemeal includes 2020-01-21 14:46:07 +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 Have the in-development version report as v3.0.0 2020-01-25 09:15:46 +01:00
tests Remove CATCH_CONFIG_DISABLE_MATCHERS 2020-01-25 09:07:36 +01:00
third_party Fix vendored dep because upstream is non-responsive 2019-04-10 20:17:25 +02:00
tools Separate version macros to its own header 2020-01-19 15:39:11 +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 Reenable travis for CI 2019-12-16 00:15:10 +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 Reenable appveyor for CI 2019-12-16 00:15:30 +01:00
codecov.yml Update codecov ignorelist 2019-12-18 18:04:31 +01:00
conanfile.py Conan topic cleanup. 2020-01-24 15:10:43 +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