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ý e1e6872c4c
Standardize header names and file locations
This is both a really big and a really small commit. It is small in
that it only contains renaming, moving and modification of include
directives caused by this.

It is really big in the obvious way of touching something like 200
files.

The new rules for naming files is simple: headers use the `.hpp`
extension. The rules for physical file layout is still kinda in
progress, but the basics are also simple:
 * Significant parts of functionality get their own subfolder
   * Benchmarking is in `catch2/benchmark`
   * Matchers are in `catch2/matchers`
   * Generators are in `catch2/generators`
   * Reporters are in `catch2/reporters`
   * Baseline testing facilities are in `catch2/`
 * Various top level folders also contain `internal` subfolder,
   with files that users probably do not want to include directly,
   at least not until they have to write something like their own
   reporter.
    * The exact files in these subfolders is likely to change later
      on

Note that while some includes were cleaned up in this commit, it
is only the low hanging fruit and further cleanup using automatic
tooling will happen later.

Also note that various include guards, copyright notices and file
headers will also be standardized later, rather than in this commit.
2020-04-24 18:58:44 +02: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 Update Catch2-provided pkg-config 2020-03-18 10:51:35 +01:00
data/artwork Move artwork/ to data/artwork/ 2019-12-06 11:36:12 +01:00
docs Update release notes with matcher changes 2020-03-29 14:57:29 +02:00
examples Standardize header names and file locations 2020-04-24 18:58:44 +02: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 Standardize header names and file locations 2020-04-24 18:58:44 +02:00
tests Standardize header names and file locations 2020-04-24 18:58:44 +02:00
third_party Fix vendored dep because upstream is non-responsive 2019-04-10 20:17:25 +02:00
tools Add development build option to CMake and enable it on CI 2020-02-26 16:07:26 +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 Add development build option to CMake and enable it on CI 2020-02-26 16:07:26 +01:00
CMakeLists.txt Update Catch2-provided pkg-config 2020-03-18 10:51:35 +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