/zio-test-intellij

An optional ZIO Test runner support module for the ZIO IntelliJ plugin

Primary LanguageShellApache License 2.0Apache-2.0

ZIO Test runner support for the ZIO IntelliJ plugin

Project Stage CI Release Snapshot Discord
Project stage CI Release Artifacts Snapshot Artifacts Badge-Discord

Summary

This is an optional dependency module, providing enhanced test runner support in the ZIO IntelliJ plugin for ZIO 1.x.

Once enabled, the test results will be rendered in the integrated IntelliJ test runner, allowing navigation, sorting, retrying failed tests and more!

Usage

If you have the ZIO IntelliJ plugin installed, the first time you'll open a project with ZIO, the following prompt will appear in your IntelliJ:

After clicking Download ZIO Test runner will automatically download the right version for your ZIO/Scala versions. The next time you'll run your tests from IntelliJ, they will run in the integrated runner.

Please report any issues in the parent project: ZIO IntelliJ plugin.

Q&A

What's the difference between this and ZIO IntelliJ plugin?

This is an optional library dependency, allowing the test runner to output results in a format that IntelliJ/TeamCity can understand.

When enabled, IntelliJ will use it to render the test output in the integrated runner. Otherwise, the output from the ZIO test runner will be displayed in the standard process output console.

Why have a separate library at all?

Due to the way IntelliJ currently works, it makes it very difficult to include libraries that target a specific version of third-party libraries or different Scala versions. IntelliJ's own Scala plugin currently targets Scala 2.13.2, so all plugin developers that depend on it must target this version as well. The ZIO Plugin depends on the Scala plugin for Scala code analysis and other Scala-specific features.

Separating the library allows decoupling the plugin from any specific ZIO version, allowing separate and independent release cycles.

I found a bug/have a feature request!

Great! Please report it to the ZIO IntelliJ plugin repo.

Contributing

Documentation for contributors

Code of Conduct

See the Code of Conduct

Support

Come chat with us on Badge-Discord.

License

License