Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/liushuping/ddt
A Data Driven Test library for node.js
https://github.com/liushuping/ddt
Last synced: 16 days ago
JSON representation
A Data Driven Test library for node.js
- Host: GitHub
- URL: https://github.com/liushuping/ddt
- Owner: liushuping
- License: mit
- Created: 2014-07-21T06:33:52.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2015-06-19T08:26:53.000Z (over 9 years ago)
- Last Synced: 2024-12-13T02:16:56.024Z (about 1 month ago)
- Language: JavaScript
- Homepage:
- Size: 180 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ddt
===
A Data Driven Test library for node.js
[](https://travis-ci.org/liushuping/ddt.svg)
This module iterates a list of input test data and for each data creates a test case by transforming the data and validating the generated result with expected data in the output list.
## API
Require the `ddt` module and call `test` method against a `config` object.
```javascript
var ddt = require('ddt');
ddt.test(config);
```
save the file e.g. `test.js` and then execute the test with `mocha`
```
mocha test.js
```
**config**
* `inputs`: an array of test case inputs.
* `outputs`: an array of expected test results.
* `transform(input)`: a function for trasforming an input test case data, this is the function to be tested. Parameter `input` is the input test case data.
* `validate(expected, actual)`: a function for validating transformed data (from input) to expected value which is from `outputs` array.
* `groupName`: a string value representing the group name for all the test cases. If the value is not specified, then all the test cases will be not grouped.
* `caseName`: could be a string or a function. If it s string value, each test case will be nameed with it; if it is a function, the test case name will be generated from calling of it. The function accepts 3 parameters: `index`, `inputs` and `outputs` for helping generating name based on actual test case.
## Example
Suppose have 6 test cases, each test case has an integer input number and the expected value is the double of the input number. So, the 6 input test cases are `[1, 2, 3, 4, 5, 6]` and the exptected outputs are `[2, 4, 6, 8, 10, 12]`
```javascript
var ddt = require('ddt');
var config = {
inputs: [1, 2, 3, 4, 5, 6],
outputs: [2, 4, 6, 8, 10, 12],
trasform: function(input) {
return 2 * input;
},
validate: function(expected, actual) {
return expected == actual;
},
groupName: 'Double of a number',
caseName: function(index, inputs, outputs) {
return 'Doubling of number ' + inputs[index] + ' should return ' + outputs[index];
}
};
ddt.test(config);
```
Save the file as `test.js` then use `mocha` to run the tests
```
mocha test.js --reporter spec
```
The test result is:
```
Double of a number
✓ Doubling of number 1 should return 2
✓ Doubling of number 2 should return 4
✓ Doubling of number 3 should return 6
✓ Doubling of number 4 should return 8
✓ Doubling of number 5 should return 10
✓ Doubling of number 6 should return 12
```
## Test
Make sure `mocha` is installed globally
```
npm install mocha -g
```
Run `npm test` to run unit test
## License
MIT