This repository is the home of the next generation of JUnit, JUnit 5.

The project is currently in Phase 5, working toward additional milestone releases.

JUnit 5.0.0-M2 was released on July 23, 2016.

Consult the wiki for details on the current JUnit 5 roadmap.

The JUnit 5 User Guide is available online.

The JUnit 5 Javadoc is available online.

Contributions to JUnit 5 are both welcomed and appreciated. For specific guidelines regarding contributions, please see CONTRIBUTING.md in the root directory of the project. Those willing to use the ALPHA, milestone, or SNAPSHOT releases are encouraged to file feature requests and bug reports using the project's issue tracker. Issues marked with an up-for-grabs label are specifically targeted for community contributions.

CI Server	OS	Status	Description
Jenkins	Linux		Official CI build server for JUnit 5
Travis CI	Linux		Used to perform quick checks on submitted pull requests and for build matrices including JDK 8 and JDK 9 early access builds
AppVeyor	Windows		Used to ensure that JUnit 5 can be built on Windows

Code coverage using Clover for the latest build is available on the Jenkins CI server. We are thankful to Atlassian for providing the Clover license free of charge.

A code coverage report can also be generated locally by executing gradlew -PenableClover clean cloverHtmlReport if you have a local Clover license file on your computer. The results will be available in junit-tests/build/reports/clover/html/index.html.

All modules can be built with Gradle using the following command.

gradlew clean assemble

All modules can be tested with Gradle using the following command.

gradlew clean test

All modules can be installed in a local Maven repository for consumption in other projects via the following command.

gradlew clean install

The following sections list the dependency metadata for the JUnit Platform, JUnit Jupiter, and JUnit Vintage.

See also http://repo1.maven.org/maven2/org/junit/ for releases and https://oss.sonatype.org/content/repositories/snapshots/org/junit/ for snapshots.

• Group ID: org.junit.platform
• Version: 1.0.0-M2 or 1.0.0-SNAPSHOT
• Artifact IDs:
  • junit-platform-commons
  • junit-platform-console
  • junit-platform-engine
  • junit-platform-gradle-plugin
  • junit-platform-launcher
  • junit-platform-runner
  • junit-platform-surefire-provider

• Group ID: org.junit.jupiter
• Version: 5.0.0-M2 or 5.0.0-SNAPSHOT
• Artifact IDs:
  • junit-jupiter-api
  • junit-jupiter-engine

• Group ID: org.junit.vintage
• Version: 4.12.0-M2 or 4.12.0-SNAPSHOT
• Artifact ID: junit-vintage-engine