API Reference

Test runner

zope.testrunner.run(defaults=None, args=None, script_parts=None, cwd=None, warnings=None)[source]

Main runner function which can be and is being used from main programs.

Will execute the tests and exit the process according to the test result.

Changed in version 4.8.0: Add the warnings keyword argument. See zope.testrunner.runner.Runner

zope.testrunner.run_internal(defaults=None, args=None, script_parts=None, cwd=None, warnings=None)[source]

Execute tests.

Returns whether errors or failures occured during testing.

Changed in version 4.8.0: Add the warnings keyword argument. See zope.testrunner.runner.Runner

class zope.testrunner.runner.Runner(defaults=None, args=None, found_suites=None, options=None, script_parts=None, cwd=None, warnings=None)[source]

Bases: object

The test runner.

It is the central point of this package and responsible for finding and executing tests as well as configuring itself from the (command-line) options passed into it.

Changed in version 4.8.0: Add the warnings keyword argument. If this is None (the default) and the user hasn’t configured Python otherwise with command-line arguments or environment variables, we will enable the default warnings, including DeprecationWarning, when running tests. Otherwise, it can be any string acceptable to warnings.simplefilter() and that filter will be in effect while running tests.


Registers tests.


Run all tests that were registered.

Returns True if there where failures or False if all tests passed.

Add unit and functional testing support to setuptools-driven eggs.

zope.testrunner.eggsupport.skipLayers(suite, _result=None)[source]

Walk the suite returned by setuptools’ testloader.

o Skip any tests which have a ‘layer’ defined.

class zope.testrunner.eggsupport.SkipLayers[source]

Bases: setuptools.command.test.ScanningLoader

Load only unit tests (those which have no layer associated with them).

  • Running the tests using ‘setup.py test’ cannot, by default, drive the full testrunner, with its support for layers (in functional tests). This loader allows the command to work, by running only those tests which don’t need the layer support.

  • To run layer-dependent tests, use ‘setup.py ftest’ (see below for adding the command to your setup.py).

  • To use this loader your package add the following your ‘setup()’ call:

            'eggtestinfo' # captures testing metadata in EGG-INFO
        tests_require=['zope.testrunner', ],

Return a suite of all tests cases contained in the given module

If the module is a package, load tests from all the modules in it. If the module has an additional_tests function, call it and add the return value to the tests.

loadTestsFromNames(testNames, module)[source]

Return a suite of all test cases found using the given sequence of string specifiers. See ‘loadTestsFromName()’.

class zope.testrunner.eggsupport.ftest(dist, **kw)[source]

Bases: setuptools.command.test.test

Run unit and functional tests after an in-place build.

  • Note that this command runs all tests (unit and functional).

  • This command does not provide any of the configuration options which the usual testrunner provided by ‘zope.testrunner’ offers: it is intended to allow easy verification that a package has been installed correctly via setuptools, but is not likely to be useful for developers working on the package.

  • Developers working on the package will likely prefer to work with the stock testrunner, e.g., by using buildout with a recipe which configures the testrunner as a standalone script.

  • To use this in your package add the following to the ‘entry_points’ section:

            'eggtestinfo' # captures testing metadata in EGG-INFO

Construct the command for dist, updating vars(self) with any keyword parameters.