This module contains the definition of the TestListingFixture fixture class. This fixture is used for handling the actual spawning of worker processes for running tests, or listing tests. It is constructed as a fixture to handle the lifecycle of the test id list files which are used to pass test ids to the workers processes running the tests.
In the normal workflow a TestListingFixture get’s returned by the Configuration File Module‘s get_run_command() function. The config file parses the config file and the cli options to create a TestListingFixture with the correct options. This Fixture then gets returned to the CLI commands to enable them to run the commands.
The TestListingFixture class is written to be fairly generic in the command it’s executing. This is an artifact of being forked from testrepository where the test command is defined in the configuration file. In stestr the command is hard coded stestr.config_file module so this extra flexibility isn’t really needed.