metatests


metatests is an extremely simple to use test framework and runner for Metarhia
technology stack built on the following principles:

- Test cases are files, tests are either imperative (functions) or declarative
(arrays and structures).

- Assertions are done using the built-in Node.js assert module. The framework
also provides additional testing facilities (like spies).

- Tests can be run in parallel.

- All tests are executed in isolated sandboxes. The framework allows to easily
mock modules required by tests and provides ready-to-use mocks for timers and
other core functionality.

- Testing asynchronous operations must be supported.

- Testing pure functions without asynchronous operations and state can be done
without extra boilerplate code using DSL based on arrays.

``javascript
mt.case(
'Test common.duration',
{ common },
{
// ...
'common.duration': [
['1d', 86400000],
['10h', 36000000],
['7m', 420000],
['13s', 13000],
['2d 43s', 172843000],
// ...
],
// ...
},
);
`

(Prior art)

- The framework must work in Node.js and browsers (using Webpack or any other
module bundler that supports CommonJS modules and emulates Node.js globals).

Contributors

- See github for full contributors list

API

- Interface metatests
- case
- DeclarativeTest
- DeclarativeTest.prototype.constructor
- DeclarativeTest.prototype.run
- DeclarativeTest.prototype.runNow
- equal
- strictEqual
- reporters.Reporter
- reporters.Reporter.prototype.constructor
- reporters.Reporter.prototype.error
- reporters.Reporter.prototype.finish
- reporters.Reporter.prototype.log
- reporters.Reporter.prototype.logComment
- reporters.Reporter.prototype.record
- reporters.ConciseReporter
- reporters.ConciseReporter.prototype.constructor
- reporters.ConciseReporter.prototype.error
- reporters.ConciseReporter.prototype.finish
- reporters.ConciseReporter.prototype.listFailure
- reporters.ConciseReporter.prototype.parseTestResults
- reporters.ConciseReporter.prototype.printAssertErrorSeparator
- reporters.ConciseReporter.prototype.printSubtestSeparator
- reporters.ConciseReporter.prototype.printTestSeparator
- reporters.ConciseReporter.prototype.record
- reporters.TapReporter
- reporters.TapReporter.prototype.constructor
- reporters.TapReporter.prototype.error
- reporters.TapReporter.prototype.finish
- reporters.TapReporter.prototype.listFailure
- reporters.TapReporter.prototype.logComment
- reporters.TapReporter.prototype.parseTestResults
- reporters.TapReporter.prototype.record
- runner.Runner
- runner.Runner.prototype.constructor
- runner.Runner.prototype.addTest
- runner.Runner.prototype.finish
- runner.Runner.prototype.removeReporter
- runner.Runner.prototype.resume
- runner.Runner.prototype.runTodo
- runner.Runner.prototype.setReporter
- runner.Runner.prototype.wait
- runner.instance
- speed
- measure
- convertToCsv
- ImperativeTest
- ImperativeTest.prototype.constructor
- ImperativeTest.prototype.afterEach
- ImperativeTest.prototype.assert
- ImperativeTest.prototype.assertNot
- ImperativeTest.prototype.bailout
- ImperativeTest.prototype.beforeEach
- ImperativeTest.prototype.case
- ImperativeTest.prototype.cb
- ImperativeTest.prototype.cbFail
- ImperativeTest.prototype.contains
- ImperativeTest.prototype.containsGreedy
- ImperativeTest.prototype.defer
- ImperativeTest.prototype.doesNotThrow
- ImperativeTest.prototype.end
- ImperativeTest.prototype.endAfterSubtests
- ImperativeTest.prototype.equal
- ImperativeTest.prototype.error
- ImperativeTest.prototype.fail
- ImperativeTest.prototype.is
- ImperativeTest.prototype.isArray
- ImperativeTest.prototype.isBuffer
- ImperativeTest.prototype.isError
- ImperativeTest.prototype.isRejected
- ImperativeTest.prototype.isResolved
- ImperativeTest.prototype.mustCall
- ImperativeTest.prototype.mustNotCall
- ImperativeTest.prototype.notEqual
- ImperativeTest.prototype.notOk
- ImperativeTest.prototype.notSameTopology
- ImperativeTest.prototype.ok
- ImperativeTest.prototype.on
- ImperativeTest.prototype.pass
- ImperativeTest.prototype.plan
- ImperativeTest.prototype.regex
- ImperativeTest.prototype.rejects
- ImperativeTest.prototype.resolves
- ImperativeTest.prototype.run
- ImperativeTest.prototype.same
- ImperativeTest.prototype.sameTopology
- ImperativeTest.prototype.strictEqual
- ImperativeTest.prototype.strictNotSame
- ImperativeTest.prototype.strictSame
- ImperativeTest.prototype.test
- ImperativeTest.prototype.testAsync
- ImperativeTest.prototype.testSync
- ImperativeTest.prototype.throws
- ImperativeTest.prototype.type
- test
- testSync
- testAsync

$3

#### case(caption, namespace, list, runner)

- caption: [][string] case caption
- namespace: [