Test Example

A JSDoc plugin for generating test files by parsing @example.

Feature

BDD (Behavior-driven development) style Test wrapper, such as Mocha
Should style Assertion
One Source file to one Test file
One Doclet to one describe()
One @example to one it()
// also supports multiple-line code with the example result

Usage

npm i test-example -D
Add some config options
Custom hook module let you do more
jsdoc -c path/to/config.json
npm test

Example

source/say-sth.js

/**
 * Hello function
 *
 * @function hello
 *
 * @param {string} [name="World"]
 *
 * @return {string}
 *
 * @example  // No parameter
 *
 *     hello()    //  "Hello, World !"
 *
 * @example  // One parameter
 *
 *     hello('JSDoc')    //  "Hello, JSDoc !"
 */

exports.hello = function (name) {

    return  'Hello, ' + (name || 'World') + ' !';
};

will generate test/say-sth.js

'use strict';

require('should');

var saySth = require('../source/say-sth');


describe('hello',  function () {


    it('No parameter',  function () {

        var result = saySth.hello();

        result.should.be.deepEqual( "Hello, World !" );
    });


    it('One parameter',  function () {

        var result = saySth.hello('JSDoc');

        result.should.be.deepEqual( "Hello, JSDoc !" );
    });

});

[ Remark ] A blank line is necessary between the title & code of @example.

User Case

iQuery.js