Getting started with Diffblue Cover

Initial use, sign-up, and login

Once Diffblue Cover is running within your network you should be able to access the main user interface on the installed IP/Hostname in a browser. This is the hostname that you set up to access the product:

http://[your hostname]/

Our recommended browser is Chrome.

On the login screen click Sign up to create a new user:

login

On a clean installation no users will be present.

signup

Enter the details for your initial user. Usernames cannot contain spaces or special characters except - and _. Passwords must be at least 10 characters long and can contain any characters.

Once you have created your user, you will automatically be logged in to the Dashboard for that user.

dashboard

Adding a project for analysis

The dashboard shows your projects and their status. From here you can add new projects and run analyses.

The first step is to create your project by clicking Add project. From here, you can either choose to have a walkthrough using our java-demo project as an example, (this is provided with your shipped version of the product, it is a JAR file called java-demo.jar) or move straight on to analyzing your own project JAR.

add_a_project

The Add a new Project prompt will ask for a project name.

Running an analysis

created

Once the project is created it will show the ready icon (the Diffblue owl) and the Start analysis button will be enabled.

Clicking Start analysis will open a modal which will allow you to provide the file(s) required to start an analysis.

jar-settings

A build JAR must be provided in the first field. This should be a JAR file containing the code you wish to analyze.

A fat build JAR may be provided in the second field. This will enable test verification, as long as skipVerification is not specified in your settings file.

A base build JAR may be provided in the third field. This will make the analysis differential, i.e. it will only analyze lines that have been added or changed in the build JAR versus the base build JAR.

A settings file in json or yaml format may be provided in the fourth field, which should contain the configuration for your analysis. If you do not provide a settings file, your analysis will be run with a default configuration. For more details see Configuring Diffblue Cover.

analysis

This screen shows the analyses that have been started, including any currently running. Each analysis can be expanded to provide more information about the specific run and allow the analysis to be stopped:

expanded

Once the analysis starts the View results button becomes available. If the analysis is still running a progress bar will be displayed at the top of the results pages until it completes.

Analysis results

On clicking View results you will be presented with the tests view:

test_list

This shows all of the tests Diffblue Cover has produced, along with the class they test against and the number of lines of additional coverage these tests provide. To see the contents of the test itself click View Test:

test

Here you can Copy test into your system clipboard or select Download java file. If you want to use this unit test in your test suite, please ensure you have appropriately set up the Diffblue utilities. See Executing Diffblue tests for more information. If you are working in an offline environment without access to the Maven package repository you can use the link in the product to directly download the utilities tar file deeptestutils.x-y-z.tar and incorporate the files into your environment. For more details see section Executing Diffblue tests without Maven access.

results matching ""

    No results matching ""