Test coverage reporting

Use this plugin to activate coverage report.

To use this plugin, you need to install nose2[coverage_plugin]. e.g.

$ pip install nose2[coverage_plugin]>=0.6.5

Then, you can enable coverage reporting with :

$ nose2 --with-coverage

Or with this lines in unittest.cfg :

[coverage]
always-on = True

Configuration [coverage]

always-on
Default:False
Type:boolean
coverage
Default:[]
Type:list
coverage-config
Default:
Type:str
coverage-report
Default:[]
Type:list

Sample configuration

The default configuration is equivalent to including the following in a unittest.cfg file.

[coverage]
always-on = False
coverage = 
coverage-config = 
coverage-report = 

Command-line options

--coverage PATH

Measure coverage for filesystem path (multi-allowed)

--coverage-report TYPE

Generate selected reports, available types: term, term-missing, annotate, html, xml (multi-allowed)

--coverage-config FILE

Config file for coverage, default: .coveragerc

-C DEFAULT, --with-coverage DEFAULT

Turn on coverage reporting

Plugin class reference: Coverage

class nose2.plugins.coverage.Coverage[source]
afterSummaryReport(event)[source]

Only called if active so stop coverage and produce reports.

createTests(event)[source]

Start coverage early to catch imported modules.

Only called if active so, safe to just start without checking flags

handleArgs(event)[source]

Get our options in order command line, config file, hard coded.