node package manager

bdd-wrappers

BDD wrappers for jasmine and mocha describe/it to help writing tests in GIVEN WHEN THEN AND fashion

bdd-wrappers

BDD wrappers for jasmine and mocha describe/it to help writing tests in GIVEN WHEN THEN AND fashion so you can write:

GIVEN("a gremlin", function () {
WHEN("I feed it", function () {
beforeEach(function () {
gremlin.feed();
});
 
THEN("is happy", function () {
expect(gremlin.happy).to.be.true;
});
 
AND("I give it water", function () {
beforeEach(function () {
gremlin.water();
});
 
THEN("they are all happy", function () {
expect(gremlin[0].happy).to.be.true;
expect(gremlin[1].happy).to.be.true;
expect(gremlin[2].happy).to.be.true;
expect(gremlin[3].happy).to.be.true;
});
});
 
WHEN("it's past midnight", function () {
beforeEach(function () {
time.set('0000');
gremlin.feed();
});
 
THEN("it's not cute anymore", function () {
expect(gremlin.cute).to.be.false;
});
});
});
});

Instead of:

describe("GIVEN a gremlin", function () {
describe("WHEN I feed it", function () {
beforeEach(function () {
gremlin.feed();
});
 
it("THEN is happy", function () {
expect(gremlin.happy).to.be.true;
});
 
describe("AND I give it water", function () {
beforeEach(function () {
gremlin.water();
});
 
it("THEN they are all happy", function () {
expect(gremlin[0].happy).to.be.true;
expect(gremlin[1].happy).to.be.true;
expect(gremlin[2].happy).to.be.true;
expect(gremlin[3].happy).to.be.true;
});
});
 
describe("WHEN it's past midnight", function () {
beforeEach(function () {
time.set('0000');
gremlin.feed();
});
 
it("THEN it's not cute anymore", function () {
expect(gremlin.cute).to.be.false;
});
});
});
});

When a test fails, the trace will correctly output GIVEN a gremlin WHEN I feed it THEN is happy.

Installation

npm install bdd-wrappers

How to use

This will add the GIVEN, WHEN, AND, THEN functions to the global object

require("bdd-wrappers");
 
GIVEN(...);

You can also define your own wrappers. The first parameter is a string and will prefix the string describing the test.

var wrap = require("bdd-wrappers").wrap;
 
// A wrapper for it(...); 
GLOBAL.SHOULD = wrap("SHOULD ", it);
 
// So: 
SHOULD("do something", func);
// will ouput: SHOULD so something 
 
// A wrapper for describe(...); 
GLOBAL.OR = wrap("OR ", describe);

LICENSE

MIT