Gently
Purpose
A node.js module that helps with mocking and behavior verification.
Features
- Overwrite and mock individual object functions
- Verify that all expected calls have been made in the expected order
- Restore mocked functions to their original behavior
Installation
Via npm:
npm install gently@latest
Example
Make sure your dog is working properly:
function Dog() {}
Dog.prototype.seeCat = function() {
this.bark('whuf, whuf');
this.run();
}
Dog.prototype.bark = function(bark) {
require('sys').puts(bark);
}
var gently = new (require('gently').Gently)
, assert = require('assert')
, dog = new Dog();
gently.expect(dog, 'bark', function(bark) {
assert.equal(bark, 'whuf, whuf');
});
gently.expect(dog, 'run');
dog.seeCat();
You can also easily test event emitters with this, for example a simple sequence of 2 events emitted by fs.WriteStream
:
var gently = new (require('gently').Gently)
, stream = new (require('fs').WriteStream)('my_file.txt');
gently.expect(stream, 'emit', function(event) {
assert.equal(event, 'open');
});
gently.expect(stream, 'emit', function(event) {
assert.equal(event, 'drain');
});
API
gently.Gently
new gently.Gently()
Creates a new gently instance. It listens to the process 'exit'
event to make sure all expectations have been verified.
gently.expect(obj, method, [[count], mock])
Creates an expectation for an objects method to be called. You can optionally specify the call count
you are expecting, as well as mock
function that will run instead of the original function.
gently.restore(obj, method)
Restores an object method that has been previously overwritten using gently.expect()
.
gently.verify()
Verifies that all expectations of this gently instance have been satisfied. If not called manually, this method is called when the process 'exit'
event is fired.
License
Gently is licensed under the MIT license.