onqtam | 7630535 | 2017-05-01 20:25:09 +0300 | [diff] [blame] | 1 | [doctest] |
| 2 | [doctest] boolean values: "1/on/yes/true" or "0/off/no/false" |
| 3 | [doctest] filter values: "str1,str2,str3" (comma separated strings) |
| 4 | [doctest] |
| 5 | [doctest] filters use wildcards for matching strings |
| 6 | [doctest] something passes a filter if any of the strings in a filter matches |
| 7 | [doctest] |
| 8 | [doctest] ALL FLAGS, OPTIONS AND FILTERS ALSO AVAILABLE WITH A "dt-" PREFIX!!! |
| 9 | [doctest] |
| 10 | [doctest] Query flags - the program quits after them. Available: |
| 11 | |
| 12 | -?, --help, -h prints this message |
| 13 | -v, --version prints the version |
| 14 | -c, --count prints the number of matching tests |
| 15 | -ltc, --list-test-cases lists all matching tests by name |
| 16 | -lts, --list-test-suites lists all matching test suites |
onqtam | 2d16073 | 2018-05-21 22:18:05 +0300 | [diff] [blame] | 17 | -lr, --list-reporters lists all registered reporters |
onqtam | 7630535 | 2017-05-01 20:25:09 +0300 | [diff] [blame] | 18 | |
| 19 | [doctest] The available <int>/<string> options/filters are: |
| 20 | |
| 21 | -tc, --test-case=<filters> filters tests by their name |
| 22 | -tce, --test-case-exclude=<filters> filters OUT tests by their name |
| 23 | -sf, --source-file=<filters> filters tests by their file |
| 24 | -sfe, --source-file-exclude=<filters> filters OUT tests by their file |
| 25 | -ts, --test-suite=<filters> filters tests by their test suite |
| 26 | -tse, --test-suite-exclude=<filters> filters OUT tests by their test suite |
| 27 | -sc, --subcase=<filters> filters subcases by their name |
| 28 | -sce, --subcase-exclude=<filters> filters OUT subcases by their name |
onqtam | 2d16073 | 2018-05-21 22:18:05 +0300 | [diff] [blame] | 29 | -r, --reporters=<filters> reporters to use (console is default) |
onqtam | 585bb71 | 2019-03-16 17:46:58 +0200 | [diff] [blame] | 30 | -o, --out=<string> output filename |
onqtam | 7630535 | 2017-05-01 20:25:09 +0300 | [diff] [blame] | 31 | -ob, --order-by=<string> how the tests should be ordered |
Viktor Kirilov | b42592e | 2021-02-02 16:19:30 +0200 | [diff] [blame^] | 32 | <string> - [file/suite/name/rand/none] |
onqtam | 7630535 | 2017-05-01 20:25:09 +0300 | [diff] [blame] | 33 | -rs, --rand-seed=<int> seed for random ordering |
| 34 | -f, --first=<int> the first test passing the filters to |
| 35 | execute - for range-based execution |
| 36 | -l, --last=<int> the last test passing the filters to |
| 37 | execute - for range-based execution |
| 38 | -aa, --abort-after=<int> stop after <int> failed assertions |
| 39 | -scfl,--subcase-filter-levels=<int> apply filters for the first <int> levels |
| 40 | |
| 41 | [doctest] Bool options - can be used like flags and true is assumed. Available: |
| 42 | |
| 43 | -s, --success=<bool> include successful assertions in output |
| 44 | -cs, --case-sensitive=<bool> filters being treated as case sensitive |
| 45 | -e, --exit=<bool> exits after the tests finish |
onqtam | 68d0f1d | 2017-05-07 20:45:09 +0300 | [diff] [blame] | 46 | -d, --duration=<bool> prints the time duration of each test |
onqtam | 7630535 | 2017-05-01 20:25:09 +0300 | [diff] [blame] | 47 | -nt, --no-throw=<bool> skips exceptions-related assert checks |
| 48 | -ne, --no-exitcode=<bool> returns (or exits) always with success |
| 49 | -nr, --no-run=<bool> skips all runtime doctest operations |
| 50 | -nv, --no-version=<bool> omit the framework version in the output |
| 51 | -nc, --no-colors=<bool> disables colors in output |
| 52 | -fc, --force-colors=<bool> use colors even when not in a tty |
| 53 | -nb, --no-breaks=<bool> disables breakpoints in debuggers |
onqtam | 6c7369e | 2017-05-05 11:51:10 +0300 | [diff] [blame] | 54 | -ns, --no-skip=<bool> don't skip test cases marked as skip |
onqtam | 1655b24 | 2018-05-10 15:29:21 +0300 | [diff] [blame] | 55 | -gfl, --gnu-file-line=<bool> :n: vs (n): for line numbers in output |
onqtam | 7630535 | 2017-05-01 20:25:09 +0300 | [diff] [blame] | 56 | -npf, --no-path-filenames=<bool> only filenames and no paths in output |
| 57 | -nln, --no-line-numbers=<bool> 0 instead of real line numbers in output |
| 58 | |
| 59 | [doctest] for more information visit the project documentation |
| 60 | |