OS Manuals

/opt/chainguard/openstack-tempest-2026.1/bin/subunit-filter

OpenStack integration test runner — 2026.1 Gazpacho (with keystone/neutron/glance/cinder plugins)

From openstack-tempest-2026.1 46.2.0-r19 (enterprise-packages), captured 2026-11-08 by running subunit-filter --help (exit 0). permalink

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 substitutions to test names.
Options (19)
OptionDescriptionSource
--with expressionsFor case-insensitive matching prependhelp
-h, --helpshow this help message and exithelp
--errorinclude errorshelp
-e, --no-errorexclude errorshelp
--failureinclude failureshelp
-f, --no-failureexclude failureshelp
--passthroughForward non-subunit input as 'stdout'.help
--no-passthroughDiscard all non subunit input.help
-s, --successinclude successeshelp
--no-successexclude successeshelp
--no-skipexclude skipshelp
--xfailinclude expected failureshelp
--no-xfailexclude expected failureshelp
--with-tag WITH_TAGSinclude tests with these tagshelp
--without-tag WITHOUT_TAGSexclude tests with these tagshelp
--fixup-expected-failures FIXUP_EXPECTED_FAILURESFile with list of test ids that are expected to fail;help
--without WITHOUT_REGEXPSregexp to exclude (case-sensitive by default)help
-F, --only-genuine-failuresOnly pass through failures and exceptions.help
--rename RENAMESApply specified regex substitutions 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.