Create cyborg microbots to react to events and automate tasks.
Install with npm:
$ npm install --save microbot
Install with yarn:
$ yarn add microbot
var Microbot = require('microbot');
Create a new Microbot instance with the provided options.
Params
options {Object}: Options used to configure the new microbot.Example
var microbot = new Microbot({a: 'b'});
Register a handler function to be called when the microbot is activated.
Params
fn {Function}: Handler function that will be called with a payload and options. The handler function should return a Promise.returns {Object}: Returns this for chainingExample
microbot.when(function(payload, options) {
console.log(payload);
//=> {foo: 'bar'}
console.log(options);
//=> {a: 'b', c: 'd'}
return Promise.resolve({bar: 'baz'});
});
Register an action handler function using the given name.
Params
name {String}: Name of the action handler function.fn {Function}: Action handler function to be called when the action is dispatched.returns {Object}: Returns this to allow chainingExample
microbot.action('foo', function(payload, options) {
return Promise.resolve(payload.foo);
});
microbot.dispatch('foo', {foo: 'bar'})
.then(function(result) {
console.log(result);
//=> 'bar'
});
Dispatches a payload by calling the registered action handler function.
Params
name {String}: Name of the action to dispatch. Defaults to "when".payload {Object}: Payload object to send to the action handler function.options {Object}: Additional options to send to the action handler function.returns {Promise}: Returns a promise after the action handler function has resolved.Example
microbot.dispatch({foo: 'bar'}, {c: 'd'})
.then(function(results) {
console.log(results);
//=> {bar: 'baz'}
});
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Please read the contributing guide for advice on opening issues, pull requests, and coding standards.
(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)
To generate the readme, run the following command:
$ npm install -g verbose/verb#dev verb-generate-readme && verb
Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:
$ npm install && npm test
Brian Woodward
Copyright © 2017, Brian Woodward. Released under the MIT License.
This file was generated by verb-generate-readme, v0.6.0, on May 25, 2017.