PyCharm 2023.3 Help

Code coverage

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 displayed in the 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 number of coverage suites.

Run with code coverage

General steps for using code coverage in a project

  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 from the main menu Run | Run with Coverage, or click the Run with Coverage button the Run with Coverage button.

  5. Once the run with coverage has been executed, you can perform the following actions:

Last modified: 07 March 2024