tehanu-teru
v1.0.1 testing unit-testing test-runner
Test Runner
Runs test suites written with tehanu in multiple source files.
Synopsis
sum1.test.js:
const test = require('tehanu')('sum1'),
{ equal } = require('assert'),
sum = require('./sum')
test('one number', () => equal(sum(1), 1))
sum2.test.js:
const test = require('tehanu')('sum2'),
{ equal } = require('assert'),
sum = require('./sum')
test('two numbers', () => equal(sum(1, 2), 3))
Running teru *.test.js
or teru sum1.test.js sum2.test.js
allows executing some or all test suites.
Installation
You can install the test runner using your favourite Node.js package manager:
npm i -D tehanu-teru
yarn add -D tehanu-teru
pnpm i -D tehanu-teru
Usage
Run tests written with Tehanu:
teru [option ...] [pattern ...]
If you use an NPM module with a conflicting binary, you can use aliases tehanu
or teru-cjs
instead of teru
to execute the tests. If your tests are in the ESM format, use only teru-esm
to run them.
Options
-r|--reporter <name> choose a reporter (coco, tape or custom)
-R|--require <module> preload a Node.js module to the process
-b|--[no-]bail abort after the first failure occurs
-p|--[no-]parallel execute test suites concurrently
-s|--[no-]parallel-suites execute tests in a suite concurrently
-V|--version print version number
-h|--help print usage instructions
If no pattern is provided, ./**/*.js
will be used by default. If no reporter is provided, just errors will be printed on the console.
Examples
teru -b
teru -r tape test/*.js
Alternative
The alternative to the teru
test runner is creating a test suite index and executing it by node tests
:
tests.js:
require('./sum1.test')
require('./sum2.test')