PyCharm 2018.1 Help

Code Coverage

Basics

Code coverage in PyCharm allows you to perform on-the-fly line coverage measuring for your code with low runtime overhead. In general, line coverage answers the question, "Was this line of code executed during unit testing simulation?"

Code coverage results are reflected in the dedicated Coverage tool window, in the Project view of the Project Tool Window, and in the editor. The tool windows show the following information:

  • For a directory: the percentage of the covered classes and lines.
  • For a file: the percentage of the covered lines.

When a file is opened in the editor, each line is highlighted with regard to its code coverage status:

  • Lines executed during simulation are marked green.
  • Lines not executed during simulation are marked red.

The coverage measurement results comprise a coverage suite. You can have the results of a new simulation merged with any existing suite. In this case, a line will be considered covered if it is covered by at least one of the simulations.

A coverage suite is generated every time a test or application with code coverage measurement is executed. It is possible to have an unlimited amount of coverage suites.

Running with code coverage

To use code coverage in project, follow these general steps

  1. Specify how you want to process the coverage results.
  2. Create tests for the target code, if you are going to measure code coverage for testing.
  3. Configure code coverage measurement in the desired run/debug configuration.
  4. Run with coverage, using the dedicated command on the main menu Run | Run with Coverage, or runWithCoverage.
  5. Once the run with coverage has been executed, you can
Last modified: 23 July 2018

See Also