catchorg/Catch2
1
0
Fork 1
mirror of https://github.com/catchorg/Catch2.git synced 2025-08-10 08:04:44 +02:00
Code Issues Packages Projects Releases Wiki Activity

Updated test case option

philsquared
2012-09-04 12:15:30 -07:00
parent cea88c19ba
commit 94e716f795
1 changed files with 34 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
Command-line.md

@@ -5,16 +5,16 @@ Note that options are described according to the following pattern:
*<description>* *<description>*
<a href="#usage"> <pre>-h, -?, --help</pre></a> <a href="#usage"> `-h, -?, --help`</a><br />
<a href="#nothrow"> <pre>-n, --nothrow</pre></a> <a href="#nothrow"> `-n, --nothrow`</a><br />
<a href="#test"> <pre>-t, --test</pre></a> <a href="#test"> `-t, --test`</a><br />
<a href="#reporter"> <pre>-r, --reporter</pre></a> <a href="#reporter"> `-r, --reporter`</a><br />
<a href="#break"> <pre>-b, --break</pre></a> <a href="#break"> `-b, --break`</a><br />
<a href="#success"> <pre>-s, --success</pre></a> <a href="#success"> `-s, --success`</a><br />
<a href="#abort"> <pre>-a, --abort</pre></a> <a href="#abort"> `-a, --abort`</a><br />
<a href="#list"> <pre>-l, --list</pre></a> <a href="#list"> `-l, --list`</a><br />
<a href="#output"> <pre>-o, --out</pre></a> <a href="#output"> `-o, --out`</a><br />
<a href="#name"> <pre>-n, --name</pre></a> <a href="#name"> `-n, --name`</a><br />
<a name="usage" /> <a name="usage" />
## Usage ## Usage
@@ -31,13 +31,32 @@ Prints the command line arguments to stdout
-t, --test &lt;test-spec> [&lt;test-spec> ...] -t, --test &lt;test-spec> [&lt;test-spec> ...]
</pre> </pre>
If you don't specify any tests on the command line then all registered tests are run. This option allows one ore more test specs to be supplied. Each spec either fully specifies a
Alternatively use -t or --test to specify which tests to run. This option takes 1-n arguments (you can also supply the option as many times as you like), each of which specify a test case name or a pattern that 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: test case or is a pattern containing wildcards to match a set of test cases. If this option
is not provided then all test cases, except those prefixed by `'./'` are run
Specs must be enclosed in "quotes" if they contain spaces. If they do not contain spaces
the quotes are optional.
Wildcards consist of the * character at the beginning, end, or both and can substitute for
any number of any characters (including none)
If spec is prefixed with `exclude:` or the `~` character then the pattern matches an exclusion.
This means that tests matching the pattern are excluded from the set - even if a prior
inclusion spec included them. Subsequent inclusion specs will take precendence, however.
Inclusions and exclusions are evaluated in left-to-right order.
Examples:
<pre> <pre>
-t "example/first test" -t thisTestOnly Matches the test case called, 'thisTestOnly'
-t example/stupid example/silly -t "this test only" Matches the test case called, 'this test only'
-t example/group/* -t these/* Matches all cases starting with 'these/'
-t exclude:notThis Matches all tests except, 'notThis'
-t ~:notThis Matches all tests except, 'notThis'
-t ~*private* Matches all tests except those that contain 'private'
-t a/* ~a/b/* a/b/c Matches all tests that start with 'a/', except those that
start with 'a/b/', except 'a/b/c', which is included
</pre> </pre>
<a name="reporter" /> <a name="reporter" />