harness-js
==========

Yet another test organizers except that is work in NodeJS, Mongo's shell. Being able to run across these three environments with depending on things like RequireJS was a major reason to write this module. Hopefully it is helpful to others.

Overview

Harness provides a simple way of organizing assertive tests in Mongo's shell
(using mongo-modules), NodeJS and in many web browsers.

NodeJS example

``JavaScript
var path = require("path"),
assert = require("assert"),
harness = require("harness");

// Setup a test by assigning a function to callback and
// a label to the test group.
harness.push({callback: function () {
assert.strictEqual(harness.counts("running"), 1, "Should have on test running for 'Testing push()'");

// Now that you've completed this test
// group tell harness that this label
// is now complete.
harness.completed("Test group 1");
}, label: "Test group 1"});

// This is a second test group just to show you can do
// more than one group of tests.
// Setup a test by assigning a function to callback and
// a label to the test group.
harness.push({callback: function () {
assert.strictEqual(harness.counts("running"), 2, "Should have on test running for 'Testing push()'");

// Now that you've completed this test
// group tell harness that this label
// is now complete.
harness.completed("Test group 2");
}, label: "Test group 2"});

harness.RunIt(path.basename(module.filename), 10);
`

The command to run example/node-example.js looks like-

`shell
node example/node-example.js
`

The output would look something like-

`shell
Starting [node-example.js] ...
Starting Test group 1 ...
Test group 1 called
Test group 1 OK
Starting Test group 2 ...
Test group 2 called
Test group 2 OK
node-example.js Success!
`

Mongo example

Harness support comes with mongo-modules and mongo-modules will need to be installed for it to work. Other
than that it looks much like the NodeJS version above. The difference is
that the module.filename object isn't defined by mongo-modules so we must
define that ourselves.

`JavaScript
var path = require("path"),
assert = require("assert"),
harness = require("harness"),
// mongo-modules does not define the module object's
// filename.
module = {
filename: "mongo-example.js"
};

// Setup a test by assigning a function to callback and
// a label to the test group.
harness.push({callback: function () {
assert.strictEqual(harness.counts("running"), 1,
"Should have on test running for 'Testing push()'");

// Now that you've completed this test
// group tell harness that this label
// is now complete.
harness.completed("Test group 1");
}, label: "Test group 1"});

// This is a second test group just to show you can do
// more than one group of tests.
// Setup a test by assigning a function to callback and
// a label to the test group.
harness.push({callback: function () {
assert.strictEqual(harness.counts("running"), 2, "Should have on test running for 'Testing push()'");

// Now that you've completed this test
// group tell harness that this label
// is now complete.
harness.completed("Test group 2");
}, label: "Test group 2"});

harness.RunIt(path.basename(module.filename), 10);
`

Running the example/mongo-example.js with mongo-modules available is done like-

`shell
mongo ~/.mongojs.rc example/mongo-example.js
`

The output should look something like-

`shell
MongoDB shell version: 2.2.0
connecting to: test
loading file: /Users/johndoe/.mongorc.js
loading file: example/mongo-example.js
Starting [mongo-example.js] ...
Starting Test group 1 ...
Test group 1 called
Test group 1 OK
Starting Test group 2 ...
Test group 2 called
Test group 2 OK
mongo-example.js Success!
``