brace_maybe v0.1.5

Brace Maybe

Synopsis

Brace Maybe adds the ability to skip unit tests at run-time with the mocha testing framework to only show failed tests which matter.

A part of the Brace suite	Developed with Windows 10 and Ubuntu 16

Brace Maybe help pages

• Synopsis
• Specification
  • License information
  • Package information

Author: Robert Steckroth, Bust0ut <RobertSteckroth@gmail.com>

Licensed under: MIT

Bonuses:

• Finding what test failed is now possible in large unit test files.

Caveats:

• Not unit tested (extensive use in many projects however).

Below is an example of how to use Brace maybe in unit tests.

var maybe = require("brace_maybe")
var it_will = global

describe("Using stop further progression methodology for dependencies in: "+path.basename(__filename), function() {

	// The it property is mutated by brace_maybe to allow for other functionality. It still has the same functionality as the original however.
	var it = maybe(it_will)
	it_will.stop = !!process.env.DRY_RUN  
	it_will.quiet = !!process.env.QUIET

	it("r_js in the system as a program", function(done) {
		it_will.stop = true
		expect((function() {try { require("requirejs"); return true; } catch(e) { return e;}})(), "could not find r.js dependency").to.be.true
		// This is the only way to proceed with the other tests.
		it_will.stop = false
		done()
	})

	describe("Running unit tests", function() {
		var requirejs
		beforeEach(function() {
			remove_cache()
			requirejs = require("requirejs")
			requirejs.config({baseUrl: path.join(__dirname, "..", "lib"), nodeRequire: require})

		})

		// This test will never run if the requirejs module is not available above.
		it("can load the module", function(done) {

			requirejs(["yourModule"], function(mod) {
				expect(true).to.be.true
				done()
			})
		})

		// All of the built-in mocha it functionality works the same way.
		//it.skip("This is a skipped test", function(done) { })
		//it.only("This is the only test which will run", function(done) { })
	})
})