All Manuals > LispWorks IDE User Guide > 13 The Code Coverage Browser

13.2 Displaying a Code Coverage data

The Code Coverage Browser displays the data as a list, where each line corresponds to a file. Each line starts with a relative path, which is currently always the cl:file-namestring of the file, followed by columns showing statistics about code coverage in this file, and ends with the full cl:truename of the file as recorded in the data. You can configure which columns are actually displayed via Tools > Preferences... > Code Coverage Browser > Files List.

The statistics columns are divided into "Run Time" and "All" columns, which correspond to the information returned when using the keyword :runtime or :all when accessing hcl:code-coverage-file-stats. In general "Run Time" excludes code that is normally executed only at compile time or load time. The numbers in the statistics columns are numbers of "lambdas" (pieces of code). See the entry for hcl:code-coverage-file-stats in the LispWorks® User Guide and Reference Manual for more details. By default, only the "Run Time" columns are displayed.

For each of "Run Time" or "All", there are 4 columns:

Number
Number of lambdas.
Not Called
Number and percentage of lambdas that have never been called.
Not Covered
Number and percentage of lambdas that have been called, but not completely covered.
Called
Number and percentage of lambdas that have been called.

By default, only the Run Time Not Called and Run Time Not Covered columns are displayed, based on the assumption that these are the most useful ones.

For columns that display both number and percentage, the number is the number of lambdas, and the percentage is this number as a percentage of the total number of lambdas. You can configure which of the number or percentage is the "leading" value via Tools > Preferences... > Code Coverage Browser > Files List > Sort By, by selecting Percent or Number. This also affects the sorting. You can also configure it to display only one of the percentage or the number by deselecting Display Both Percent And Number in the Files List tab.

By default, the tool displays all the files in the specified code coverage data. You can restrict which files are displayed by several mechanisms:


LispWorks IDE User Guide (Windows version) - 01 Dec 2021 19:37:59