This is the documentation for Clover 4.0. View this page for the

Unknown macro: {spacejump}

of Clover, or visit the latest Clover documentation.

'Historical' reports display graphical and numerical data relating to sets of coverage data collected over time for the project. 

Clover 4 brings new HTML report developed according to the Atlassian Design Guidelines; it's shortly named "ADG". Clover 3 offers an old-style JavaDoc-like format, named "Classic". It is still possible to fall-back to the "Classic" report in Clover 4, however this report style is deprecated.

ADG report style (Clover 4 only)

General

Historical report consists of several sections:

  • Date range and Code metrics widgets
  • Coverage overview - shows coverage from the last history point
  • Added classes - classes which have been added in the specified time span
  • Changed classes - classes for which metrics have changed above specified thresholds in given time span
  • Charts - set of charts (they are customizable)

 

Blue application header

  • Clover logo - opens the Atlassian Clover home page
  • Linked reports - shows reports linked with the current one (optional)
  • Help icon - opens the Clover documentation home page

 

 

Classic report style (Clover 3 and Clover 4)


When you view the report you should see a picture similar to the screenshot below, although it is likely that the graphs that you produce will contain different values.

  • Like the 'current' report, the historical report begins with a header containing relevant project information. This includes the report title, the project metrics and the period for which history points are included in the report. (A history point is a snapshot of code coverage and metrics data for the project at a particular point in time.)
  • Below this header is the Project Overview Chart which shows the branch, statement, method and total coverage percentages for the project for the most recent history point included in the report.
  • The 'Coverage over time' graph shows the percentage values of branch, statement, method and total coverage for each history point and plots them against time in an easy-to-read chart.

Screen shot: historical coverage over time

  • The 'Metrics over time' graph shows the project statistics for each history point plotted against time. It is therefore possible to observe changes in metrics such as the number of methods. In the example, the number of methods can be seen shown in green.

Screenshot: Historical Metrics Over Time

 

  • The section 'Classes added' allows you to monitor the coverage of newly added classes.
  • The final section, 'Movers', displays classes that have increased or decreased in coverage by more than a specified percentage point threshold over a particular time interval, the default being one percentage point over the two latest history points.

Screen shot: Classes Added and Movers

Custom charts

You can also view charts for coverage against complexity and covered versus uncovered elements (see below). These are just two examples. Any metrics can be charted, including user-defined metrics, customised for your needs.

Screen shot: Historical Coverage Against Complexity

Screen shot: Historical Covered Versus Uncovered Elements

 

The tutorial discusses how you can customise many aspects of the historical report.





Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.