Cats-effect usage · Weaver Test

Installation

You'll need to install the following depending to test your programs against cats.effect.IO

SBT

libraryDependencies +=  "com.disneystreaming" %% "weaver-cats" % "0.8.3" % Test
testFrameworks += new TestFramework("weaver.framework.CatsEffect")

Mill

object test extends Tests {
  def ivyDeps = Agg(
    ivy"com.disneystreaming::weaver-cats:0.8.3"
  )
  def testFramework = "weaver.framework.CatsEffect"
}

scala-cli

//> using lib "com.disneystreaming::weaver-cats:0.8.1"
//> using testFramework "weaver.framework.CatsEffect" // this may neccessary if you have other TestFramework on your dependencies

Usage

Start with importing the following :

import weaver._

The most basic usage is to extend SimpleIOSuite. Tests are registered imperatively, very much like in scalatest's FunSuite or in utest, but their bodies are "weaved" together in a single IO that the framework executes when the build tool asks for it.

import cats.effect._

// Suites must be "objects" for them to be picked by the framework
object MySuite extends SimpleIOSuite {

  val randomUUID = IO(java.util.UUID.randomUUID())

  // A test for side-effecting functions
  test("hello side-effects") {
    for {
      x <- randomUUID
      y <- randomUUID
    } yield expect(x != y)
  }

}