ql-unit v0.1.6
ql-unit
A node unit based framework to test ql.io scripts.
Overview
- Create a tests directory which contains scripts to test, mock response (optional) and detailed node unit asserts (optional).
- Create a js file which you intended to provide to nodeunit to run.
- Body of this file could look like what is given below:
Let us say filename is runallTests.js
module.exports = require('ql-uni').init({ // <- need to clone and install manually for now
tests:__dirname + '/tests',
tables:__dirname + '/tables', // <- ql.io-engine param
config:__dirname + '/config/dev.json'}); // <- ql.io-engine param
This one statement provides the machinary to run 100s of tests.
Example Select with mock response
Script to test
File name: select-test.ql
create table myTable
on select get from "http://localhost:3000/test";
aResponse = select * from myTable;
return "{aResponse}";
The test case name is the filename (without .ql) i.e test case name for this example will be "select-test" and the related mock files and custom asserts will need to begin with this name plus their own convention.
A point to note, though the example above uses a hardcoded endpoint, it is a good idea to get it from config (ref to ql.io doc). This way mocked endpoints can be abstracted out.
Mock Response
File name: select-test.3000.200.application.xml
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
<soap:Body xmlns:m="http://www.example.org/stock">
<m:GetStockPriceResponse>
<m:Price>34.5</m:Price>
</m:GetStockPriceResponse>
</soap:Body>
</soap:Envelope>
Mock filename convention is testcase-name.port.responseCode.responseType.responseSubType
It is possible to specify more than one mock responses if the script uses multiple servers.
It is also not necessary to have mock files and in that case it is assumed that the script is going to hit services external to ql-unit.
User can also mix and match, i.e mock some services and not others.
Custom Asserts
File name: select-test.js
var util = require('util');
exports.test = function (test, err, result) {
if (err) {
console.log(err.stack || util.inspect(err, false, 10));
test.fail('got error');
}
else {
test.equals(result.headers['content-type'], 'application/json', 'json expected');
test.ok(result.body['soap:Envelope']['soap:Body'], 'expected soap body in json resp');
}
}
testcase-name.js tells ql-unit that user wants to do custom asserts on the response returned by the script being tested. To implement custom asserts the user will need to export function(test,err,result).
- test: Is the nodeunit object on which assert operations can be done.
- err: Error object if the script returns erro.
- result: Result returned by the script.