From bc3e78404ccb493faf92d5a4c16094ddaab7db1b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marco=20Zu=CC=88hlke?= Date: Fri, 19 Apr 2024 22:55:05 +0200 Subject: [PATCH] Documentation updates * mention that IntelliJ Junit Plugin is required * describe how to configure Maven * update platform table * add munit-scalacheck to integrations Fixes #107 Fixes #354 --- docs/getting-started.md | 27 +++++++++++++++++----- docs/integrations/external-integrations.md | 1 + docs/tests.md | 2 +- 3 files changed, 23 insertions(+), 7 deletions(-) diff --git a/docs/getting-started.md b/docs/getting-started.md index 2c5b1405..1c85f6e6 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -45,12 +45,26 @@ object test extends Tests with TestModule.Munit { } ``` -| Scala Version | JVM | Scala.js (0.6.x) | Scala.js (1.x) | Native (0.4.x) | -| ------------- | :-: | :--------------: | :------------: | :------------: | -| 2.11.x | ✅ | ✅ until 0.7.16 | ✅ | ✅ | -| 2.12.x | ✅ | ✅ until 0.7.16 | ✅ | ✅ | -| 2.13.x | ✅ | ✅ until 0.7.16 | ✅ | ✅ | -| 3.0.x | ✅ | n/a | ✅ | n/a | +**Maven** + +```xml + + org.scalameta + munit_3 + @STABLE_VERSION@ + test + +``` +The complete setup can be seen in a Maven g8 template [scalameta/maven-scala-seed.g8](https://github.com/scalameta/maven-scala-seed.g8) + +### Supported Platforms + +| Scala Version | JVM | Scala.js (0.6.x) | Scala.js (1.x) | Native (0.4.x) | Native (0.5.x) | +|---------------| :-: | :--------------: | :------------: | :------------: | :------------: | +| 2.11.x | ✅ | ✅ until 0.7.16 | ✅ | ✅ | n/a | +| 2.12.x | ✅ | ✅ until 0.7.16 | ✅ | ✅ | ✅ | +| 2.13.x | ✅ | ✅ until 0.7.16 | ✅ | ✅ | ✅ | +| 3.x | ✅ | n/a | ✅ | n/a | ✅ | Next, write a test suite. @@ -84,6 +98,7 @@ Use `testOnly` to run only a single test suite in the sbt shell. ### Run tests in IntelliJ MUnit test suites can be executed from in IntelliJ like normal test suites. +Please ensure that the JUnit plugin is enabled. ![Running MUnit from IntelliJ](https://i.imgur.com/oAA2ZeQ.png) diff --git a/docs/integrations/external-integrations.md b/docs/integrations/external-integrations.md index 2e6ebfe2..efb9b86b 100644 --- a/docs/integrations/external-integrations.md +++ b/docs/integrations/external-integrations.md @@ -9,6 +9,7 @@ Feel free to add your project to this list by submitting a pull request - [discipline-munit](https://github.com/typelevel/discipline-munit): MUnit binding for Typelevel Discipline - [http4s-munit](https://github.com/alejandrohdezma/http4s-munit): Integration library between MUnit and http4s - [munit-cats-effect](https://github.com/typelevel/munit-cats-effect): Integration library for MUnit & cats-effect +- [munit-scalacheck](https://github.com/scalameta/munit-scalacheck): Scalacheck integration for MUnit - [munit-snapshot](https://github.com/lolgab/munit-snapshot): Snapshot testing for MUnit - [munit-zio](https://github.com/poslegm/munit-zio): MUnit and ZIO integration - [pact4s](https://github.com/jbwheatley/pact4s): Consumer driven contract testing diff --git a/docs/tests.md b/docs/tests.md index eaa2651a..a8e9f401 100644 --- a/docs/tests.md +++ b/docs/tests.md @@ -116,7 +116,7 @@ class CustomTimeoutSuite extends munit.FunSuite { ``` > Note that `munitTimeout` is only respected for async tests in the stable -> version version of MUnit (v0.x series). The setting is ignored by normal +> version of MUnit (v0.x series). The setting is ignored by normal > non-async tests. However, starting with MUnit v1.0 (latest milestone release: > @VERSION@), the timeout applies to all tests including non-async tests.