pysys.launcher package

Module contents

Contains utilities used by test launchers when running, printing, cleaning or making new tests.

The module includes the pysys.launcher.createDescriptors method which locates test descriptors based upon a given starting location on the file system, the chosen range of test ids, the test type, the specified requirements, and the include and exclude lists.

Utilities defined in the module can be used by any launchers, either distributed with the framework, or created as an extension to it. Currently the framework distributes the console launcher module only - see pysys.launcher.console. This module uses the current working directory in a command shell as the starting location on the file system, and provides utilities for parsing command line arguments in order to launch operations against a set of tests etc.

pysys.launcher.createDescriptors(testIdSpecs, type, includes, excludes, trace, dir=None)[source]

Create a list of descriptor objects representing a set of tests to run, returning the list.

Parameters:
  • testIdSpecs – A list of strings specifying the set of testcase identifiers
  • type – The type of the tests to run (manual | auto)
  • includes – A list of test groups to include in the returned set
  • excludes – A list of test groups to exclude in the returned set
  • trace – A list of requirements to indicate tests to include in the returned set
  • dir – The parent directory to search for runnable tests
Returns:

List of pysys.xml.descriptor.XMLDescriptorContainer objects
Return type:

list
Raises:

Exception – Raised if not testcases can be found or are returned by the requested input parameters