The next generation of JUnit.
Java Groovy
Latest commit 62ec592 Jan 19, 2017 @sormuras sormuras committed with sbrannen Add details parsing fix and tests. (#634)
Permalink
Failed to load latest commit information.
.github Fixed spotless issue Feb 24, 2016
buildSrc Inline jopt-simple into junit-platform-console Oct 23, 2016
documentation Update console launcher output showing new default tree details (#632) Jan 19, 2017
gradle Upgrade to Gradle 3.3 Jan 4, 2017
junit-jupiter-api Fix <pre> tags in JavaDoc regarding class attribute Jan 19, 2017
junit-jupiter-engine Fix <pre> tags in JavaDoc regarding class attribute Jan 19, 2017
junit-jupiter-migration-support Fix <pre> tags in JavaDoc regarding class attribute Jan 19, 2017
junit-platform-commons Update license headers Jan 2, 2017
junit-platform-console Add details parsing fix and tests. (#634) Jan 19, 2017
junit-platform-engine Polish JavaDoc regarding fully qualified method names Jan 17, 2017
junit-platform-gradle-plugin Polishing Jan 19, 2017
junit-platform-launcher Fix <pre> tags in JavaDoc regarding class attribute Jan 19, 2017
junit-platform-runner Delete deprecated @IncludeClassNamePattern Jan 17, 2017
junit-platform-surefire-provider Fix <pre> tags in JavaDoc regarding class attribute Jan 19, 2017
junit-vintage-engine Fix <pre> tags in JavaDoc regarding class attribute Jan 19, 2017
platform-tests Add details parsing fix and tests. (#634) Jan 19, 2017
src Update license header templates Jan 2, 2017
.gitattributes Ensure Spotless works on Microsoft Windows Jul 15, 2016
.gitignore Clover settings for Travis Feb 5, 2016
.travis.yml Fix Travis build Nov 25, 2016
CONTRIBUTING.md Update documentation on licenses (#541) Nov 1, 2016
LICENSE.md Update documentation on licenses (#541) Nov 1, 2016
README.md Add missing junit-jupiter-migration-support artifact Jan 15, 2017
build.gradle Remove removeUnusedImports() from spotless config. Jan 10, 2017
clover.license.enc Clover settings for Travis Feb 5, 2016
gradle.properties Back to snapshots for further development Nov 30, 2016
gradlew Upgrade to Gradle 3.2.1 Nov 23, 2016
gradlew.bat Upgrade to Gradle 3.0 Aug 15, 2016
settings.gradle Move rule support to dedicated module Nov 25, 2016

README.md

JUnit 5

This repository is the home of the next generation of JUnit, JUnit 5.

The project is currently in Phase 5, working toward additional milestone releases.

JUnit 5.0.0-M3 was released on November 30, 2016.

Roadmap

Consult the wiki for details on the current JUnit 5 roadmap.

Documentation

User Guide

The JUnit 5 User Guide is available online.

API

The JUnit 5 Javadoc is available online.

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 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.

Continuous Integration Builds

CI Server OS Status Description
Jenkins Linux Build Status Official CI build server for JUnit 5
Travis CI Linux Travis CI build status Used to perform quick checks on submitted pull requests and for build matrices including JDK 8 and JDK 9 early access builds
AppVeyor Windows Build status Used to ensure that JUnit 5 can be built on Windows

Code Coverage

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.

Gradle Build Scans

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.

Building from Source

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.

Installing in Local Maven Repository

All modules can be installed in a local Maven repository for consumption in other projects via the following command.

gradlew clean install

Dependency Metadata

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.

JUnit Platform

  • Group ID: org.junit.platform
  • Version: 1.0.0-M3 or 1.0.0-SNAPSHOT
  • Artifact IDs:
    • junit-platform-commons
    • junit-platform-console
    • junit-platform-engine
    • junit-platform-gradle-plugin
    • junit-platform-launcher
    • junit-platform-runner
    • junit-platform-surefire-provider

JUnit Jupiter

  • Group ID: org.junit.jupiter
  • Version: 5.0.0-M3 or 5.0.0-SNAPSHOT
  • Artifact IDs:
    • junit-jupiter-api
    • junit-jupiter-engine
    • junit-jupiter-migration-support

JUnit Vintage

  • Group ID: org.junit.vintage
  • Version: 4.12.0-M3 or 4.12.0-SNAPSHOT
  • Artifact ID: junit-vintage-engine