Catch has a modular reporting system and comes bundled with a handful of useful reporters built in. You can also write your own reporters.
The reporter to use can easily be controlled from the command line. To specify a reporter use
--reporter, followed by the name of the reporter, e.g.:
If you don't specify a reporter then the console reporter is used by default. There are four reporters built in to the single include:
consolewrites as lines of text, formatted to a typical terminal width, with colours if a capable terminal is detected.
consolebut optimised for minimal output - each entry on one line
junitwrites xml that corresponds to Ant's junitreport target. Useful for build systems that understand Junit. Because of the way the junit format is structured the run must complete before anything is written.
xmlwrites an xml format tailored to Catch. Unlike
junitthis is a streaming format so results are delivered progressively.
There are a few additional reporters, for specific build systems, in the Catch repository (in
include\reporters) which you can
#include in your project if you would like to make use of them. Do this in one source file - the same one you have
teamcitywrites the native, streaming, format that TeamCity understands. Use this when building as part of a TeamCity build to see results as they happen (code example).
tapwrites in the TAP (Test Anything Protocol) format.
automakewrites in a format that correspond to automake .trs files
You see what reporters are available from the command line by running with
By default all these reports are written to stdout, but can be redirected to a file with
You can write your own custom reporter and register it with Catch. At time of writing the interface is subject to some changes so is not, yet, documented here. If you are determined you shouldn't have too much trouble working it out from the existing implementations - but do keep in mind upcoming changes (these will be minor, simplifying, changes such as not needing to forward calls to the base class).