Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sbt/sbt-jupiter-interface
Implementation of sbt's test interface for JUnit 5's Jupiter module
https://github.com/sbt/sbt-jupiter-interface
sbt-plugin scala testing
Last synced: 4 days ago
JSON representation
Implementation of sbt's test interface for JUnit 5's Jupiter module
- Host: GitHub
- URL: https://github.com/sbt/sbt-jupiter-interface
- Owner: sbt
- License: apache-2.0
- Created: 2017-07-08T09:44:11.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-28T19:53:53.000Z (16 days ago)
- Last Synced: 2024-10-28T20:40:46.465Z (16 days ago)
- Topics: sbt-plugin, scala, testing
- Language: Java
- Homepage:
- Size: 263 KB
- Stars: 33
- Watchers: 6
- Forks: 18
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Jupiter Interface
=================
[](https://github.com/sbt/sbt-jupiter-interface/actions/workflows/ci.yml)
[](https://raw.githubusercontent.com/sbt/sbt-jupiter-interface/main/LICENSE)
An implementation of [sbt's test interface](https://github.com/sbt/test-interface) for [JUnit Jupiter](http://junit.org/junit5). This allows you to run JUnit 5 tests from [sbt](http://www.scala-sbt.org/).
The code is split into:
* `jupiter-interface`: a pure Java runtime library. The runtime library is written in pure Java and does all the heavy lifting like collecting and running tests.
* `sbt-jupiter-interface`: sbt plugin. The sbt plugin makes the runtime library available to the sbt build by adding it to `sbt.Keys.testFrameworks`. It also overwrites `sbt.Keys.detectTests` with a custom task that uses JUnits discovery mechanism to collect available tests. This step is necessary since sbt is currently not capable of detecting package private test classes.
## Usage
Add the following line to `./project/plugins.sbt`:
```scala
addSbtPlugin("com.github.sbt.junit" % "sbt-jupiter-interface" % "x.y.z")
```
**Note**: We changed the organization from `"net.aichler"` to `"com.github.sbt.junit"` starting 0.11.3.
Additionally a `Test` dependency to the runtime library `jupiter-interface` is required for every module which wants to run JUnit 5 tests:
```scala
libraryDependencies ++= Seq(
"com.github.sbt.junit" % "jupiter-interface" % JupiterKeys.jupiterVersion.value % Test
)
```
Note: If you want to restore default behaviour like in versions before `0.8.0` you can globally activate this plugin by adding the runtime dependency to `ThisBuild / libraryDependencies`:
```scala
ThisBuild / libraryDependencies += "com.github.sbt.junit" % "jupiter-interface" % JupiterKeys.jupiterVersion.value % Test
```
## Releases
sbt Plugin | JUnit Platform | JUnit Engine
:----------------|:---------------|:-------------
0.13.x | 1.11.x | 5.11.x
0.12.x | 1.10.x | 5.10.x
0.11.x | 1.9.x | 5.9.x
0.10.x | 1.8.x | 5.8.x
0.9.x | 1.7.x | 5.7.x
0.8.x | 1.1.x | 5.1.x
0.7.x | 1.1.0 | 5.1.0
0.6.x | 1.0.0 | 5.0.0
0.5.x | 1.0.0 | 5.0.0
0.4.x | 1.0.0-RC2 | 5.0.0-RC2
0.3.x | 1.0.0-M6 | 5.0.0-M6
0.2.x | 1.0.0-M5 | 5.0.0-M5
0.1.x | 1.0.0-M4 | 5.0.0-M4
**Note** `0.9.0`+ artifacts are published on Maven Central via Sonatype OSS. Previous versions were available via , whose underlying host has migrated from Bintray to Scala Center Artifactory instance.
## Framework Options
The following options are supported when running JUnit Jupiter tests:
Option | Description
:---------------------------------|:---------------------------------
`-v` | Log "test run started" / "test started" / "test run finished" events on log level "info" instead of "debug".
`-q` | Suppress `STDOUT` for successful tests. Does not affect `STDERR` which is printed to the console normally. If a test fails the previously buffered output is dumped to the console.
`-n` | Do not use ANSI colors in the output even if sbt reports that they are supported.
`-s` | Try to decode Scala names in stack traces and test names. Fall back silently to non-decoded names if no matching Scala library is on the class path.
`-a` | Show stack traces and exception class name for AssertionErrors (thrown by all assert* methods in JUnit).`
`-c` | Do not print the exception class name prefix for any messages. With this option, only the result of getMessage() plus a stack trace is shown.
`+v` | Turn off `-v`. Takes precedence over `-v`.
`+q` | Turn off `-q`. Takes precedence over `-q`.
`+n` | Turn off `-n`. Takes precedence over `-n`.
`+s` | Turn off `-s`. Takes precedence over `-s`.
`+a` | Turn off `-a`. Takes precedence over `-a`.
`+c` | Turn off `-c`. Takes precedence over `-c`.
`--display-mode=` | Select an output display mode for when tests are executed. Use either `flat` or `tree`.
`--tests=` | Run only the tests whose names match one of the specified regular expressions (in a comma-separated list). Non-matched tests are ignored. Only individual test case names are matched, not test classes. Example: For test `MyClassTest.testBasic()` only "testBasic" is matched. Use sbt's `test-only` command instead to match test classes.
`-Dkey=value` | Temporarily set a system property for the duration of the test run. The property is restored to its previous value after the test has ended. Note that system properties are global to the entire JVM and they can be modified in a non-transactional way, so you should run tests serially and not perform any other tasks in parallel which depend on the modified property.
`--run-listener=` | A (user defined) class which extends either `org.junit.platform.launcher.TestExecutionListener` or `com.github.sbt.junit.jupiter.api.JupiterTestListener`. An instance of this class is created and added to the JUnit Launcher, so that it will receive test execution events. For more information, see [TestExecutionListener](http://junit.org/junit5/docs/current/api/org/junit/platform/launcher/TestExecutionListener.html). *Note: this uses the test-classloader, so the class needs to be defined in `src/test` or `src/main` or included as a test or compile dependency*
`--include-tags=` | A comma separated list of tag expressions which should be included. Only tests matching one or more of those expressions will be run.
`--exclude-tags=` | A comma separated list of tag expressions which should be excluded. Any test matching one or more of those expressions will not be run.
`--trace-dispatch-events` | Write dispatch events to file `target/jupiterDispatchEvents.log` (used internally to test the event dispatcher).
`--with-types` | When using the standard `flat` display mode, this flag causes the internal JUnit types of test identifiers to be added to the test name.
Any parameter not starting with `-` or `+` is treated as a glob pattern for matching tests. Unlike the patterns given directly to sbt's `test-only` command, the patterns given to jupiter-interface will match against the full test names (as displayed by jupiter-interface) of all atomic test cases, so you can match on test methods and parts of suites.
You can set default options in your build.sbt file:
```scala
testOptions += Tests.Argument(jupiterTestFramework, "-q", "-v")
```
Or use them with the `testQuick` and `testOnly` commands:
```scala
testOnly -- +q +v *Sequence*h2mem*
```
### Tag Expressions
Tag expressions can be used with `--include-tags` and `exclude-tags` respectively.
```scala
testOnly -- --include-tags=(micro&product),(micro&shipping)
```
Special care has to be taken if any expression contains white-space. In that case the entire parameter needs to be enclosed by double quotes.
```scala
testOnly -- "include-tags=(micro & product),(micro & shipping)"
```
Please see the corresponding chapter in [JUnit Documentation](https://junit.org/junit5/docs/current/user-guide/#running-tests-tag-expressions) for a detailed description on how to build tag expressions.
## Credits
* Jupiter Interface was originally developed by Michael Aichler in 2017.
* This plugin is heavily inspired by [JUnit Interface](https://github.com/sbt/junit-interface) and the console launcher from [JUnit Team](https://github.com/junit-team/junit5). Parts of the output capturing is based on code from [Apache Geronimo GShell](http://geronimo.apache.org/gshell/index.html).