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

• General Availability (GA): JUnit 5.5.2 (September 8, 2019).
• Preview (Milestone/Release Candidate): JUnit 5.6.0 M1 (October 21, 2019)

• User Guide
• Javadoc
• Release Notes
• Samples

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 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.

Ask JUnit 5 related questions on StackOverflow or chat with the team and the community on Gitter.

Official CI build server for JUnit 5. Used to perform quick checks on submitted pull requests and for build matrices including the latest released OpenJDK and early access builds of the next OpenJDK.

Code coverage using JaCoCo for the latest build is available on Codecov.

A code coverage report can also be generated locally via the Gradle Wrapper by executing gradlew -PenableJaCoCo clean jacocoRootReport. The results will be available in build/reports/jacoco/jacocoRootReport/html/index.html.

JUnit 5 utilizes Gradle's support for Build Scans. An example build scan for JUnit 5 can be viewed here.

You need JDK 11 to build JUnit 5.

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

gradlew clean assemble

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

gradlew clean test

Since Gradle has excellent incremental build support, you can usually omit executing the clean task.

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

gradlew clean publishToMavenLocal

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

See also https://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.5.2, 1.6.0-M1, or 1.6.0-SNAPSHOT
• Artifact IDs and Java module name:
  • junit-platform-commons (org.junit.platform.commons)
  • junit-platform-console (org.junit.platform.console)
  • junit-platform-console-standalone (N/A)
  • junit-platform-engine (org.junit.platform.engine)
  • junit-platform-launcher (org.junit.platform.launcher)
  • junit-platform-reporting (org.junit.platform.reporting)
  • junit-platform-runner (org.junit.platform.runner)
  • junit-platform-suite-api (org.junit.platform.suite.api)
  • junit-platform-testkit (org.junit.platform.testkit)

• Group ID: org.junit.jupiter
• Version: 5.5.2, 5.6.0-M1, or 5.6.0-SNAPSHOT
• Artifact IDs and Java module name:
  • junit-jupiter (org.junit.jupiter)
  • junit-jupiter-api (org.junit.jupiter.api)
  • junit-jupiter-engine (org.junit.jupiter.engine)
  • junit-jupiter-migrationsupport (org.junit.jupiter.migrationsupport)
  • junit-jupiter-params (org.junit.jupiter.params)

• Group ID: org.junit.vintage
• Version: 5.5.2, 5.6.0-M1, or 5.6.0-SNAPSHOT
• Artifact ID and Java module name:
  • junit-vintage-engine (org.junit.vintage.engine)

• Group ID: org.junit
• Artifact ID junit-bom
• Version: 5.5.2, 5.6.0-M1, or 5.6.0-SNAPSHOT