Skip to content

/Catch2

A modern, C++-native, header-only, test framework for unit-tests, TDD and BDD - using C++11, C++14, C++17 and later (or C++03 on the Catch1.x branch)
c-plus-plus cpp98 cpp11 testing test-framework tdd bdd header-only single-file no-dependencies framework
  1. C++ 89.1%
  2. CMake 5.5%
  3. Python 3.9%
  4. Objective-C++ 0.5%
  5. C 0.4%
  6. Roff 0.2%
  7. Other 0.4%
Branch: master
Find File
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

@horenmar
horenmar Merge pull request #1575 from alabuzhev/warning_ntstatus 
Suppress warning caused by ntstatus.h inclusion
Latest commit 296d447 Mar 20, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.conan #926 Fix Conan package reference Nov 28, 2018
.github Remove the obsolete issue template Jan 18, 2019
CMake
artwork Tweaked logo Nov 7, 2017
contrib Add comma-escaping in test specs to ParseAndAddCatchTests.cmake Mar 3, 2019
docs raspigcd - opensource-users Mar 19, 2019
examples Add another example for generators Feb 26, 2019
include Suppress warning caused by ntstatus.h inclusion Mar 19, 2019
misc Integrate tests for #1394 into our test suite Jan 18, 2019
projects Add tests for unscoped info Mar 6, 2019
scripts Script helper getBuildExecutable now works properly on Windows Feb 23, 2019
single_include/catch2 v2.7.0 Mar 7, 2019
third_party Update Clara to v1.1.5 to fix TextFlow bugs Oct 26, 2018
.gitattributes Update gitattributes Jul 23, 2018
.gitignore Update Conan recipe Nov 19, 2018
.travis.yml Release builds on travis now respect C++17 if specified Jan 25, 2019
CMakeLists.txt v2.7.0 Mar 7, 2019
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Aug 17, 2017
LICENSE.txt Renamed licence file, license should now be detected by github Mar 20, 2017
README.md Update url of blog post Mar 8, 2019
appveyor.yml No longer allow failures for VS2017 on AppVeyor Aug 29, 2018
codecov.yml Fix broken YAML in a way that codecov understands May 10, 2018
conanfile.py Update Conan recipe Nov 19, 2018

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

You can’t perform that action at this time.