This is a no-frills test library. It simply builds on lib/metaty and lib/ds to provide the simplest possible needs for testing. Your tests are just a lua file which something (i.e. civ.html) executes. This library provides helpers to print helpful headers for each test and provide superior assertions.

Usage:

Mod civtest

Functions

• fn runTest(name, fn, path)
  
  Note: you probably want to do T'name' instead. See #usage.
  Run the test, printing information to the terminal.

  This function computes name=name..civtest.SUBNAME and sets civtest.NAME to the new name, which can be used in the test.

• fn showDiff(f, a, b)
  Write the diff of strings a vs b to the fmt.Fmt f. Typically, you want to call #civtest.eq instead.
• fn eq(a, b, msg)
  Assert that a equals b (according to #metaty.eq and print a diff if not.
• fn binEq(e, r)
  Same as eq but for binary strings. Shows a very clear diff for binary.
• fn matches(pat, subj) -> !?error
  assert subj:find(pat) or show a helpful error message.
• fn contains(plain, subj) -> !?error
  assert subj:find(pat, 1, true) (plain find) or show a helpful error message.
• fn throws(contains, fn) -> ds.Error
  assert fn() fails and the contains is in the message.
• fn exists(path)
  Assert that the path exists.
• fn pathEq(a, b)
  Assert the contents at the two paths are equal.
• fn pathEq(a, b)
  Assert the contents at the two paths are equal.
• fn path(path, expect)
  Assert that path matches expect. Expect can be of type:
• string: asserts the file contents match.
• table: recursively assert the subtree contents exist.