Usage: subunit-filter [options]
Filter a subunit stream to include/exclude tests. The default is to strip successful tests.
Tests can be filtered by Python regular expressions with --with and --without, which match both
the test name and the error text (if any). The result contains tests which match any of the
--with expressions and none of the --without expressions. For case-insensitive matching prepend
'(?i)'. Remember to quote shell metacharacters.
Options:
-h, --help show this help message and exit
--error include errors
-e, --no-error exclude errors
--failure include failures
-f, --no-failure exclude failures
--passthrough Forward non-subunit input as 'stdout'.
--no-passthrough Discard all non subunit input.
-s, --success include successes
--no-success exclude successes
--no-skip exclude skips
--xfail include expected failures
--no-xfail exclude expected failures
--with-tag=WITH_TAGS include tests with these tags
--without-tag=WITHOUT_TAGS
exclude tests with these tags
-m WITH_REGEXPS, --with=WITH_REGEXPS
regexp to include (case-sensitive by default)
--fixup-expected-failures=FIXUP_EXPECTED_FAILURES
File with list of test ids that are expected to fail; on failure their
result will be changed to xfail; on success they will be changed to error.
--without=WITHOUT_REGEXPS
regexp to exclude (case-sensitive by default)
-F, --only-genuine-failures
Only pass through failures and exceptions.
--rename=RENAMES Apply specified regex subsitutions to test names.
Options (19)
| Option | Description | Source |
|---|
--with expressions | For case-insensitive matching prepend | help |
-h, --help | show this help message and exit | help |
--error | include errors | help |
-e, --no-error | exclude errors | help |
--failure | include failures | help |
-f, --no-failure | exclude failures | help |
--passthrough | Forward non-subunit input as 'stdout'. | help |
--no-passthrough | Discard all non subunit input. | help |
-s, --success | include successes | help |
--no-success | exclude successes | help |
--no-skip | exclude skips | help |
--xfail | include expected failures | help |
--no-xfail | exclude expected failures | help |
--with-tag WITH_TAGS | include tests with these tags | help |
--without-tag WITHOUT_TAGS | exclude tests with these tags | help |
--fixup-expected-failures FIXUP_EXPECTED_FAILURES | File with list of test ids that are expected to fail; | help |
--without WITHOUT_REGEXPS | regexp to exclude (case-sensitive by default) | help |
-F, --only-genuine-failures | Only pass through failures and exceptions. | help |
--rename RENAMES | Apply specified regex subsitutions to test names. | 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.