blob: 535ac6ecdd845de5c7aba58dfde43e616354b7bd [file] [log] [blame] [view]
Martin Moenee8225052017-08-24 15:21:36 +02001<a id="top"></a>
Phil Nash3a4c7652017-11-07 11:25:03 +00002![catch logo](artwork/catch2-logo-small.png)
Phil Nash22b79212013-03-21 19:21:41 +00003
Phil Nash07ac9b92017-11-07 18:50:55 +00004[![Github Releases](https://img.shields.io/github/release/catchorg/catch2.svg)](https://github.com/catchorg/catch2/releases)
Martin Hořeňovský0cf05d52017-12-08 21:47:42 +01005[![Build Status](https://travis-ci.org/catchorg/Catch2.svg?branch=master)](https://travis-ci.org/catchorg/Catch2)
Martin Hořeňovský11887fb2017-12-08 21:35:47 +01006[![Build status](https://ci.appveyor.com/api/projects/status/github/catchorg/Catch2?svg=true)](https://ci.appveyor.com/project/catchorg/catch2)
Martin Hořeňovský39798452017-12-11 13:06:01 +01007[![codecov](https://codecov.io/gh/catchorg/Catch2/branch/master/graph/badge.svg)](https://codecov.io/gh/catchorg/Catch2)
Martin Hořeňovský7c375012019-04-22 23:15:59 +02008[![Try online](https://img.shields.io/badge/try-online-blue.svg)](https://wandbox.org/permlink/rsEsNO9M0flb5NlQ)
Martin Hořeňovskýe69c7ce2018-07-01 20:48:21 +02009[![Join the chat in Discord: https://discord.gg/4CWS9zD](https://img.shields.io/badge/Discord-Chat!-brightgreen.svg)](https://discord.gg/4CWS9zD)
10
Kosta7fcde922013-08-05 14:50:14 +020011
Martin Hořeňovský7c375012019-04-22 23:15:59 +020012<a href="https://github.com/catchorg/Catch2/releases/download/v2.7.2/catch.hpp">The latest version of the single header can be downloaded directly using this link</a>
Phil Nashd8e3c1f2014-12-09 19:07:48 +000013
Phil Nashcf76a792017-11-03 13:18:26 +000014## Catch2 is released!
15
Martin Hořeňovskýcd76f572018-01-10 13:53:04 +010016If you've been using an earlier version of Catch, please see the
Phil Nash53f6d3f2017-11-03 13:31:59 +000017Breaking Changes section of [the release notes](https://github.com/catchorg/Catch2/releases/tag/v2.0.1)
Clare Macrae0424c9a2019-03-08 08:56:00 +000018before moving to Catch2. You might also like to read [this blog post](https://levelofindirection.com/blog/catch2-released.html) for more details.
Phil Nashcf76a792017-11-03 13:18:26 +000019
Phil Nash130ec982013-06-03 20:03:39 +010020## What's the Catch?
Phil Nash2f92db92012-10-28 12:15:34 +000021
Phil Nash7423a482017-11-03 13:05:09 +000022Catch2 stands for C++ Automated Test Cases in a Header and is a
Phil Nash0b52dbe2017-08-17 08:28:45 +010023multi-paradigm test framework for C++. which also supports Objective-C
Phil Nash7423a482017-11-03 13:05:09 +000024(and maybe C).
Phil Nash0b52dbe2017-08-17 08:28:45 +010025It is primarily distributed as a single header file, although certain
26extensions may require additional headers.
Phil Nash130ec982013-06-03 20:03:39 +010027
28## How to use it
29This documentation comprises these three parts:
30
Martin Moene6c09b452017-08-24 15:33:38 +020031* [Why do we need yet another C++ Test Framework?](docs/why-catch.md#top)
32* [Tutorial](docs/tutorial.md#top) - getting started
33* [Reference section](docs/Readme.md#top) - all the details
Phil Nash130ec982013-06-03 20:03:39 +010034
Phil Nash130ec982013-06-03 20:03:39 +010035## More
Phil Nash7423a482017-11-03 13:05:09 +000036* Issues and bugs can be raised on the [Issue tracker on GitHub](https://github.com/catchorg/Catch2/issues)
Martin Hořeňovskýe69c7ce2018-07-01 20:48:21 +020037* For discussion or questions please use [the dedicated Google Groups forum](https://groups.google.com/forum/?fromgroups#!forum/catch-forum) or our [Discord](https://discord.gg/4CWS9zD)
Phil Nash7423a482017-11-03 13:05:09 +000038* See [who else is using Catch2](docs/opensource-users.md#top)