Download and Install EvoMaster

EvoMaster is composed of two main components:

• Core: the main program executable, packaged in a evomaster.jar file.
• Driver: library used to control and instrument the application under test. There is going to be one library per supported language/environment, like the JVM. Note: the driver is NOT needed for Black-Box Testing.

Core Tool

The recommended way to install EvoMaster is via PyPi with:

pip install evomaster

which will then allow you to run it with:

evomaster <args>

On the first run, it will download a suitable JDK and the latest release of evomaster.jar. The python command is then just a wrapper that run those, see documentation on PyPi.

The latest release of the evomaster.jar executable can also be downloaded directly from GitHub on the releases page. Alternatively, it can be built from source code.

Note: it does not matter where you download the jar file (e.g., your home folder, or the folder of your project), as long as you can easily access it from a command-line terminal (e.g., to be able to execute java -jar on it).

Besides an uber-fat jar, since version 1.2.0 we also provide installers for Windows/OSX/Linux. Note: the installers are built with jpackage, that currently does not have any simple, automated support to update the PATH environment variable. This means that, unless you want to type the full absolute path of where EvoMaster gets installed each time you want to use it, you will need to update the PATH environmental variable by hand. By default, EvoMaster will get installed at:

• On Windows: C:\Program Files\evomaster\evomaster.exe
• On OSX: /Applications/evomaster.app/Contents/MacOS/evomaster
• On Linux: /opt/evomaster/bin/evomaster

On OSX and Linux, you can add to your ~/.zprofile (recent Macs) or ~/.bash_profile file the following lines:

export PATH="$PATH:/Applications/evomaster.app/Contents/MacOS" (for OSX)

export PATH="$PATH:/opt/evomaster/bin" (for Linux)

Note that ~ refers to your home directory. If the file does not exist, you can create it for example with touch ~/.bash_profile.

For Windows, you need to go to the System Properties, and under Advanced tab click on Environment Variables. Then, add the location of the folder in which EvoMaster is installed (i.e., C:\Program Files\evomaster) to the Path variable (by selecting it, and then press Edit), as shown in the figures next.

If you have not setup environment variables before, you can learn more by searching online with something like set environment variable permanently with the name of your operating system.

Notice that these installer files are built with the latest versions of these operating systems on GitHub Actions. They might not work when trying to use these installers on older operating system versions.

Microsoft and Apple Tax

As an open-source project, we have not paid tax to Microsoft and Apple. This means that, if you try to install EvoMaster via its .msi or .dmg installer files, Microsoft/Apple will block it for "security" reasons. But you can bypass the block (you can search for latest instructions specific for your OS). See for example instructions for Mac Sequoia:

Unfortunately, recent versions of Windows/Mac might still block the installation without providing any workaround, even for admin-rights users, especially on corporate machines (as it was reported by some users). As such, those installers should be considered deprecated. I.e., use pip or download the jar and a JDK manually.

Driver Library

Regarding the driver library, it depends on the language/environment. For example, the JVM support is available from Maven Central. You would import it (e.g., with Maven or Gradle) like any other library. See documentation on writing a driver class for more details.

If you are building such library from source code, then make sure to use the Maven install option to copy it over your local ~/.m2 repository. You might also want to use -DskipTests the option.