PyCharm 2019.2 Help

Configuring code coverage measurement

PyCharm makes it possible to configure the various aspects of code coverage measurement. In this section:

Configure code coverage behavior

  1. In the Settings/Preferences dialog Ctrl+Alt+S, click Coverage under Build, Execution, Deployment.

  2. Define how the collected coverage data will be processed:

    • To have the Code Coverage dialog shown every time you launch a new run configuration with code coverage, choose Show options before applying coverage to the editor.

    • To discard the new code coverage results, choose Do not apply collected coverage.

    • To discard the active suites and use the new one every time you launch a new run configuration with code coverage, choose Replace active suites with the new one.

    • To have the new code coverage suite appended to the active suites every time you launch a new run configuration with code coverage, choose Add to the active suites.

  3. Define the behaviour of the Coverage tool window when an application or test is run with coverage:

    • To have the Coverage tool window opened automatically, select the Activate Coverage View checkbox.

    • To open the Coverage tool window manually, clear the Activate Coverage View checkbox.

  4. Select the checkbox to specify which of the coverage tools you want to use - the one bundled with PyCharm, or included in the active Python interpreter.

  5. Select the checkbox to specify whether you want to use the branch coverage. Thus additional information to the pure line coverage reports is added, marking the coverage of lines with conditional statements as incomplete in case one or more branches haven’t been executed.

    py branch coverage

Configure code coverage colors

  1. In the Settings/Preferences dialog Ctrl+Alt+S, navigate to Editor | Color Scheme | General.

  2. In the list of components, expand the Line Coverage node and select a type of coverage: for example, Full, Partial or Uncovered. Click the Foreground field to open the Select Color dialog. Select a color and click Apply.

    Configure code coverage colors

Last modified: 21 August 2019

See Also