Test framework dependencies

Tests created by Diffblue Cover make use of a testing framework, namely one of JUnit 4, JUnit Jupiter, or TestNG - these frameworks are included in the required dependencies below. These dependencies are available from the Maven Central Repository. To add it, follow the guide relevant to your build tool.

Maven

Check whether or not the test framework dependencies are already in your Maven project. If not, follow the instructions below to add it:

1. Edit the pom.xml

2. Add the surefire plugin to the build plugins section

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.5.4</version>
        </plugin>
    </plugins>
</build>

With recent versions of surefire, it is not necessary to specify any plugin dependencies for the specific testing framework being used; surefire will detect the versions specified in the project dependencies section as specified below.

Explicitly specifying a testing framework in the plugin dependencies (e.g. to override the provider) can result in a reduced capability in the surefire plugin. In some cases, this can prevent Cover from grouping tests correctly which affects coverage calculations.

1. Add JUnit or TestNG to the dependencies section:

For JUnit 4:

<dependencies>
  [...]
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.13.2</version>
      <scope>test</scope>
    </dependency>
  [...]
</dependencies>

For JUnit Jupiter 5:

<dependencies>
    [...]
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.9.1</version>
        <scope>test</scope>
    </dependency>
    [...]
</dependencies>

For TestNG:

<dependencies>
  [...]
    <dependency>
      <groupId>org.testng</groupId>
      <artifactId>testng</artifactId>
      <version>6.9.8</version>
      <scope>test</scope>
    </dependency>
  [...]
</dependencies>

Gradle

Check whether or not the test framework dependencies are already in your Gradle project. If not, follow the instructions below to add it:

1. Edit the build script (build.gradle or build.gradle.kts).

2. Add Maven to the repositories section.

    repositories {
        mavenCentral()
    }

3. Add JUnit or TestNG to the dependencies section:

For JUnit 4:

GROOVY

 dependencies {
     testCompile group: 'junit', name: 'junit', version: '4.13.2'
 }

KOTLIN

For JUnit Jupiter 5:

GROOVY

 dependencies {
     testCompile group: 'org.junit.jupiter', name: 'junit-jupiter', version: '5.8.0'
 }

KOTLIN

For TestNG:

GROOVY

 dependencies {
     testCompile group: 'org.testng', name: 'testng', version: '7.8.0'
 }

KOTLIN

The versions specified are the latest at the time of writing. Please use the latest versions available for the best results

Run the tests

Choose one of the new test classes in the project explorer, right-click and select 'Run ClassnameTest'. The IDE will then show the results of the run.