JarCasting
What is EvoSuite?
EvoSuite automatically generates JUnit test suites for Java classes, targeting code coverage criteria such as branch coverage. It uses an evolutionary approach based on a genetic algorithm to derive test suites. To improve readability, the generated unit tests are minimized, and regression assertions that capture the current behavior of the tested classes are added to the tests.
Using EvoSuite
There are different ways to use EvoSuite:
EvoSuite on the command line
EvoSuite comes as an executable jar file which you can call as follows:
java -jar evosuite.jar <options>
To generate a test suite using EvoSuite, use the following command:
java -jar evosuite.jar <target> [options]
The target can be a class:
-class <ClassName>
or a package prefix, in which case EvoSuite tries to generate a test suite for each class in the classpath that matches the prefix:
-prefix <PrefixName>
or a classpath entry, in which case EvoSuite tries to generate a test suite for each class in the given classpath entry:
-target <jar file or directory>
The most important option is to set the classpath, using standard Java classpath syntax:
-projectCP <classpath>
For more options, see the Documentation
java -jar evosuite.jar -help
EvoSuite on Docker Hub
EvoSuite has a container image available on Docker Hub. You can get the container by either pulling the image:
docker pull evosuite/evosuite:<version>
or by manually building the image locally:
git clone https://github.com/EvoSuite/evosuite.git
cd evosuite
docker build -f Dockerfile.java8 . --tag evosuite/evosuite:latest-java-8
docker build -f Dockerfile.java11 . --tag evosuite/evosuite:latest-java-11
EvoSuite can be called as follows:
docker run -it -u ${UID} -v ${PWD}:/evosuite evosuite/evosuite:<version> <options>
It assumes that the project to be tested is located in the current directory the command is called from. The current directory, ${PWD}, is mapped to the /evosuite directory inside the container. This location is also the working directory of EvoSuite. All results will be mapped back to the directory on the host system. The -u ${UID} makes sure that the results have the same file ownership as the user initiating the command.
When EvoSuite needs to be run in the background, you can use -d instead of -it.
The <options> are the same as they would be when EvoSuite is called from the command line.
EvoSuite plugin for Eclipse
There is an experimental Eclipse plugin available using the following update site: http://www.evosuite.org/update
To see what the plugin does check out the screencast.
EvoSuite plugin for Maven
EvoSuite has a Maven Plugin that can be used to generate new test cases as part of the build. This has at least the following advantages:
- Can run EvoSuite from Continuous Integration servers (eg Jenkins) with minimal configuration overheads
- Generated tests can be put directly on the classpath of the system based on the pom.xml files
- No need to install EvoSuite on local machine (Maven will take care of it automatically)
For more details, check the documentation
EvoSuite plugin for IntelliJ
Check out the documentation.
Getting EvoSuite
The current release of EvoSuite (main EvoSuite jar file and plugins) is available for download at http://www.evosuite.org/downloads/.
To access the source code, use the github repository:
git clone https://github.com/EvoSuite/evosuite.git
Building EvoSuite
EvoSuite uses Maven.
To build EvoSuite on the command line, install maven and then call
mvn compile
To create a binary distribution that includes all dependencies you can use Maven as well:
mvn package
To build EvoSuite in Eclipse, make sure you have the M2Eclipse plugin installed, and import EvoSuite as Maven project. This will ensure that Eclipse uses Maven to build the project.
More Information
Usage documentation can be found at http://www.evosuite.org/documentation/
The developers' mailing list is hosted at https://groups.google.com/forum/#!forum/evosuite
EvoSuite has resulted in a number of publications, all of which are available at http://www.evosuite.org/publications/
