Telescope

Telescope is an intuitive, easy-to-use tool for the visualisation of project metrics. It adds value to existing reports such as the ones produced by Diffblue Cover and Jacoco, by representing data visually.

Please contact Diffblue to obtain a copy of Telescope (at beta release, February 2021).

Pre-requisites

To build and run telescope from the source code:

  • Java version 8 or later
  • Maven version 3.5.3 or later

To run Telescope from the executable file:

  • Java version 8 or later

Getting Started

To start using Telescope, you need to upload an existing report (for example, one produced by DCover). Click on the Upload Reports button and fill in the following fields:

  • Coverage report name - this is the name you use to refer to the report.
  • Diffblue Cover Report - this is the location of an existing DCover report. If you do not have an existing report, please follow the instructions in the help text to generate one.
  • JaCoCo Report, excluding Diffblue tests - this is the location of the JaCoCo report, excluding Diffblue tests.
    • To generate a JaCoCo report which excludes DCover tests, use the command: mvn test -Dtest=!DiffblueTest 
    • In certain environments, you may need to use following the alternative instead: mvn test -Dtest='!*DiffblueTest' 
  • JaCoCo Report, excluding manual tests - this is the location of the JaCoCo report, excluding manual tests.
    • To generate a JaCoCo report which runs only DCover tests, use the command: mvn test -Dtest=!*DiffblueTest 

Then, click Upload reports.

Once you have uploaded your first report, you can see all reports listed by clicking on this icon on the left menu:

Test Coverage Breakdown

Once you have uploaded a report, click on the Dashboard icon to see the Test Coverage Breakdown. An example is shown below:

Coverage

Click on to see more detailed information on coverage. An example is shown below:

Insights

Use the icon to see the insights into your report, for example: