sailfork / t3code-github / .repos/ effect/ packages/ vitest/ test/ index.test.ts

import { afterAll, assert, beforeAll, beforeEach, describe, describeWrapped, expect, it, layer } from "@effect/vitest"
import * as testAssert from "@effect/vitest/utils"
import { Clock, Context, Duration, Effect, Fiber, Layer, Schema } from "effect"
import * as Arbitrary from "effect/Arbitrary"
import { TestClock } from "effect/testing"

it.effect(
  "effect",
  () => Effect.acquireRelease(Effect.sync(() => expect(1).toEqual(1)), () => Effect.void)
)
it.live(
  "live",
  () => Effect.acquireRelease(Effect.sync(() => expect(1).toEqual(1)), () => Effect.void)
)

it("throws fails when the thunk does not throw", () => {
  expect(() => testAssert.throws(() => {})).toThrow()
})

it("throwsAsync fails when the promise resolves", async () => {
  await expect(testAssert.throwsAsync(() => Promise.resolve())).rejects.toThrow()
})

it("deepStrictEqual fails with the assertion diff when no message is given", () => {
  expect(() => testAssert.deepStrictEqual({ a: 1 }, { a: 2 })).toThrow("Expected values to be strictly deep-equal")
})

it("notDeepStrictEqual fails with the assertion message when no message is given", () => {
  expect(() => testAssert.notDeepStrictEqual({ a: 1 }, { a: 1 })).toThrow("not to be strictly deep-equal")
})

// each

it.effect.each([1, 2, 3])(
  "effect each %s",
  (n) => Effect.acquireRelease(Effect.sync(() => expect(n).toEqual(n)), () => Effect.void)
)
it.live.each([1, 2, 3])(
  "live each %s",
  (n) => Effect.acquireRelease(Effect.sync(() => expect(n).toEqual(n)), () => Effect.void)
)

// skip

it.live.skip(
  "live skipped",
  () => Effect.die("skipped anyway")
)
it.effect.skip(
  "effect skipped",
  () => Effect.die("skipped anyway")
)

// skipIf

it.effect.skipIf(true)("effect skipIf (true)", () => Effect.die("skipped anyway"))
it.effect.skipIf(false)("effect skipIf (false)", () => Effect.sync(() => expect(1).toEqual(1)))

// runIf

it.effect.runIf(true)("effect runIf (true)", () => Effect.sync(() => expect(1).toEqual(1)))
it.effect.runIf(false)("effect runIf (false)", () => Effect.die("not run anyway"))

// chained helpers

it.describe.each(["foo", "bar"] as const)("describe.each %s", (text) => {
  it.effect("runs an Effect test", () =>
    Effect.sync(() => {
      assert.include(["foo", "bar"], text)
    }))
})

it.skip.each([1])("skip.each %s", () => assert.fail("skipped anyway"))

// The following test is expected to fail because it simulates a test timeout.
// Be aware that eventual "failure" of the test is only logged out.
it.live.fails("interrupts on timeout", (ctx) =>
  Effect.gen(function*() {
    let acquired = false

    ctx.onTestFailed(() => {
      if (acquired) {
        // oxlint-disable-next-line no-console
        console.error("'effect is interrupted on timeout' @effect/vitest test failed")
      }
    })

    yield* Effect.acquireRelease(
      Effect.sync(() => acquired = true),
      () => Effect.sync(() => acquired = false)
    )
    yield* Effect.sleep(1000)
  }), 1)

class Foo extends Context.Service<Foo, "foo">()("Foo") {
  static layer = Layer.succeed(Foo)("foo")
}

class Bar extends Context.Service<Bar, "bar">()("Bar") {
  static layer = Layer.effect(Bar)(Effect.map(Foo, () => "bar" as const))
}

class Sleeper extends Context.Service<Sleeper, {
  readonly sleep: (ms: number) => Effect.Effect<void>
}>()("Sleeper") {
  static readonly layer = Layer.effect(Sleeper)(
    Effect.gen(function*() {
      const clock = yield* Clock.Clock

      return {
        sleep: (ms: number) => clock.sleep(Duration.millis(ms))
      }
    })
  )
}

