logo

abstract class

sys::Test

sys::Obj
  sys::Test

Test is the base for Fan unit tests.

Slots

fail

Void fail(Str msg := null)

Throw a test failure exception. If msg is non-null, include it in the failure exception.

id

Str id()

Get a unique id for this run of the test method. This id is guaranteed to be unique for the life of the VM.

make

new make()

Protected constructor.

setup

virtual Void setup()

Setup is called before running each test method.

teardown

virtual Void teardown()

Teardown is called after running every test method.

tempDir

File tempDir()

Return a temporary test directory which may used as a scratch directory. This directory is guaranteed to be created and empty the first time this method is called for a given test run. This directory is also the same as the Sys.appDir.

verify

Void verify(Bool cond, Str msg := null)

Verify that cond is true, otherwise throw a test failure exception. If msg is non-null, include it in a failure exception.

verifyEq

Void verifyEq(Obj a, Obj b, Str msg := null)

Verify that a == b, otherwise throw a test failure exception. If both a and b are nonnull, then this method also ensures that a.hash == b.hash, because any two objects which return true for equals() must also return the same hash code. If msg is non-null, include it in failure exception.

verifyErr

Void verifyErr(Type errType, || c)

Verify that the function throws an Err of the exact same type as err (compare using === operator).

Examples:

verifyErr(ParseErr.type) |,| { Int.fromStr("@#!") }
verifyFalse

Void verifyFalse(Bool cond, Str msg := null)

Verify that cond is false, otherwise throw a test failure exception. If msg is non-null, include it in a failure exception.

verifyNotEq

Void verifyNotEq(Obj a, Obj b, Str msg := null)

Verify that a != b, otherwise throw a test failure exception. If msg is non-null, include it in failure exception.

verifyNotSame

Void verifyNotSame(Obj a, Obj b, Str msg := null)

Verify that a !== b, otherwise throw a test* failure exception. If msg is non-null, include it in failure exception.

verifySame

Void verifySame(Obj a, Obj b, Str msg := null)

Verify that a === b, otherwise throw a test failure exception. If msg is non-null, include it in failure exception.