dean v0.1.2

dean

Author

Evan Lucas

License

MIT

Installation

$ npm install -g dean

Tests

$ npm test

Coverage

$ npm run cover

API

Dean

Constructor

opts can contain the following:

redis note: the redis key can also contain a redisClient. This should be an instance of redis.createClient. redis.socket will take priority over redis.host and redis.port.

Params

Dean.listen()

Listen for requests

Examples:

// just a callback
dean.listen(function() {
  console.log('listening on port', dean.port)
})

// with a port
dean.listen(8044, function() {
  console.log('listening on port', 8044)
})

// with a port and host
dean.listen(8044, '127.0.0.1', function() {
  console.log('listening at', '127.0.0.1:8044')
})

Params

Dean.close()

Closes the server and stops accepting requests

Params

Dean.addDrone()

Adds a new drone to the rotation

Example

// all of the following will be accepted
// '0.0.0.0:4043'
dean.addDrone('0.0.0.0:4043')
dean.addDrone('4043')
dean.addDrone(4043)
dean.addDrone({
  port: 4043
, host: '0.0.0.0'
})

Params

Dean.removeDrone()

Removes a drone from the rotation

Example

dean.removeDrone('0.0.0.0:4043')

Params

Instrumentation

Instrumentation is optional via jstrace.

The following probes are exposed:

• dean:proxy:web:start
  • target will be the request's target
  • method will be the request method
  • url will be the request url
• dean:proxy:web:end
  • target will be the request's target
  • method will be the request method
  • url will be the request url
  • duration will be the duration of the request in ms
• dean:drone:add
  • drone will be the added drone
• dean:drone:remove
  • drone will be the removed drone

An example script has been provided at ./scripts/trace.js. To test it out:

$ jstrace ./scripts/trace.js

# Then in another terminal
$ npm test