Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jpommerening/node-markdown-bdd

Use code blocks from markdown documents in your tests
https://github.com/jpommerening/node-markdown-bdd

Last synced: 24 days ago
JSON representation

Use code blocks from markdown documents in your tests

Awesome Lists containing this project

README

        

# markdown-bdd

> Use code blocks from markdown documents in your tests.

Take this README file for example. There are multiple code blocks
in here, that serve as usage examples for the user.
However, since these examples are supposed to _describe_ what the
module does, why not go ahead and use them as the specification?

## Usage Example

Ok, hang on, I'll explain later. First have a look at this example:

```js
var markdownBdd = require('markdown-bdd');

// declare what to use as input and what global variables to assume
var example = markdownBdd('README.md', {
describe: describe,
example: function() {},
it: it
});

describe('markdown-bdd', function() {
example('Usage Example', function() {
it('should be runnable with mocha', function (done) {
// ...
});
});
});
```