OS Manuals

/opt/chainguard/openstack-tempest-2025.1/bin/stestr

OpenStack integration test runner — 2025.1 Epoxy (with keystone/neutron/glance/cinder plugins)

From openstack-tempest-2025.1 43.0.0-r15 (enterprise-packages), captured 2026-11-08 by running stestr --help (exit 0). permalink

usage: stestr [--version] [-v | -q] [--log-file LOG_FILE] [-h] [--debug]
              [--user-config USER_CONFIG] [-d HERE] [--config CONFIG] [--repo-url REPO_URL]
              [--test-path TEST_PATH] [--top-dir TOP_DIR] [--group-regex GROUP_REGEX]
              [--parallel-class]

A parallel Python test runner built around subunit

options:
  --version             show program's version number and exit
  -v, --verbose         Increase verbosity of output. Can be repeated.
  -q, --quiet           Suppress output except warnings and errors.
  --log-file LOG_FILE   Specify a file to log output. Disabled by default.
  -h, --help            Show help message and exit.
  --debug               Show tracebacks on errors.
  --user-config USER_CONFIG
                        An optional path to a default user config file if one is not specified
                        ~/.stestr.yaml and ~/.config/stestr.yaml will be tried in that order
  -d HERE, --here HERE  Set the directory or url that a command should run from. This affects all
                        default path lookups but does not affect paths supplied to the command.
  --config CONFIG, -c CONFIG
                        Set a stestr config file to use with this command. If one isn't specified
                        then .stestr.conf in the directory that a command is running from is used
  --repo-url REPO_URL, -u REPO_URL
                        Set the repo url to use. This should just be the path to the stestr
                        repository directory
  --test-path TEST_PATH, -t TEST_PATH
                        Set the test path to use for unittest discovery. If both this and the
                        corresponding config file option are set, this value will be used.
  --top-dir TOP_DIR     Set the top dir to use for unittest discovery. If both this and the
                        corresponding config file option are set, this value will be used.
  --group-regex GROUP_REGEX, --group_regex GROUP_REGEX, -g GROUP_REGEX
                        Set a group regex to use for grouping tests together in the stestr
                        scheduler. If both this and the corresponding config file option are set
                        this value will be used.
  --parallel-class, -p  Set the flag to group tests by class. NOTE: This flag takes priority over
                        the `--group-regex` option even if it's set.

Commands:
  complete       print bash completion command (cliff)
  failing        Show the current failures known by the repository
  help           print detailed help for another command (cliff)
  history list   List the the run history in a repository
  history remove  Remove a run from the history
  history show   Show the contents of a single run in the history
  init           Create a new repository
  last           Show the last run loaded into a repository
  list           List the tests for a project
  load           Load a subunit stream into a repository
  run            Run the tests for a project and store them into the repository
  slowest        Show the slowest tests from the last test run
Options (10)
OptionDescriptionSource
--versionshow program's version number and exithelp
-v, --verboseIncrease verbosity of output.help
-q, --quietSuppress output except warnings and errors.help
--log-file LOG_FILESpecify a file to log output.help
-h, --helpShow help message and exit.help
--debugShow tracebacks on errors.help
--user-config USER_CONFIGAn optional path to a default user config file if one is not specified ~/.stestr.yaml and ~/.config/stestr.yaml will be tried in that orderhelp
-d, --here HERESet the directory or url that a command should run from.help
--top-dir TOP_DIRSet the top dir to use for unittest discovery.help
--parallel-class, -pSet the flag to group tests by class.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.