Usage: btest [options] <directories>
Options:
--version show program's version number and exit
-h, --help show this help message and exit
-U, --update-baseline
create a new baseline from the tests' output
-u, --update-interactive
interactively asks whether to update baseline for a failed test
-d, --diagnostics show diagnostic output for failed tests
-D, --diagnostics-all
show diagnostic output for ALL tests
-f DIAGFILE, --file-diagnostics=DIAGFILE
write diagnostic output for failed tests into file; if file exists, it is
overwritten
-v, --verbose show commands as they are executed
-w, --wait wait for <enter> after each failed (with -d) or all (with -D) tests
-b, --brief outputs only failed tests
-c CONFIG, --config=CONFIG
configuration file
-t, --tmp-keep do not delete tmp files created for running tests
-j, --jobs number of threads running tests in parallel; with no argument will use all
CPUs
-g GROUPS, --groups=GROUPS
execute only tests of given comma-separated list of groups
-r, --rerun execute commands for tests that failed last time
-q, --quiet suppress information output other than about failed tests
-x XMLFILE, --xml=XMLFILE
write a report of test results in JUnit XML format to file; if file
exists, it is overwritten
-a ALTERNATIVES, --alternative=ALTERNATIVES
activate given alternative
-S, --sphinx indicates that we're running from inside Sphinx; for internal purposes
-T, --update-times create a new timing baseline for tests being measured
-R format, --documentation=format
Output documentation for tests, supported formats: rst, md
-A, --show-all For console output, show one-liners for passing/skipped tests in addition
to any failing ones
-z RETRIES, --retries=RETRIES
Retry failed tests this many times to determine if they are unstable
--trace-file=TRACEFILE
write Chrome tracing file to file; if file exists, it is overwritten
-F, --abort-on-failure
terminate after first test failure
-l, --list list available tests instead of executing them
-s DEFAULTS, --set=DEFAULTS
Override default key used in btest.cfg with another value. Can be
specified multiple times.
-i TESTS_FILE, --tests-file=TESTS_FILE
Load list of tests to execute from file.
-P, --progress-bar display progress bar using OSC 9;4 escape sequences (set
BTEST_OSC94_PROGRESS to permanently enable)
Options (29)
| Option | Description | Source |
|---|
--version | show program's version number and exit | help |
-h, --help | show this help message and exit | help |
-U, --update-baseline | create a new baseline from the tests' output | help |
-u, --update-interactive | interactively asks whether to update baseline for a failed test | help |
-d, --diagnostics | show diagnostic output for failed tests | help |
-D, --diagnostics-all | show diagnostic output for ALL tests | help |
-f, --file-diagnostics DIAGFILE | write diagnostic output for failed tests into file; | help |
-v, --verbose | show commands as they are executed | help |
-w, --wait | wait for <enter> after each failed (with -d) or all (with -D) tests | help |
-b, --brief | outputs only failed tests | help |
-c, --config CONFIG | configuration file | help |
-t, --tmp-keep | do not delete tmp files created for running tests | help |
-j, --jobs | number of threads running tests in parallel; | help |
-g, --groups GROUPS | execute only tests of given comma-separated list of groups | help |
-r, --rerun | execute commands for tests that failed last time | help |
-q, --quiet | suppress information output other than about failed tests | help |
-x, --xml XMLFILE | write a report of test results in JUnit XML format to file; | help |
-a, --alternative ALTERNATIVES | activate given alternative | help |
-S, --sphinx | indicates that we're running from inside Sphinx; | help |
-T, --update-times | create a new timing baseline for tests being measured | help |
-R, --documentation format | Output documentation for tests, supported formats: rst, md | help |
-A, --show-all | For console output, show one-liners for passing/skipped tests in addition to any failing ones | help |
-z, --retries RETRIES | Retry failed tests this many times to determine if they are unstable | help |
--trace-file TRACEFILE | write Chrome tracing file to file; | help |
-F, --abort-on-failure | terminate after first test failure | help |
-l, --list | list available tests instead of executing them | help |
-s, --set DEFAULTS | Override default key used in btest.cfg with another value. | help |
-i, --tests-file TESTS_FILE | Load list of tests to execute from file. | help |
-P, --progress-bar | display progress bar using OSC 9;4 escape sequences (set BTEST_OSC94_PROGRESS to permanently enable) | help |
Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.