https://github.com/junit-team/junit-framework
✅ The programmer-friendly testing framework for Java and the JVM
https://github.com/junit-team/junit-framework
java junit junit-jupiter junit-platform junit-vintage kotlin kotlin-testing test-framework
Last synced: about 14 hours ago
JSON representation
✅ The programmer-friendly testing framework for Java and the JVM
- Host: GitHub
- URL: https://github.com/junit-team/junit-framework
- Owner: junit-team
- License: epl-2.0
- Created: 2015-01-11T19:06:10.000Z (over 10 years ago)
- Default Branch: main
- Last Pushed: 2025-06-23T10:29:42.000Z (2 days ago)
- Last Synced: 2025-06-23T11:27:06.479Z (2 days ago)
- Topics: java, junit, junit-jupiter, junit-platform, junit-vintage, kotlin, kotlin-testing, test-framework
- Language: Java
- Homepage: https://junit.org
- Size: 35.2 MB
- Stars: 6,704
- Watchers: 271
- Forks: 1,559
- Open Issues: 131
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# 
JUnit
This repository is the home of JUnit Platform, Jupiter, and Vintage.
## Sponsors
[](https://junit.org/sponsoring)
* **Gold Sponsors:** [JetBrains](https://jb.gg/junit-logo), [Netflix](https://www.netflix.com/)
* **Silver Sponsors:** [Micromata](https://www.micromata.de), [Quo Card](https://quo-digital.jp)
* **Bronze Sponsors:** [Premium Minds](https://www.premium-minds.com), [codefortynine](https://codefortynine.com), [Info Support](https://www.infosupport.com), [Code Intelligence](https://www.code-intelligence.com), [Route4Me](https://route4me.com/), [Testiny](https://www.testiny.io/)
## Latest Releases
- General Availability (GA): [JUnit 5.13.2](https://github.com/junit-team/junit-framework/releases/tag/r5.13.2) (June 24, 2025)
- Preview (Milestone/Release Candidate): [JUnit 5.13.0-RC1](https://github.com/junit-team/junit-framework/releases/tag/r5.13.0-RC1) (May 16, 2025)
## Documentation
- [User Guide]
- [Javadoc]
- [Release Notes]
- [Examples]
## Contributing
Contributions to JUnit 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](https://github.com/junit-team/junit-framework/issues). Issues marked with an
`up-for-grabs`
label are specifically targeted for community contributions.
## Getting Help
Ask JUnit-related questions on [StackOverflow] or use the Q&A category on [GitHub Discussions].
## Continuous Integration Builds
[](https://github.com/junit-team/junit-framework/actions/workflows/main.yml) [](https://github.com/junit-team/junit-framework/actions/workflows/cross-version.yml)
Official CI build server 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 clean jacocoRootReport`. The results will be available
in `build/reports/jacoco/jacocoRootReport/html/index.html`.
## Develocity
[](https://ge.junit.org/scans)
JUnit utilizes [Develocity](https://gradle.com/) for [Build Scans](https://scans.gradle.com/),
[Build Cache](https://docs.gradle.org/current/userguide/build_cache.html), and
[Predictive Test Selection](https://docs.gradle.com/enterprise/predictive-test-selection/).
The latest Build Scans are available on [ge.junit.org](https://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](https://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 24] to build JUnit. [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`
All modules can be _installed_ in a local Maven repository for consumption in other local
projects via the following command:
`./gradlew publishToMavenLocal`
## Dependency Metadata
[](https://central.sonatype.com/search?namespace=org.junit.jupiter)
[](https://central.sonatype.com/search?namespace=org.junit.vintage)
[](https://central.sonatype.com/search?namespace=org.junit.platform)
Consult the [Dependency Metadata] section of the [User Guide] for a list of all artifacts
of the JUnit Platform, JUnit Jupiter, and JUnit Vintage.
[Codecov]: https://codecov.io/gh/junit-team/junit-framework
[CONTRIBUTING.md]: https://github.com/junit-team/junit-framework/blob/HEAD/CONTRIBUTING.md
[Dependency Metadata]: https://docs.junit.org/current/user-guide/#dependency-metadata
[GitHub Discussions]: https://github.com/junit-team/junit-framework/discussions/categories/q-a
[Gradle toolchains]: https://docs.gradle.org/current/userguide/toolchains.html
[Gradle Wrapper]: https://docs.gradle.org/current/userguide/gradle_wrapper.html#sec:using_wrapper
[JaCoCo]: https://www.eclemma.org/jacoco/
[Javadoc]: https://docs.junit.org/current/api/
[JDK 24]: https://javaalmanac.io/jdk/24/
[Release Notes]: https://docs.junit.org/current/release-notes/
[Examples]: https://github.com/junit-team/junit-examples
[StackOverflow]: https://stackoverflow.com/questions/tagged/junit5
[User Guide]: https://docs.junit.org/current/user-guide/