Added reporters

Updated Command line (markdown)
philsquared
2010-12-30 01:10:12 -08:00
parent 2f5924a012
commit 532dedf26d

@@ -1,5 +1,9 @@
## Specifying which tests to run ## Specifying which tests to run
<pre>
-t, --test &lt;test-spec> [&lt;test-spec> ...]
</pre>
If you don't specify any tests on the command line then all registered tests are run. If you don't specify any tests on the command line then all registered tests are run.
Alternative use -t or --test to specify which tests to run. This option takes 1-n arguments, each of which specify a test case name or a pattern the matches any number of test case names. In general these are referred to as test specs. Quotes are optional for test specs, unless there are spaces, in which case they are required. Some examples: Alternative use -t or --test to specify which tests to run. This option takes 1-n arguments, each of which specify a test case name or a pattern the matches any number of test case names. In general these are referred to as test specs. Quotes are optional for test specs, unless there are spaces, in which case they are required. Some examples:
@@ -8,3 +12,21 @@ Alternative use -t or --test to specify which tests to run. This option takes 1-
-t example/stupid example/silly -t example/stupid example/silly
-t example/group/* -t example/group/*
</pre> </pre>
## Choosing a reporter to use
<pre>
-r, --report &lt;reporter>
</pre>
A reporter is an object that formats and structures the output of running tests, and potentially summaries the results. By default a basic reporter is used that writes IDE friendly results. CATCH comes bundled with some alternative reporters, but more can be added in client code.<br />
The bundled reporters are:
<pre>
-r basic
-r xml
-r junit
</pre>
The JUnit reporter is an xml format that follows the structure of the JUnit XML Report ANT task, as consumed by a number of third-party tools, including Continuous Integration servers such as Hudson. If not otherwise needed, the standard XML reporter is preferred as this is a streaming reporter, whereas the Junit reporter needs to hold all its results until the end so it can write the overall results into attributes of the root node.