Merge branch 'master' of https://github.com/WebFuzzing/EvoMaster into config-enum-set

Author: arcuri82

.github/workflows/ci.yml

@@ -32,7 +32,7 @@ on:
 #      - "**"
 
 env:
-  evomaster-version: 5.2.1
+  evomaster-version: 6.0.1
   # Unfortunately, to use JPackage we need JDK 17 or above :(
   # Which is really bad due to the madness of --add-opens.
   # Even if hunt down all cases of reflections in EM, there is still the problem of
@@ -44,7 +44,7 @@ env:
   java-distribution: temurin
   retention-days: 5
   debug: false  # put to true if need to debug a specific test
-  debugTestName: "GeneRandomizedTest" # replace with test to debug
+  debugTestName: "SamplerVerifierTest" # replace with test to debug
 
 # This build is quite expensive (some hours), so we run it whole only on some JVM versions and OSs.
 # For the moment, we need to support JVM 8 and all following LTS versions (e.g, 11 and  17).

.github/workflows/release.yml

@@ -8,7 +8,7 @@ on:
       - "v*"
 
 env:
-  evomaster-version: 5.2.1
+  evomaster-version: 6.0.1
   jdk-jar: 17
   jdk-jpackage: 21
   java-distribution: temurin

README.md

@@ -39,13 +39,23 @@ building on decades of research in the field of [Search-Based Software Testing](
 
 ### 1-Minute Example 
 
-On a console, copy&paste the following (requires _Docker_ installed).
-It will fuzz the PetClinic example API from Swagger, for 30 seconds, as shown in the following video. 
+Since version 6.0.0, the recommended way to install EvoMaster is through PyPi:
+
+`pip install evomaster`
+
+You can then run it on the command-line with `evomster <args>`, like for example:
+
+`evomaster --schema https://petstore.swagger.io/v2/swagger.json`
+
+It will fuzz the PetClinic example API from Swagger, for 60 seconds. 
+
+If you prefer, you can rather use Docker, as shown in the following video. 
 
 ```
-docker run -v "$(pwd)/generated_tests":/generated_tests webfuzzing/evomaster  --blackBox true --maxTime 30s  --ratePerMinute 60 --bbSwaggerUrl  https://petstore.swagger.io/v2/swagger.json
+docker run -v "$(pwd)/generated_tests":/generated_tests webfuzzing/evomaster  --schema  https://petstore.swagger.io/v2/swagger.json
 ```
 
+Note the video is old, using version 3.4.0, with some parameters that are no longer necessary. 
 
 ![](docs/img/evomaster_docker_use.gif)
 
@@ -56,19 +66,19 @@ Note that, depending on which shell and operating system you are using, you migh
 For example, if run in a MSYS shell on Windows like _Git Bash_, there is the need of an extra / before the $.
 
 ```
-docker run -v "/$(pwd)/generated_tests":/generated_tests webfuzzing/evomaster  --blackBox true --maxTime 30s  --ratePerMinute 60 --bbSwaggerUrl  https://petstore.swagger.io/v2/swagger.json
+docker run -v "/$(pwd)/generated_tests":/generated_tests webfuzzing/evomaster  --schema  https://petstore.swagger.io/v2/swagger.json
 ```
 
 If you are rather using a Command Prompt (Cmd.exe) terminal, you need to use `%CD%` instead of `$(pwd)` to refer to the current folder:
 
 ```
-docker run -v %CD%/generated_tests:/generated_tests webfuzzing/evomaster  --blackBox true --maxTime 30s  --ratePerMinute 60 --bbSwaggerUrl  https://petstore.swagger.io/v2/swagger.json
+docker run -v %CD%/generated_tests:/generated_tests webfuzzing/evomaster  --schema  https://petstore.swagger.io/v2/swagger.json
 ```
 
 On the other hand, on a PowerShell you need `${PWD}`:
 
 ```
-docker run -v ${PWD}/generated_tests:/generated_tests webfuzzing/evomaster  --blackBox true --maxTime 30s  --ratePerMinute 60 --bbSwaggerUrl  https://petstore.swagger.io/v2/swagger.json
+docker run -v ${PWD}/generated_tests:/generated_tests webfuzzing/evomaster  --schema  https://petstore.swagger.io/v2/swagger.json
 ```
 
 #### Troubleshooting
@@ -110,16 +120,13 @@ Note, since version 4.0.0, now _EvoMaster_ by default also creates an interactiv
   more effective test cases. We support JDK __8__ and the major LTS versions after that (currently JDK __21__). Might work on other JVM versions, but we provide __NO__ support for it.
   Note: there was initial support for other languages as well, like for example JavaScript/TypeScript and C#, but they were not in a stable, feature-complete state. The support for those languages for white-box testing has been dropped, at least for the time being. 
 
-* _Installation_: we provide installers for the main operating systems: _Windows_ (`.msi`),
-  _OSX_ (`.dmg`) and _Linux_ (`.deb`). We also provide an uber-fat JAR file.
-  To download them, see the [Release page](https://github.com/WebFuzzing/EvoMaster/releases).
+* _Installation_: the current recommended way to install EvoMaster is via PyPi, e.g., `pip install evomaster`. We also provide an uber-fat JAR file.
+  To download it, see the [Release page](https://github.com/WebFuzzing/EvoMaster/releases).
   Release notes are present in the file [release_notes.md](https://github.com/WebFuzzing/EvoMaster/blob/master/release_notes.md).
-  If you are using the uber-fat JAR, it should work with any major LTS version (from JDK 8 on).
-   Whereas for the client library, needed for white-box testing, we will support JDK 8 likely for a long, long while, be warned that future versions of the executable JAR might start to require higher versions of the JDK in a non-so-distant future.
-   If that is going to be higher than your current version of the JVM, if you cannot upgrade or have 2 different JDKs on your machine, then you should not use the uber-jar but rather one of the installers. 
-   When you use one of the installers, keep in mind that currently they do not update the `PATH` variable. This needs to be done manually, [see documentation](docs/download.md). 
-   Also keep in mind we have not paid the [Microsoft/Apple Tax](docs/download.md). This means that your operating system by default will block the installation, stating it cannot verify it is not a malware. 
-   But the block [can be bypassed](docs/download.md).
+  If you are using the uber-fat JAR, it should work with any major LTS version (from JDK 17 on).
+   Whereas for the client library, needed for white-box testing, we will support JDK 8 likely for a long, long while.
+  Note that  we provide as well installers for the main operating systems: _Windows_ (`.msi`), _OSX_ (`.dmg`) and _Linux_ (`.deb`).
+  Unfortunately, due to the  [Microsoft/Apple Tax](docs/download.md), those installers should be considered "deprecated", [see documentation](docs/download.md).
 
 * _Docker_: _EvoMaster_ is now released via Docker as well, under [webfuzzing/evomaster](https://hub.docker.com/r/webfuzzing/evomaster) on Docker Hub. For more information on how to use _EvoMaster_ via Docker, [see documentation](docs/docker.md).
 

client-java/ci-utils/pom.xml

@@ -13,7 +13,7 @@
     <parent>
         <artifactId>evomaster-client-java</artifactId>
         <groupId>org.evomaster</groupId>
-        <version>5.2.1-SNAPSHOT</version>
+        <version>6.0.1-SNAPSHOT</version>
     </parent>
 
     <artifactId>evomaster-ci-utils</artifactId>

client-java/client-util/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>org.evomaster</groupId>
         <artifactId>evomaster-client-java</artifactId>
-        <version>5.2.1-SNAPSHOT</version>
+        <version>6.0.1-SNAPSHOT</version>
     </parent>
 
     <artifactId>evomaster-client-java-util</artifactId>

client-java/controller-api/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>org.evomaster</groupId>
         <artifactId>evomaster-client-java</artifactId>
-        <version>5.2.1-SNAPSHOT</version>
+        <version>6.0.1-SNAPSHOT</version>
     </parent>
 
     <artifactId>evomaster-client-java-controller-api</artifactId>

client-java/controller/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>org.evomaster</groupId>
         <artifactId>evomaster-client-java</artifactId>
-        <version>5.2.1-SNAPSHOT</version>
+        <version>6.0.1-SNAPSHOT</version>
     </parent>
 
     <artifactId>evomaster-client-java-controller</artifactId>

client-java/dependencies/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>org.evomaster</groupId>
         <artifactId>evomaster-client-java</artifactId>
-        <version>5.2.1-SNAPSHOT</version>
+        <version>6.0.1-SNAPSHOT</version>
     </parent>
 
     <groupId>org.evomaster</groupId>

client-java/distance-heuristics/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>org.evomaster</groupId>
         <artifactId>evomaster-client-java</artifactId>
-        <version>5.2.1-SNAPSHOT</version>
+        <version>6.0.1-SNAPSHOT</version>
     </parent>
 
     <artifactId>evomaster-client-java-distance-heuristics</artifactId>

client-java/instrumentation-shared/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>org.evomaster</groupId>
         <artifactId>evomaster-client-java</artifactId>
-        <version>5.2.1-SNAPSHOT</version>
+        <version>6.0.1-SNAPSHOT</version>
     </parent>
 
     <artifactId>evomaster-client-java-instrumentation-shared</artifactId>