Repository files navigation

This repository is the home ofJUnit 5.

• General Availability (GA):JUnit 5.9.3 (April 26, 2023)
• Preview (Milestone/Release Candidate): n/a

• User Guide
• Javadoc
• Release Notes
• Samples

Contributions to JUnit 5 are both welcomed and appreciated. For specific guidelinesregarding contributions, please seeCONTRIBUTING.md in the root directory of theproject. Those willing to use milestone or SNAPSHOT releases are encouragedto file feature requests and bug reports using the project'sissue tracker. Issues marked with anup-for-grabslabel are specifically targeted for community contributions.

Ask JUnit 5 related questions onStackOverflow or chat with the community onGitter.

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

Code coverage usingJaCoCo for the latest build is available onCodecov.

A code coverage report can also be generated locally via theGradle Wrapper byexecuting./gradlew -Ptesting.enableJaCoCo clean jacocoRootReport. The results will be availableinbuild/reports/jacoco/jacocoRootReport/html/index.html.

JUnit 5 utilizesGradle Enterprise forBuild Scans,Build Cache, andTest Distribution.

The latest Build Scans are available onge.junit.org. Currently,only core team members can publish Build Scans and use Test Distribution on that server.You can, however, publish a Build Scan toscans.gradle.com byusing the--scan parameter explicitly.

The remote Build Cache is enabled by default for everyone so that local builds can reusetask outputs from previous CI builds.

You needJDK 17 to build JUnit 5.Gradle toolchains are used to detect andpotentially download additional JDKs for compilation and test execution.

All modules can bebuilt andtested with theGradle Wrapper using the following command.

./gradlew build

All modules can beinstalled with theGradle Wrapper in a local Maven repository forconsumption in other projects via the following command.

./gradlew publishToMavenLocal

Consult theDependency Metadata section of theUser Guide for a list of all artifactsof the JUnit Platform, JUnit Jupiter, and JUnit Vintage.

See alsohttps://repo1.maven.org/maven2/org/junit/ for releases andhttps://oss.sonatype.org/content/repositories/snapshots/org/junit/ for snapshots.