coverage module

The most important thing in the coverage module is the coverage.Coverage class, described in The Coverage class, but there are a few other things also.

coverage.version_info

A tuple of five elements, similar to sys.version_info: major, minor, micro, releaselevel, and serial. All values except releaselevel are integers; the release level is 'alpha', 'beta', 'candidate', or 'final'. Unlike sys.version_info, the elements are not available by name.

coverage.__version__

A string with the version of coverage.py, for example, "5.0b2".

exception coverage.CoverageException(*args, slug=None)

The base class of all exceptions raised by Coverage.py.

Parameters:
  • args (Any)

  • slug (str | None)

Return type:

None

Starting coverage.py automatically

This function is used to start coverage measurement automatically when Python starts. See Managing processes for details.

coverage.process_startup(*, force=False)

Call this at Python start-up to perhaps measure coverage.

If the environment variable COVERAGE_PROCESS_START is defined, coverage measurement is started. The value of the variable is the config file to use.

For details, see https://coverage.readthedocs.io/en/latest/subprocess.html.

Returns the Coverage instance that was started, or None if it was not started by this call.

Parameters:

force (bool)

Return type:

Coverage | None