Awesome
<img src="https://junit.org/junit5/assets/img/junit5-logo.png" align="right" width="100">JUnit 5
This repository is the home of JUnit 5.
Sponsors
- Gold Sponsors: JetBrains
- Silver Sponsors: Micromata, Quo Card
- Bronze Sponsors: Premium Minds, Testmo, codefortynine, Info Support, Stiltsoft, Code Intelligence, Route4Me
Latest Releases
- General Availability (GA): JUnit 5.11.0 (August 14, 2024)
- Preview (Milestone/Release Candidate): N/A
Documentation
Contributing
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
<a href="https://github.com/junit-team/junit5/issues?q=is%3Aissue+is%3Aopen+label%3Aup-for-grabs">up-for-grabs
</a>
label are specifically targeted for community contributions.
Getting Help
Ask JUnit 5 related questions on StackOverflow or chat with the community on Gitter.
Continuous Integration Builds
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
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 -Ptesting.enableJaCoCo clean jacocoRootReport
. The results will be available
in build/reports/jacoco/jacocoRootReport/html/index.html
.
Develocity
JUnit 5 utilizes Develocity for Build Scans, Build Cache, and Predictive Test Selection.
The latest Build Scans are available on ge.junit.org. Currently,
only core team members can publish Build Scans on that server.
You can, however, publish a Build Scan to scans.gradle.com by
using the --scan
parameter explicitly.
The remote Build Cache is enabled by default for everyone so that local builds can reuse task outputs from previous CI builds.
Building from Source
You need JDK 21 to build JUnit 5. Gradle toolchains are used to detect and potentially download additional JDKs for compilation and test execution.
All modules can be built and tested with the Gradle Wrapper using the following command.
./gradlew build
Installing in Local Maven Repository
All modules can be installed with the Gradle Wrapper in a local Maven repository for consumption in other projects via the following command.
./gradlew publishToMavenLocal
Dependency Metadata
Consult the Dependency Metadata section of the User Guide for a list of all artifacts of 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.