Function instantiate_test_subclass

Web/Python/vtkmodules/web/testing.py:604–637

This function takes the fully qualified path to a test file, along with any needed keyword arguments, then dynamically loads the file as a module and finds the test class defined inside of it via inspection. It then uses the keyword arguments to instantiate the test class and retur

(pathToScript, **kwargs)

# documentation to help people avoid that.
# =============================================================================
def instantiate_test_subclass(pathToScript, **kwargs):
    """
    This function takes the fully qualified path to a test file, along with
    any needed keyword arguments, then dynamically loads the file as a module
    and finds the test class defined inside of it via inspection.  It then
    uses the keyword arguments to instantiate the test class and return the
    instance.

        pathToScript: Fully qualified path to python file containing defined
        subclass of one of the test base classes.
        kwargs: Keyword arguments to be passed to the constructor of the
        testing subclass.
    """

    # Load the file as a module
    moduleName = imp.load_source("dynamicTestModule", pathToScript)
    instance = None

    # Inspect dynamically loaded module members
    for name, obj in inspect.getmembers(moduleName):
        # Looking for classes only
        if inspect.isclass(obj):
            instance = obj.__new__(obj)
            # And only classes defined in the dynamically loaded module
            if instance.__module__ == "dynamicTestModule":
                try:
                    instance.__init__(**kwargs)
                    break
                except Exception as inst:
                    print("Caught exception: " + str(type(inst)))
                    print(inst)
                    raise

    return instance


# =============================================================================