Coverage Profiler - Results of the Routines Category

After the profiling has completed, you can analyze the profiling results. The Report panel displays profiling results for all routines in your application. To analyze them quickly, you can sort out the profiling results by any column:

• The Hit Count column displays how many times every routine was executed. If a routine was not called during the profiler run, the Hit Count column holds 0. Otherwise, it shows how many times the routine was called.
• Sort out the results by the Mark column to see all routines that were executed during the profiling (marked with a green dot) and routines that were not executed (marked with a red dot). Partially executed routines are marked with a yellow dot (by default). You can specify how AQTime will count them by using the Mark partially executed lines as option.
• Inspect the Lines Covered, Lines Uncovered, Total Lines and % Covered columns to know the total number of covered and uncovered lines for every routine and coverage percentage. If the function includes a large number of lines and only a small percentage of them were executed during the testing, you might want to examine the function’s algorithm.

  Note:

  AQTime gathers line coverage statistics for those routines that were added to line-level profiling areas. If a routine was profiled at the routine level, % Covered is either 100% or 0%.

• To find the percent of covered lines in a class, unit or source file, group results in the Report panel by the Class Name, Unit Name or Source File column. The group summary will display coverage results for each class, unit or source file:

  

  Click the image to enlarge it.

  

  Click the image to enlarge it.

  

  Click the image to enlarge it.

  Tip:	Use the Coverage profiling results to estimate whether your automated tests cover all the application areas and find untested or unnecessary code.

If you want to collect profiling results for code lines, the following requirements should be met:

• The application should be compiled with debug info (this concerns both unmanaged, .NET and Java modules). For more information, see How AQTime Profilers Use Metadata and Debug Information.
• The profiled routine should be added to a line-level profiling area. For more information, see About Profiling Levels.

If both conditions are met, you can view profiling results for individual source lines in the Details and Editor panel. Note, however, that profiling a large amount of code at line level can slow down the profiling process.

If a routine selected in the Report panel was profiled at the line level, the Lines pane of the Details panel holds line coverage profiling results. The chart on the left of the Details grid graphically illustrates profiling results.

Below is a sample view of the Details panel that displays information for the routine profiled at the line level:

Click the image to enlarge it.

Click the image to enlarge it.

Click the image to enlarge it.

Each row in the Lines pane corresponds to a source code line. You can work with rows on the Lines pane in the same manner as you work with rows in the Report panel.

The Mark column graphically illustrates whether the line was executed during the profiling. Executed lines are marked with a green dot; unexecuted lines are marked with a red dot. Partially executed lines can be counted either as executed or as non-executed according to the value of the Mark partially executed lines as option.

For a detailed description of other columns that hold profiling results, see Coverage Profiler - Details Panel.

Double-clicking a row in the Details grid will move the cursor in the Editor panel to the source code line for which that row displays results. If a routine was profiled at the line level, the Editor’s grid will show the same results as those shown in the Details panel. For instance, you will find that the executed function and lines are marked with green dots and the unexecuted routines and line have red dots. Partially executed routines and lines are counted either as executed or as non-executed according to the value of the Mark partially executed lines as option.

Click the image to enlarge it.

Click the image to enlarge it.

Click the image to enlarge it.

To select which columns to display in the gutter, use the Field Chooser window. To bring it up, select Field Chooser from the context menu. See Adding and Removing Columns.

The Code Editor of Visual Studio lets you collapse and expand blocks of source code. The grid, which AQTime adds to the Code Editor to display profiling results, supports neither collapsing nor expanding because Visual Studio does not send appropriate notifications to AQTime. To ensure that the grid shows proper profiling results for source lines and routines, please expand all the collapsed blocks of code. To do this, use the Outlining > Toggle All Outlining or Outlining > Stop Outlining item of the Code Editor’s context menu.

The Editor of Embarcadero RAD Studio lets you collapse and expand blocks of source code. The grid, which AQTime adds to the Editor to display profiling results, supports neither collapsing nor expanding because Embarcadero RAD Studio does not send appropriate notifications to AQTime. To ensure that the grid shows proper profiling results for source lines and routines, please expand all the collapsed blocks of code. To do this, use the Unfold > All item of the Editor’s context menu.

Notes: