Module base

Return the directories to search for QMTest extensions.

'kind' -- A string giving kind of extension for which we are looking.
This must be of the elements of 'extension_kinds'.

'database' -- The 'Database' with which the extension class will be
used, or 'None'.

'database_path' -- The path from which the database will be loaded.
If 'None', 'database.GetPath()' is used.

returns -- A sequence of strings.  Each string is the path to a
directory that should be searched for QMTest extensions.  The
directories must be searched in order; the first directory
containing the desired module is the one from which the module is
loaded.

The directories that are returned are, in order:

1. Those directories present in the 'QMTEST_CLASS_PATH' environment
   variable.

2. Those directories specified by the 'GetClassPaths' method on the
   test database -- unless 'kind' is 'database'.

3. The directory specified by config.extension_path.

4. The directories containing classes that come with QMTest.

By placing the 'QMTEST_CLASS_PATH' directories first, users can
override test classes with standard names.

Return the names of QMTest extension classes in 'directory'.

'directory' -- A string giving the path to a directory in the file system.

returns -- A dictionary mapping the strings in 'extension_kinds' to sequences of strings. Each element in the sequence names an extension class, using the form 'module.class'

Return the names of extension classes.

'kind' -- The kind of extension class. This value must be one of the 'extension_kinds'.

'database' -- The 'Database' with which the extension class will be used, or 'None' if 'kind' is 'database'.

'database_path' -- The path from which the database will be loaded. If 'None', 'database.GetPath()' is used.

returns -- A sequence of strings giving the names of the extension classes with the indicated 'kind', in the form 'module.class'.

Load an extension class from 'directory'.

'class_name' -- The name of the extension class, in the form 'module.class'.

'kind' -- The kind of class to load. This value must be one of the 'extension_kinds'.

'directory' -- The directory from which to load the class.

'path' -- The directories to search for modules imported by the new module.

returns -- The class loaded.

Return the extension class named 'class_name'.

'class_name' -- The name of the class, in the form 'module.class'.

'kind' -- The kind of class to load. This value must be one of the 'extension_kinds'.

'database' -- The 'Database' with which the extension class will be used, or 'None' if 'kind' is 'database'.

'database_path' -- The path from which the database will be loaded. If 'None', 'database.GetPath()' is used.

returns -- The class object with the indicated 'class_name'.

Return the test class named 'class_name'.

'class_name' -- The name of the test class, in the form 'module.class'.

returns -- The test class object with the indicated 'class_name'.

Return the resource class named 'class_name'.

'class_name' -- The name of the resource class, in the form 'module.class'.

returns -- The resource class object with the indicated 'class_name'.

Return the extension classes for the given 'kind'.

'kind' -- The kind of extensions being sought. The value must be one of the 'extension_kinds'.

'database' -- If not 'None', the test 'Database' in use.

returns -- A list of the available extension classes of the indicated 'kind'.

Read test results from a file.

'file' -- The filename or file object from which to read the results. If 'file' is not a string, then it is must be a seekable file object, and this function will look for a 'FileResultReader' that accepts the file. If 'file' is a string, then it is treated as either a filename or as an extension descriptor.

'database' -- The current database.

returns -- A 'ResultReader' object, or raises an exception if no appropriate reader is available.

Read expectations from a file.

'file' -- The filename or file object from which to read the expectations. If 'file' is not a string, then it is must be a seekable file object, and this function will look for an 'ExpectationDatabase' that accepts the file. If 'file' is a string, then it is treated as either a filename or as an extension descriptor.

'database' -- The current database.

'annotations' -- Annotations for the current test run.

returns -- An 'ExpectationDatabase' object, or raises an exception if no appropriate reader is available.

Load test outcomes from a file.

'file' -- The file object from which to read the results. See 'load_results' for details.

'database' -- The current database.

returns -- A map from test IDs to outcomes.