JUnit 5

This repository is the home of JUnit 5.

Latest Releases

General Availability (GA): JUnit 5.9.3 (April 26, 2023)
Preview (Milestone/Release Candidate): JUnit 5.10.0-M1 (May 13, 2023)

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 up-for-grabs 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.

Gradle Enterprise

JUnit 5 utilizes Gradle Enterprise for Build Scans, Build Cache, and Test Distribution.

The latest Build Scans are available on ge.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 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 17 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.

Project Name	Stars	Repos Using This	Packages Using This	Most Recent Commit	Total Releases	Latest Release	Open Issues	License	Language
Junit5	5,780	8,483	3,734	10 hours ago	57	July 26, 2022	116	other	Java
✅ The 5th major version of the programmer-friendly testing framework for Java and the JVM
Gogradle	713			2 years ago	34	May 19, 2019	90	apache-2.0	Groovy
A Gradle Plugin Providing Full Support for Go
Multimodulegithubclient	214			3 years ago			2		Java
Example multi-module Android project with unit tests, dagger 2, test coverage and others
Gradle Pitest Plugin	173	8	1	4 months ago	30	November 27, 2022	32	apache-2.0	Groovy
Gradle plugin for PIT Mutation Testing
Unified Code Coverage Android	158			2 years ago			6	apache-2.0	Java
Mixing the coverage data from both Instrumented and Unit tests
Example Android	140			2 years ago			2	apache-2.0	Java
Android code coverage example with https://codecov.io
Android Root Coverage Plugin	135			a month ago	7	June 15, 2022	4	apache-2.0	Kotlin
A Gradle Plugin for Android developers that automatically configures Jacoco code coverage tasks for both combined and per module coverage reports, easier than ever.
Gradle Cobertura Plugin	120	8	39	3 years ago	33	October 31, 2020	32		Groovy
Gradle Cobertura Plugin
Jacocoeverywhere	113			5 years ago	4	February 21, 2016	8	apache-2.0	Groovy
[Deprecated] Gradle plugin which allows to generate Jacoco coverage report for both integration & unit tests
Gradle Jacoco Coverage	93			6 years ago			5	apache-2.0	Groovy

Junit5