describe("layer", () => {
  layer(Foo.layer)((it) => {
    it.effect("adds context", () =>
      Effect.gen(function*() {
        const foo = yield* Foo
        expect(foo).toEqual("foo")
      }))

    it.layer(Bar.layer)("nested", (it) => {
      it.effect("adds context", () =>
        Effect.gen(function*() {
          const foo = yield* Foo
          const bar = yield* Bar
          expect(foo).toEqual("foo")
          expect(bar).toEqual("bar")
        }))
    })

    it.layer(Bar.layer)((it) => {
      it.effect("without name", () =>
        Effect.gen(function*() {
          const foo = yield* Foo
          const bar = yield* Bar
          expect(foo).toEqual("foo")
          expect(bar).toEqual("bar")
        }))
    })

    describe("release", () => {
      let released = false
      afterAll(() => {
        expect(released).toEqual(true)
      })

      class Scoped extends Context.Service<Scoped, "scoped">()("Scoped") {
        static layer = Layer.effect(Scoped)(
          Effect.acquireRelease(
            Effect.succeed("scoped" as const),
            () => Effect.sync(() => released = true)
          )
        )
      }

      it.layer(Scoped.layer)((it) => {
        it.effect("adds context", () =>
          Effect.gen(function*() {
            const foo = yield* Foo
            const scoped = yield* Scoped
            expect(foo).toEqual("foo")
            expect(scoped).toEqual("scoped")
          }))
      })

      it.effect.prop(
        "adds context",
        [realNumber],
        ([num]) =>
          Effect.gen(function*() {
            const foo = yield* Foo
            expect(foo).toEqual("foo")
            return num === num
          }),
        { arbitrary: { runs: 200 } }
      )

      it.effect.prop(
        "adds context with a Schema property",
        [Schema.Int],
        ([value]) =>
          Effect.gen(function*() {
            const foo = yield* Foo
            assert.strictEqual(foo, "foo")
            assert.isTrue(Number.isInteger(value))
          }),
        { arbitrary: { runs: 5, seed: "vitest-arbitrary-layer" } }
      )
    })
  })

  describe("release with retried or repeated tests", () => {
    const resources: Array<{ open: boolean }> = []
    afterAll(() => {
      expect(resources.map((resource) => resource.open)).toEqual([false, false])
    })

    class Resource extends Context.Service<Resource, { readonly open: boolean }>()("Resource") {
      static layer = Layer.effect(Resource)(
        Effect.acquireRelease(
          Effect.sync(() => {
            const resource = { open: true }
            resources.push(resource)
            return resource
          }),
          (resource) => Effect.sync(() => resource.open = false)
        )
      )
    }

    const assertOpen = Effect.map(Resource, (resource) => expect(resource.open).toEqual(true))

    it.layer(Resource.layer)((it) => {
      it.effect("retried", ({ task }) =>
        Effect.andThen(
          assertOpen,
          task.result?.retryCount === 0 ? Effect.die("first attempt fails") : Effect.void
        ), { retry: 1 })
      it.effect("after retried", () => assertOpen)
    })

    it.layer(Resource.layer)((it) => {
      it.effect("repeated", () => assertOpen, { repeats: 1 })
      it.effect("after repeated", () => assertOpen)
    })
  })

  describe("anonymous layer next to a Vitest fixture", () => {
    const withValue = it.extend("value", () => 1)

    layer(Foo.layer)((it) => {
      it.effect("provides its context", () => Effect.map(Foo, (foo) => expect(foo).toEqual("foo")))
    })

    withValue("runs the fixture test", ({ value }) => {
      expect(value).toEqual(1)
    })
  })

  layer(Sleeper.layer)("test services", (it) => {
    it.effect("TestClock", () =>
      Effect.gen(function*() {
        const sleeper = yield* Sleeper
        const fiber = yield* Effect.forkChild(sleeper.sleep(100_000))
        yield* Effect.yieldNow
        yield* TestClock.adjust(100_000)
        yield* Fiber.join(fiber)
      }))
  })

  layer(Foo.layer)("with a name", (it) => {
    describe("with a nested describe", () => {
      it.effect("adds context", () =>
        Effect.gen(function*() {
          const foo = yield* Foo
          expect(foo).toEqual("foo")
        }))
    })
    it.effect("adds context", () =>
      Effect.gen(function*() {
        const foo = yield* Foo
        expect(foo).toEqual("foo")
      }))
  })

  layer(Sleeper.layer, { excludeTestServices: true })("live services", (it) => {
    it.effect("Clock", () =>
      Effect.gen(function*() {
        const sleeper = yield* Sleeper
        yield* sleeper.sleep(1)
      }))
  })
})

