Chain Smoker
It runs your tests. It checks the callbacks. Chain Smoker is an old curmudgeon that will yell at you when your stuff falls over.
It's totally not ready for use yet. Come back later.
Setup
Chain Smoker requires Redis.
- Install Chain Smoker
$ npm install chain-smoker --save
- Create your test suite.
var ChainSmoker = ; var Suite = {}; Suitetests = name: 'example-get' address: 'http://example.com' assertions: statusCode: 200 name: 'example-callback' address: 'http://example.com/call/me/back' method: 'POST' headers: 'X-Awesome-Header': 'this is really cool' body: neato: true callback_url: 'http://this-hostname/callback/example-callback' assertions: statusCode: 201 callback_assertions: { return reqbodystatus === 'success'; } callback_time_limit: 10000 { return reqbodyid; } ; var options = apiPort: 8080 { if jobslength === 0 console; else console; console; } ;
- Enjoy.
Test options
Option | Details (default) |
---|---|
name | String (null ) - Name of the test (really useful for callback routing) |
address | string (null ) - Endpoint to hit for the test |
method | string (GET ) - HTTP method to use when hitting the specified address |
headers | Object ({} ) - Headers to deliver when making the request |
body | String or Object ('null') - If an object is given, it will be stringified before making the request. |
external_id | Function (msg.body.id ) - Function that returns a unique ID from the response. If this is null, msg.body.id is blindly used, so external_id could potentially be null. |
assertions | Object ({}) - Object containing the assertions to run against the initial request. The values of each assertion can either be a string (or object) to compare against the key of the same name in the response, or a function that returns true or false. |
callback_assertions | Object (null ) - Same as above, but for the callback received from the initial request |
callback_time_limit | Integer (0 ) - Amount of time (in milliseconds) before a callback is considered late. After this point, the late jobs begin to show up in the lateCallback mentioned below. |
Chain Smoker Run Options
Option | Values (default) | Details |
---|---|---|
apiPort | Integer (3000 ) |
The port to use for the callback server |
lateCallback | Fn([jobs]) (noop() ) |
The function to call when the check for late jobs comes back. The callback fires even if the array is empty, which can be useful to clear out any pager alerts or other things fired when the array was not empty. |
lateCheckFrequency | Integer (1500 ) |
How often in milliseconds to check for late jobs |
disableCleaner | Boolean (false ) |
If true, old completed jobs will not be removed from the database |
cleanFailures | Boolean (false ) |
Whether or not to remove jobs that have completed, but were unsuccessful |
maxCompletedAge | Integer (3600000 ) |
If cleanup is enabled, this is the age (in milliseconds) threshold before a job is cleaned. Default is 1 hour. |
cleanFrequency | Integer (5000 ) |
How often in milliseconds to run the cleanup check |