This repository is the home of the next generation of JUnit, JUnit 5.
The project is currently in Phase 6, working toward one or more release candidates.
JUnit 5.0.0-RC2 was released on July 30, 2017.
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.
Ask JUnit 5 related questions on StackOverflow or chat with us on Gitter.
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
.
JUnit 5 utilizes Gradle's support for Build Scans. An example build scan for JUnit 5 can be viewed here. Note, however, that the number of listed tests only reflects the Spock tests within the JUnit 5 test suite. To see a full representation of the number of tests executed per project, click on "See console output" on the build scan page.
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
Since Gradle has excellent incremental build support, you can usually omit executing the clean
task.
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-RC2
or1.0.0-SNAPSHOT
- Artifact IDs:
junit-platform-commons
junit-platform-console
junit-platform-console-standalone
junit-platform-engine
junit-platform-gradle-plugin
junit-platform-launcher
junit-platform-runner
junit-platform-suite-api
junit-platform-surefire-provider
- Group ID:
org.junit.jupiter
- Version:
5.0.0-RC2
or5.0.0-SNAPSHOT
- Artifact IDs:
junit-jupiter-api
junit-jupiter-engine
junit-jupiter-migrationsupport
junit-jupiter-params
- Group ID:
org.junit.vintage
- Version:
4.12.0-RC2
or4.12.0-SNAPSHOT
- Artifact ID:
junit-vintage-engine