Simple socket.io server for controlling a nodebot.
npm install nodebot-server> Simple socket.io server for controlling a nodebot.
Install with npm:
``sh`
$ npm install --save nodebot-server
`js`
var server = require('nodebot-server');
Start a web server hosting the index page and a websocket server to listen for commands to send to listening nodebots.
Params
* options {Object}: Options to control how the server is configured.options.cwd
* {String}: Directory where any static files to be served are found. Defaults to process.cwd().options.index
* {String}: Relative path from options.cwd to the html file to serve when the root route is accessed. Defaults to index.html.options.port
* {Number}: Port for the web server to listen on. Defaults to 3000.cb
* {Function}: Callback function that is passed an err if an Error occurs, or an app when successful. See app.
Example
`js
var options = { cwd: __dirname, index: 'index.html' };
server(options, function(err, app) {
if (err) {
console.error(err);
process.exit(1);
return;
}
console.log('Nodebot server started.');
// listen for commands
app.on('cmd', function(cmd) {
console.log(Received command: ${cmd});`
});
});
Application instance that is used to listen for events to know when to send commands to your nodebots.
Example
`js`
app.on('cmd', function(cmd) {
console.log(cmd);
//=> 'forward'
});
Use nodebot remote control to quickly get started with a UI for sending commands to the nodebot server.
Use the following steps to setup the nodebot remote control:
* Clone nodebot-remote-control into a vendor folder in your nodebot project:
`sh`
$ git clone https://github.com/jonschlinkert/nodebot-remote-control.git vendor/nodebot-remote-control
* Copy the files from dist into a folder in your nodebot project (we'll use public)
`sh`
$ cp -R ./vendor/nodebot-remote-control/dist/ ./public
* Configure and start the nodebot-server after connecting to your nodebot:
`js
var path = require('path');
var server = require('nodebot-server');
var options = {
cwd: path.join(process.cwd(), 'public')
};
server(options, function(err, app) {
if (err) {
console.error(err);
process.exit(1);
return;
}
app.on('cmd', function(cmd) {
// call function coorisponding to the command received
nodebot[cmd]();
});
});
`
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Please read the contributing guide for avice on opening issues, pull requests, and coding standards.
_(This document was generated by verb-generate-readme (a verb generator), please don't edit the readme directly. Any changes to the readme must be made in .verb.md.)_
To generate the readme and API documentation with verb:
`sh`
$ npm install -g verb verb-generate-readme && verb
Install dev dependencies:
`sh``
$ npm install -d && npm test
Brian Woodward
Copyright © 2017, Brian Woodward.
Released under the MIT license.
*
_This file was generated by verb-generate-readme, v0.2.3, on January 11, 2017._