describeWrapped("describeWrapped", (it) => {
  it.layer(Foo.layer)("named layer", (it) => {
    it.effect("registers in its own suite", ({ task }) =>
      Effect.gen(function*() {
        assert.strictEqual(task.suite?.name, "named layer")
        assert.isTrue(task.suite?.tasks.includes(task))
        assert.strictEqual(yield* Foo, "foo")
      }))
  })
})

describe("Effect hooks", () => {
  let beforeAllRan = false
  let beforeEachRan = false

  beforeAll(() => Effect.sync(() => (beforeAllRan = true)))
  beforeEach(() => Effect.sync(() => (beforeEachRan = true)))

  it("runs Effects returned by beforeAll and beforeEach", () => {
    assert.isTrue(beforeAllRan)
    assert.isTrue(beforeEachRan)
  })
})

describe("scoped Effect hooks", { concurrent: false }, () => {
  const events: Array<string> = []
  const resource = (name: string) =>
    Effect.acquireRelease(
      Effect.sync(() => events.push(`${name}:acquired`)),
      () => Effect.sleep(10).pipe(Effect.andThen(Effect.sync(() => events.push(`${name}:released`))))
    )

  describe("suite", () => {
    beforeAll(() => resource("all"))
    beforeEach(() => resource("each"))

    it("keeps hook resources alive during the test", () => {
      assert.deepStrictEqual(events, ["all:acquired", "each:acquired"])
    })

    it("releases the beforeEach resource before the next test", () => {
      assert.deepStrictEqual(events, ["all:acquired", "each:acquired", "each:released", "each:acquired"])
    })
  })

  it("releases the beforeAll resource when the suite ends", () => {
    assert.deepStrictEqual(events, [
      "all:acquired",
      "each:acquired",
      "each:released",
      "each:acquired",
      "each:released",
      "all:released"
    ])
  })

  describe("failing hook", () => {
    beforeEach(() => resource("failed").pipe(Effect.andThen(Effect.fail("boom"))))
    it.fails("fails the test", () => {})
  })

  describe("hook returning a cleanup function", () => {
    beforeEach(() => resource("cleanup").pipe(Effect.as(() => events.push("cleanup:ran"))))
    it("runs the test", () => {})
  })

  describe("hook returning a throwing cleanup function", () => {
    beforeEach(() =>
      resource("throwing").pipe(Effect.as(() => {
        throw new Error("cleanup failed")
      }))
    )
    it.fails("reports the cleanup error", () => {})
  })

  it("closes the scope after a failure and after a returned cleanup function", () => {
    assert.deepStrictEqual(events.slice(6), [
      "failed:acquired",
      "failed:released",
      "cleanup:acquired",
      "cleanup:ran",
      "cleanup:released",
      "throwing:acquired",
      "throwing:released"
    ])
  })
})

// property testing

const realNumber = Schema.Finite
const textArbitrary = Arbitrary.schema(Schema.Literals(["a", "b"]))

it.prop(
  "schema with array",
  [Schema.String, Schema.Int],
  ([text, count]) => typeof text === "string" && Number.isInteger(count)
)

it.prop(
  "schema with object",
  { text: Schema.String, count: Schema.Int },
  ({ text, count }) => typeof text === "string" && Number.isInteger(count)
)

let mixedTupleRuns = 0
let mixedRecordRuns = 0
afterAll(() => {
  assert.strictEqual(mixedTupleRuns, 5)
  assert.strictEqual(mixedRecordRuns, 5)
})

it.prop(
  "Schema and Arbitrary with array",
  [Schema.Int, textArbitrary],
  ([count, text]) => {
    mixedTupleRuns++
    assert.isTrue(Number.isInteger(count))
    assert.include(["a", "b"], text)
  },
  { arbitrary: { runs: 5, maxDiscards: 0, seed: "vitest-mixed-tuple" } }
)

