E - Environment Codes
These output codes are associated with system checks performed on your development environment by Diffblue Cover. This ensures your environment is configured correctly and that Diffblue Cover is compatible with it.
Diffblue Cover failed to write a test in the test Java file. Please enable read and write permissions on the file.
Failed to overwrite the created test Java file. Please enable read and write permissions on the file and its parent folder.
Failed to read the existing test Java file. Please enable read permissions on this file and its parent folder.
Diffblue Cover was unable to find any methods that can be tested in your selection. Ensure that your selection includes some Java code that contains methods that are not private.
If using the
--patch-only
option, ensure that the patch file was created correctly and that its encoding is UTF-8.You must run
dcover
on the individual submodules. Run dcover with the option --working-directory path/to/submodule
or change into the submodule directory and run dcover
from there.Diffblue Cover cannot verify the generated tests because the JUnit Jupiter Launcher was not found. We have detected that you have JUnit Jupiter on your classpath but were not able run a dummy test. Because of this, Diffblue Cover has disabled test verification.
Please ensure that your build system is configured to run JUnit Jupiter tests (for Maven projects, ensure the Surefire plugin is configured to run JUnit Jupiter tests; for Gradle projects, ensure that
useJUnitPlatform()
is in the test
configuration.You can also use
--testing-framework=junit-4
to force Diffblue Cover to write JUnit4 tests.Diffblue Cover could not execute a Dummy Test in your project. A number of classes were detected as missing. Because of this Diffblue Cover will not be able to verify tests. Please resolve these missing classes to enable test verification.
Diffblue Cover was not able to run a dummy test in your environment because the
ClassNamePatternFilterUtils
class was missing. This can occur when you have a mismatch in versions of the junit-platform-launcher and junit-platform-commons. Please ensure that these versions are consistent. If you don't have a junit-platform-launcher specified, please add an appropriate version to your project. Because of this Diffblue Cover will not be able to verify tests.While trying to detect the path to the JUnit Jupiter Launcher, we detected multiple lines of output where we expected only a single line. Because of this Diffblue Cover will not be able to verify tests.
The --patch-depth parameter controls the number of hops from the classes in the patch dcover will consider when generating tests. A value of 0 will create tests for just the classes in the patch, while a value of 1 will create tests for any class that uses those in the patch (as well as the ones mentioned in the patch), and so on.
Care must be taken as there are occasions where the impact of the changes in the patch may not be detected and you may end up with test failures because the impact of the patch hasn't propagated to the necessary extent.
Problems in the local build system have been detected that will prevent Diffblue Cover from verifying and validating the created tests.
An error occurred when using the build system. Check the user log file in
.diffblue/log
which contains the entire build system log to find the build system error message.Diffblue Cover was unable to find a JUnit Jupiter Launcher compatible with your configured JUnit Jupiter Engine and therefore will not be able to verify tests. Please upgrade your build configuration to to use a compatible JUnit Jupiter Engine versions.
Neither Gradle nor Maven build systems were detected. Use the
--classpath
option or CLASSPATH
environment variable to specify a classpath manually.The specified build system is not available. Make sure a build configuration file for the specified build system is available in the project, or enable auto-detection of the build system by removing the
--gradle
or --maven
options you might be using.Make sure that local firewall settings allow connecting to a service at HOST:PORT.
Failed to load execution trace. Please review the cause message to diagnose the underlying issue.
The specified working directory does not exist. Make sure you have specified an existing directory when using the
--working-directory
option.Diffblue Cover failed to create its
.diffblue
directory in the working directory. Make sure Diffblue Cover has the correct permissions to create a directory.Diffblue Cover was unable to start its analysis service (used to dynamically analyze code and create tests). See Working with code E020 for more information.
There are multiple
settings.gradle
files in your project, which may cause your project configuration to be invalid. Consolidate the content of your settings.gradle
files into a single file at the root of your project, and remove all other settings.gradle
files.Diffblue Cover was not able to discover the path to the JUnit Jupiter Launcher. Because of this Diffblue Cover will not be able to verify tests.
The given file could not be deleted. If deletion is necessary, please do this manually.
The given files could not be deleted. If deletion is necessary, please do this manually.
Diffblue Cover uses the JUnit Jupiter Launcher to run verify tests. While attempting to download the launcher we encountered an error. Because of this, Diffblue Cover has disabled test verification.
Diffblue Cover was not able to execute the custom validation command successfully and has disabled test validation.
Diffblue Cover was not able to find a JUnit Jupiter Engine configured in your project's dependencies. Diffblue Cover uses this to determine the version of the JUnit Jupiter Launcher to use when verifying tests. Please ensure that your project is configured to run JUnit Jupiter tests. Because of this, Diffblue Cover will not be able to verify tests.
Diffblue Cover was not able to determine the dependencies of your project. Check the build system output in the user log file for further information. Because of this Diffblue Cover is not able to verify tests.
Failed to select a trace from the trace directory. Please review the cause message to diagnose the underlying issue.
Test creation for this method was cancelled as requested.
We recommend you change your module settings to JDK 1.8, JDK 11, or JDK 17.
Diffblue Cover tried to validate the tests it created but failed due to failing tests. Diffblue Cover cannot fix this problem automatically. The output from running the validation command is available towards the end of the log file. Please see our documentation for further guidance.
Diffblue Cover discovered a mismatch in JUnit Jupiter Api and Engine versions.
Please ensure that your JUnit Jupiter Api and Engine versions match.
Because of this, Diffblue Cover will not be able to verify tests.
Diffblue Cover tried to run a command to run all the existing tests, but it took too long. The output from running the command is available towards the end of the log file.
Diffblue Cover tried to run a command to run all the existing tests, but it failed. The output from running this command is available towards the end of the log file. While Diffblue Cover could not figure out the reason for this and cannot fix it automatically, this issue is usually due to an incorrect command, or due to the failure of existing, user-provided tests.
Diffblue Cover tried to run all the existing the tests but failed due to failing tests. Diffblue Cover cannot fix this problem automatically. The output from running the validation command is available towards the end of the log file.
Failed to apply refactoring. Check the build system output in the user log file for further information.
Failed to write refactoring configuration file. Please enable write permissions on this file and its parent folder.
Failed to install a file into the local Maven repository. Make sure the displayed command can be executed successfully.
The two given options are incompatible. Remove one of them.
Diffblue Cover tried and failed to validate the tests it created. The output from running this command is available towards the end of the log file. While Diffblue Cover could not figure out the reason for this and cannot fix it automatically, this issue is usually due to an incorrect validation command, or due to the failure of existing, user-provided tests. Please see our documentation for further guidance.
Failed to load Maven settings.xml files from the user's home directory or maven installation directory. Make sure that Maven commands can be executed successfully, using your settings.
Please use Java 8 Update 351+, Java 11.0.17+ or Java 17.0.5+.
Diffblue Cover was unable to read the given JaCoCo report file.
The current inotify watch limit is too low. Try restarting the IDE and/or your machine. Check your inotify limit and consider resetting to a higher value.
Unfortunately the version of the specified tool you are using is unsupported. Please consider upgrading.
Diffblue Cover needs to be executed with the same or a more recent Java version than the version with which the project was compiled.
Required dependencies were not found. Please add these dependencies.
A dependency was found at an unsupported version. Please upgrade it to the given version.
Diffblue Cover could not find any .class files for your project. This usually means that your project has not yet been compiled.
For Diffblue Cover to run successfully, we require an example test to pass. Please see our documentation.
Diffblue Cover requires a JDK (Java Development Kit) to run. A JRE (Java Runtime Environment) is not sufficient. Diffblue Cover expects the JDK in
RT_JAR_PATH
or JMODS_PATH
. Make sure a JDK is installed in these locations.Diffblue Cover was unable to start its analysis service (used to dynamically analyze code and create tests). There was a problem with the SSL certificates used to set up the connection. Check whether you have the full set of CA certificates for Java installed.
Diffblue Cover was unable to start its analysis service (used to dynamically analyze code and create tests). There was an I/O problem while trying to set up a network connection to the service. Please check whether you have a firewall configuration that disallows TCP servers on localhost.
Diffblue Cover was unable to start its analysis service (used to dynamically analyze code and create tests). Diffblue Cover did not receive the "port message" from the service before the timeout. If your machine is heavily loaded or very slow, try reducing load before running Cover.
Diffblue Cover was unable to start its analysis service (used to dynamically analyze code and create tests). There was a problem with the SSL connection to the service. Please contact Diffblue Support, providing details about this error.
Diffblue Cover was unable to start its analysis service (used to dynamically analyze code and create tests). Diffblue Cover did not receive the "alive message" from the service before the timeout. If your machine is heavily loaded or very slow, try reducing load before running Cover.
Diffblue Cover was unable to start its analysis service (used to dynamically analyze code and create tests). Service failed to start due to a JVM issue. Please contact Diffblue Support, providing details about this error.
Diffblue Cover was unable to start its analysis service (used to dynamically analyze code and create tests). A Diffblue Cover component is missing. Please check your installation is complete.
Diffblue Cover was unable to start its analysis service (used to dynamically analyze code and create tests). Starting up the service failed because of an I/O problem while trying to execute the JVM for the service process. Please check whether your installation is complete, whether all files are readable and whether the JVM in JAVA_HOME is executable.
Diffblue Cover was unable to start its analysis service (used to dynamically analyze code and create tests). Please contact Diffblue Support, providing details about this error.
Some dependencies are incompatible with the current JDK (version). Please add the following dependencies to your project (list).
Diffblue Cover requires a 64-bit JVM to run. A 32-bit JVM is not sufficient. Make sure a 64-bit JDK 8, 11 or 17 is installed and
JAVA_HOME
is set to its installation location.Diffblue Cover tried to load custom input rules but was unable to read the content of the file correctly. Please review the content of the custom input file and ensure that it is correct. Information about the input rules format can be found in our documentation.
Please check your environment. More information on the runtime environment can be found in our documentation.
Diffblue Cover cannot write tests because your project failed to compile. Please ensure that your project compiles successfully before trying to write tests again.
Diffblue Cover detected an old version of the Maven Surefire plugin in use in your project. Because of this Diffblue Cover will not be able to verify tests. Additionally, this version is not sufficient to produce coverage reports. Please upgrade the the most recent version. If you are using JUnit Jupiter 5, you need a minimum of 3.0.0-M7. If you are using JUnit 4, you need a minimum of 2.19.
Diffblue Cover detected an old version of the Maven Surefire plugin in use in your project. Because of this Diffblue Cover will not be able to verify tests. Please upgrade the the most recent version. If you are using JUnit Jupiter 5, you need a minimum of 3.0.0-M4. If you are using JUnit 4, you need a minimum of 2.3.
The
--mock-static
option was specified, but your project has not been configured to use the Mockito inline mock maker. Mockito recommends placing the mockito-inline
artifact where you are currently using mockito-core
.The
--mock-static
option was specified, but Mockito is not present in your project. Please add Mockito to your project as a test dependency.The
--mock-static
option was specified, but your version of Mockito is not sufficient to support static mocking. Please upgrade your version of Mockito to at least version 3.4.0.Unable to load the trace. Please record your application again with the Replay agent of your current installation of Diffblue Cover.
Diffblue Cover tried and failed to write a report. Check to see if you have the correct permissions to write to the file, or use a different path for the report.
Diffblue Cover failed to create the test output directory (e.g.
src/test/java
). Make sure Diffblue Cover has the correct permissions to create a directory.Diffblue Cover was unable to read the given patch file.
Failed to write the coverage report. Please check permissions.
The JaCoCo report could not be found. To troubleshoot, try running the logged command and check that the coverage report is created at the expected location.
The JaCoCo command failed for an unknown reason. Please check the user log file.
The JaCoCo command returned a non-zero exit code. Please check the user log file. This happens when there are no tests to run. If this is unexpected, make sure JaCoCo is setup in the project.
Please ensure the build configuration compiles Diffblue tests as java.
The test framework specified is not available on the classpath. Please add it as a dependency.
There are multiple testing frameworks available in your build configuration, and it is not clear which of them should be used by Cover. Please use the
--testing-framework
option to select a testing framework, e.g. --testing-framework=junit-4
or --testing-framework=junit-5
.Diffblue Cover cannot create tests for Android projects.
The test framework argument provided is not a valid, supported JUnit version. Please refer to our documentation for the list of supported versions.
Diffblue Cover tried to load custom execution policy rules but was unable to read the content of the file correctly. Please review the content of the custom execution policy rules file and ensure that it is correct.
No embedded Java database engines were detected. This will prevent Diffblue Cover from writing tests for repository classes. Spring supports HSQL, H2, and Derby. Please add one of these as a dependency to your project. Alternatively, if you are not interested in testing repository classes, they can be excluded using the
--exclude
option.The version of the jacoco-maven-plugin is too old to generate coverage reports in the required XML schema (for use with Diffblue Cover Reports). Please edit your
pom.xml
file to set the plugin version to 0.8.7 or later.The jacoco-maven-plugin is not configured to produce the XML output format. Please add XML to the list of <formats> in the configuration, e.g.
...
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<version>0.8.7</version>
<configuration>
<formats>HTML,XML</formats>
</configuration>
<executions>
<execution>
<id>jacoco-initialize</id>
<goals>
<goal>prepare-agent</goal>
</goals>
</execution>
<execution>
<id>jacoco-site</id>
<phase>test</phase>
<goals>
<goal>report</goal>
</goals>
</execution>
</executions>
</plugin>
...
The XML coverage report is used by Cover Reports to show the coverage produced by Diffblue Cover alongside the developer written tests.
Diffblue Cover has detected a
jacoco.skip
property is being set to true in the pom.xml
of the project under test. To generate coverage, this value has been overridden. Please remove this property if this is unexpected.One of the report files was not available when we tried to upload them to Diffblue Cover Reports. This can be caused either by the reports not being created, or being moved before the upload started. See working with Cover Reports for more information.
We couldn't connect to the Diffblue Cover Reports server. This could be due to a wide number of reasons, for example:
- Cover Reports isn't running, or the server is down
- The Cover Reports hostname is not able to be resolved
- There's a firewall blocking the connection between the machine and Cover Reports
- The connection between the client and the server is too slow
If you were running as part of the
create
command you can use upload
to avoid recreating all the tests. If you are still experiencing problems, please contact Diffblue Support.The Diffblue Cover Reports server was not able to process the upload request. Please contact Diffblue Support.
The upload was successful.
The upload was successful.
The upload was unknown because we didn't get a response from the server to indicate whether the upload was successful. Check your reports and see if the upload succeeded, if not, please try again. If you believe this is a problem, please contact Diffblue Support and provide this message along with the logs.
The upload was successful but the server sent a response we were not expecting. Please check your logs and contact Diffblue Support if you believe there is a problem.
Diffblue Cover was unable to find the root of your gradle project. Check the user log file in
.diffblue/log
which contains the build system log to find the build system error messages.Mockito failed to initialize. This is usually caused by a mismatch between the version of Mockito and ByteBuddy. Please upgrade ByteBuddy to the version recommended in the Cover output code message. Cover will not be able to create tests using mocks until this is resolved.
This project uses Spring profiles but no profile was supplied through the
--active-profiles
option. Use the --active-profiles
option to explicitly specify the profiles to use. If a Spring profile named "test" was available, Diffblue Cover would select it automatically.The dependency is not compatible with
spring-core
. Diffblue Cover may not be able to create Spring tests correctly. Consider upgrading your dependency.Invalid method prefixes were specified by the user.
Diffblue Cover running without sufficient memory allocated. Please use the
JVM_ARGS
environment variable to increase the memory allocation.Problems in the local build system have been detected that will prevent Diffblue Cover from verifying and validating the created tests.
Authentication stopped while uploading coverage reports because password or username were not supplied. Please check your input arguments (--report-username and --report-password), or environment variables (DIFFBLUE_REPORT_USERNAME and DIFFBLUE_REPORT_PASSWORD).
Authentication stopped while uploading coverage reports because username or password are incorrect. Please check your input arguments (--report-username and --report-password), or environment variables (DIFFBLUE_REPORT_USERNAME and DIFFBLUE_REPORT_PASSWORD).
Authentication has not been enabled on your Cover Reports instance, so you do not need to provide a username or password. Please remove
DIFFBLUE_REPORT_USERNAME
and DIFFBLUE_REPORT_PASSWORD
environment variables and --report-username
and --report-password
input arguments. Alternatively, you can enable authentication on your Cover Reports instance. See https://docs.diffblue.com/knowledge-base/diffblue-cover-reports/authentication/ for details on how to do this.The project asset was disposed. This is likely because your project configuration changed during an operation. Please rebuild the project and try again.
JaCoCo reported incorrect coverage for a simple example class. Please check your JaCoCo configuration and ensure JaCoCo runs as expected on your system.
JaCoCo failed to create coverage for a simple example class. Please check your JaCoCo configuration and ensure JaCoCo runs as expected on your system.
The JaCoCo coverage task failed. Please check your JaCoCo configuration and ensure JaCoCo runs as expected on your system.
Diffblue Cover cannot verify the generated tests because the JUnit Vintage Engine was not found. We have detected that you have dependencies on both JUnit 4 and JUnit Jupiter 5, however without the JUnit Vintage Engine, we will be unable to run any JUnit 4 tests.
Please ensure that your build system is configured to run JUnit 4 tests if you also have a dependency on JUnit Jupiter 5.
Diffblue Cover cannot validate the generated tests because an incompatible version of JUnit Vintage Engine was found. In order to run both JUnit 4 and JUnit Jupiter 5, we require a dependency on the JUnit Vintage Engine. This version should match the version of JUnit Jupiter 5 in order to successfully run the tests.
Please ensure that your build system is correctly configured to run JUnit 4 tests if you also have a dependency on JUnit Jupiter 5.
Diffblue Cover has detected a dependency on JUnit Vintage Engine that is not required and may cause issues. Please remove your dependency to JUnit Vintage Engine. Alternatively, if you wish to also run tests in JUnit 5, please add a dependency to JUnit Jupiter Engine.
Diffblue Cover has detected a dependency on JUnit Vintage Engine which is incompatible with the version of JUnit 4 that we have detected.
JUnit Vintage Engine requires JUnit 4.12 or later to be present on the classpath. There is also a issue with JUnit versions 4.13.1 & 4.13.2 with JUnit Vintage Engine versions lower than 5.6.3 (junit5/issues/2198). In either case, this can mean that JUnit is unable to find any JUnit 4 tests.
Diffblue Cover was unable to find a referenced file in the patch file you have provided.
The
--mock-construction
option was specified, but your version of Mockito is not sufficient to support construction mocking. Please upgrade your version of Mockito to at least version 3.5.0.The template must only use valid Java identifier characters (a-z,A-Z,0-9,$,_) and must not start with a digit. Remove the illegal characters.
The template contains an unterminated variable (
${
without closing }
). Fix this variable.The template contains an unrecognized variable. Remove this variable. In class templates only
${CLASS_NAME}
is allowed. In method templates only ${METHOD_NAME}
and ${INNER_CLASS_NAME}
are allowed.The template does not contain any variable to include the class or method name.
The specified class name template consists only of the variable
${CLASS_NAME}
. This would clash with the class under test. For example, try to add a suffix: ${CLASS_NAME}Test
The specified class name template has too much static text (more than 128 characters). This would probably lead to class file names too long to store on disk.
Diffblue Cover was not able to locate the Mockito JUnit Jupiter dependency. Please add this dependency to your project.
Diffblue Cover was unable to convert the provided Cover Reports server path to a URL. Please check and update the server path and try uploading the reports bundle again. An example valid server path is https://reports.example.com:8080
An unsupported JavaEE version was detected. Please use JavaEE 8/JakartaEE 8 or JakartaEE 9.
Information only
Information only
Diffblue Cover tried to load custom input rules, but was unable to locate the specified class(es). Please review and update the class path(s).
Last modified 1d ago