Create cyborg microbots to react to events and automate tasks.
npm install microbot> Create cyborg microbots to react to events and automate tasks.
Install with npm:
``sh`
$ npm install --save microbot
Install with yarn:
`sh`
$ yarn add microbot
`js`
var Microbot = require('microbot');
Create a new Microbot instance with the provided options.
Params
* options {Object}: Options used to configure the new microbot.
Example
`js`
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 chaining
Example
`js`
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 chaining
Example
`js`
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
`js`
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:
`sh`
$ 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:
`sh``
$ 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._