it.effect.prop(
  "Schema and Arbitrary with object",
  { count: Schema.Int, text: textArbitrary },
  ({ count, text }) =>
    Effect.sync(() => {
      mixedRecordRuns++
      assert.isTrue(Number.isInteger(count))
      assert.include(["a", "b"], text)
    }),
  { arbitrary: { runs: 5, maxDiscards: 0, seed: "vitest-mixed-record" } }
)

it.prop("symmetry", [realNumber, Schema.Int], ([a, b]) => a + b === b + a)

it.prop(
  "symmetry with object",
  { a: realNumber, b: Schema.Int },
  ({ a, b }) => a + b === b + a
)

it.live.prop(
  "schema with object",
  { value: Schema.Int },
  ({ value }) => Effect.sync(() => assert.isTrue(Number.isInteger(value)))
)

let arbitraryEffectRuns = 0
afterAll(() => assert.strictEqual(arbitraryEffectRuns, 5))

it.effect.prop(
  "schema with Arbitrary options",
  [Schema.String, Schema.Int],
  ([text, count]) =>
    Effect.sync(() => {
      arbitraryEffectRuns++
      assert.strictEqual(typeof text, "string")
      assert.isTrue(Number.isInteger(count))
    }),
  { arbitrary: { runs: 5, maxDiscards: 0, seed: "vitest-arbitrary" } }
)

it.effect.prop("symmetry", [realNumber, Schema.Int], ([a, b]) =>
  Effect.gen(function*() {
    yield* Effect.void
    assert.isTrue(a + b === b + a)
  }))

it.effect.prop("symmetry with object", { a: realNumber, b: Schema.Int }, ({ a, b }) =>
  Effect.gen(function*() {
    yield* Effect.void
    assert.strictEqual(a + b, b + a)
  }))

it.effect.prop(
  "should detect the substring",
  { a: Schema.String, b: Schema.String, c: Schema.String },
  ({ a, b, c }) =>
    Effect.gen(function*() {
      yield* Effect.scope
      assert.include(a + b + c, b)
    })
)

describe("property failures", () => {
  it.prop(
    "rejects Effect returns from synchronous properties",
    [Schema.Int],
    () => Effect.fail("must not silently pass") as unknown as void,
    { fails: true }
  )

  const Input = Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 1_000 }))
  const pureDefectValues: Array<number> = []
  const effectDefectValues: Array<number> = []
  let interruptedRuns = 0
  let timeoutPropertyStarted = false
  let timeoutPropertyReleased = false

  afterAll(() => {
    assert.deepStrictEqual(pureDefectValues, [8, 1])
    assert.deepStrictEqual(effectDefectValues, [8, 1])
    assert.strictEqual(interruptedRuns, 1)
    assert.isTrue(timeoutPropertyStarted)
    assert.isTrue(timeoutPropertyReleased)
  })

  it.prop(
    "shrinks synchronous defects",
    [Input],
    ([value]) => {
      pureDefectValues.push(value)
      throw new Error("property defect")
    },
    { fails: true, arbitrary: { runs: 1, seed: "assertion-shrink" } }
  )

  it.effect.prop(
    "shrinks Effect defects",
    [Input],
    ([value]) =>
      Effect.sync(() => {
        effectDefectValues.push(value)
        assert.strictEqual(value, 0)
      }),
    { fails: true, arbitrary: { runs: 1, seed: "assertion-shrink" } }
  )

  it.effect.prop(
    "preserves interruption",
    [Input],
    () => {
      interruptedRuns++
      return Effect.interrupt
    },
    { fails: true, arbitrary: { runs: 1, seed: "assertion-shrink" } }
  )

  it.effect.prop(
    "interrupts property checking on timeout",
    [Schema.Literal("value")],
    () =>
      Effect.acquireUseRelease(
        Effect.sync(() => {
          timeoutPropertyStarted = true
        }),
        () => Effect.never,
        () =>
          Effect.sync(() => {
            timeoutPropertyReleased = true
          })
      ),
    { fails: true, timeout: 10, arbitrary: { runs: 1, maxDiscards: 0, seed: "property-timeout" } }
  )
})