Contributing to Apache Maven Surefire

The Maven Community

Project Documentation

Usage of maven-surefire-plugin, maven-failsafe-plugin, maven-surefire-report-plugin

Development Information

Build the Surefire project using Maven 3.6.3+ and JDK 8+.

In order to run tests for a release check during the Vote, the following memory requirements are needed:

On Linux/Unix:

export MAVEN_OPTS="-server -Xmx512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=384m -XX:+UseG1GC -XX:+UseStringDeduplication -XX:+TieredCompilation -XX:TieredStopAtLevel=1 -XX:SoftRefLRUPolicyMSPerMB=50 -Djava.awt.headless=true"

On Windows:

set MAVEN_OPTS="-server -Xmx256m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=384m -XX:+UseG1GC -XX:+UseStringDeduplication -XX:+TieredCompilation -XX:TieredStopAtLevel=1 -XX:SoftRefLRUPolicyMSPerMB=50 -Djava.awt.headless=true"

In order to build and run the tests:

mvn install site site:stage -P reporting,run-its

To set up the project in Eclipse IDE or IntelliJ IDEA, please follow these steps:
- Build module surefire-shared-utils with profile ide-development and install it into the local maven repository using this Maven command:
```
mvn install -P ide-development -f surefire-shared-utils/pom.xml
```
- Build module surefire-grouper in order to generate and compile sources into target/generated-sources/javacc using this Maven command:
```
mvn compile -f surefire-grouper/pom.xml
```
- In Eclipse, select File > Import ... > Maven Project
  - Select all projects (poms) except surefire-shared-utils,
    enter profile ide-development in Advanced -> Profiles
  - Check module surefire-grouper has source folder target/generated-sources/javacc.
    If not, add it manually in the module's project properties
- In IntelliJ, select Maven > Profiles and check ide-development