std:test リファレンス

import test := "std:test" で取得するテストの構築・実行モジュール。test / suite で Trial を構築し、run で実行して Report を返す (collect-then-run)。

run

run(trials)
run: { List(a) | Report }

Trial 列を実行し集計した Report を返す (出力はしない)。

>>> test.run([test.test("adds", { assert.equal(1 + 1, 2) })]).passed
1

suite(name, trials)
suite: { String, List(a) | Trial }

子 Trial をまとめたグループ Trial を構築する (ネスト可)。

>>> test.suite("math", [test.test("adds", { 1 + 1 == 2 })])
Trial(suite "math")

test(name, block)
test: { String, EffectConduit({ Any }) | Trial }

name のテストを1 件構築する (実行はしない)。run に渡す Trial を返す。

>>> test.test("adds", { 1 + 1 == 2 })
Trial("adds")

timeout(ms, trial)
timeout: { Int, Trial | Trial }

trial の部分木に締切 ms (ミリ秒) を掛けた Trial を構築する。0 は無制限。入れ子は内側が勝つ。

>>> test.timeout(50, test.test("slow", { 1 }))
Trial(timeout 50)