bees

Api documentation generator

bees (in Italian API means bees)

Let the code write your docs D:

$ npm install bees

See test/file

You can extend Bees and add new keywords with a tiny plugin system (see lib/plugins)

var bees = require('bees');
bees.use('plugin', function(cmdjson) {
  json.plugin = cmd[1];
});
console.log(
  bees.parse(
    require('fs').readFileSync('./app.js','utf-8')
  )
);

Now you can use it

/**
 * GET /:id
 * 
 * @param id id of the user
 * @return user infos
 * @plugin hai lol
*/
$ node plugin.js
[
  {
    method: 'GET',
    path: '/:id',
    params: { id: 'id of the user' },
    return: 'user infos',
    plugin: 'hai lol'
  }
]

Reporters are a way to return formatted objects.

If we got this in eyes-reporter.js:

var inspector = require('eyes').inspector({stream: null});
 
module.exports = function(doc) {
  return inspector(doc);
};

And we call bees just like this:

bees -R eyes-reporter <file>

We will get:

Cool eh?

  • Generate HTML from JSON
$ npm test

Tests are written with Vows

MIT