tiny-router
v0.1.5
Published
A really small routing library targeting embedded systems.
Downloads
15
Maintainers
pirumpiReadme
tiny-router
A simple routing library targeting embedded system where every byte counts. Right now there are few embedded systems running Javascript: Tessel, BeagleBone, RaspberryPi, and Espruino.
- Currently testing on Tessel, Espruino, BeagleBone, and Raspberry Pi
Installation
npm install tiny-routerFeatures
- Simple routing
- Supports GET, POST, PUT, DELETE. It can be extended by using the methodAdd fn
- Retrieving submitted data from the req.body object
- Light weight, only 160 lines of code to get an express like experience
Methods
use: Allow to overwrite default values configurations: ('static', 'defaultPage') and default methods: ('readFile', 'fileExist') this is useful when different embedded system read the file system differently. Also it gives access to the request and response object before the routing tables are created.
//Changing defaultPage router.use('defaultPage', 'default.html');//Setting a public folder router.use('static', {path: __dirname + '/public'});//Creating a URL logger router.use(function(req, res, next){ console.log('URL: ', req.url); next(); });Router: Return the routing table created from the get, post, put, etc.. methods
//Setting Routing table http.createServer(router.Router()).listen(3000);listen(port): Return a instance of http.createServer(router.Router()).listen(port)
//A simple way to create server router.listen(3000);addMethod(method): Allow the extension of supported method from the supported list: (GET, POST, PUT DELETE)
router.addMethod('TRACE'); router.trace('/logs', function(req, res){ res.send('this are traces'); });addMimeType(mimeObject): It extends the mime types supported by the server. It can use a third party mime type detector by overwriting the getMime method
router.addMimeType({ext:'.mp4', mime:'video/mp4'});getMime(file): Retrieves mime type
var type = router.getMimeType('img.jpg');send(msg): Sends data
var body = ['<!DOCTYPE html>', '<html ng-app="tessel">', '<head>', '</head>', '<body style="background-color:#222;">', '</body>', '</html>'].join('\n'); res.send(body);sendImage(img): Sends an image
res.sendImage(image);
##Examples:
###Tessel lights
var router = require('tiny-router'),
tessel = require('tessel');
var lights = {
green: tessel.led[0],
blue: tessel.led[1],
red: tessel.led[2],
amber: tessel.led[3]
};
router
.get('/', function(req, res) {
res.send('Simple light web API');
})
.get('/lights', function(req, res){
res.send(lights);
})
.get('/green', function(req, res){
var state = lights.green.read();
lights.green.write(state);
res.send({status: state});
})
.get('/green/{state}', function(req, res){
var state = parseInt(req.body.state);
lights.green.write(state);
res.send({status: state});
});
router.listen(8080);###Tessel Camera Module
var tessel = require('tessel'),
router = require('tiny-router'),
camera = require('camera-vc0706').use(tessel.port['A']);
router.get('/', function(req, res){
var body = ['<!DOCTYPE html>',
'<html ng-app="tessel">',
'<head>',
'<title>Camera Module</title>',
'<link href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css" rel="stylesheet"/>',
'<script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.3.0-beta.17/angular.min.js"></script>',
'</head>',
'<body style="background-color:#222;">',
'<div class="col-md-6 col-md-offset-3 text-center" ng-controller="MainCtrl">',
'<img src="https://s3.amazonaws.com/technicalmachine-assets/technical-io/tessel-name.png" style="width: 200px; margin: 10px"/>',
'<img ng-src="{{imgUrl}}" class="img-thumbnail" style="background-color:#fff;min-width:640px;height:480px"/>',
'<p class="text-center" style="margin:10px">',
'<button ng-disabled="downloading" ng-click="takePicture()" class="btn btn-danger"><i class="glyphicon glyphicon-camera"></i></button>',
'</p>',
'</div>',
'<script>',
"angular.module('tessel', [])",
".controller('MainCtrl', function ($scope){",
"$scope.takePicture = function(){",
"$scope.downloading=true;",
"$scope.imgUrl = 'http://' + location.host + '/picture/' + Math.floor(Math.random()*10000);",
"setTimeout(function(){ $scope.downloading = false; $scope.$apply(); }, 10000);",
"};",
"});",
'</script>',
'</body>',
'</html>'].join('\n');
res.send(body);
});
router.get('/picture/{random}', function(req, res){
camera.takePicture(function(err, image){
if(err) {
res.send('Unable to take a picture');
}else{
res.sendImage(image);
}
});
});
camera.on('ready', function(){
//Server is running | Blue light on
tessel.led[1].write(1);
router.listen(8080);
});
camera.on('error', function(){
//Turn Blue light off if on and turn red light on
tessel.led[1].write(0);
tessel.led[2].write(1);
});###Raspberry Pi
var router = require('tiny-router'),
gpio = require('pi-gpio');
var readPin = function(pin, cb, errCb){
gpio.open(pin, 'input', function(err){
if(!err){
gpio.read(pin, function(err, value){
if(!err) {
if(cb) { cb(value); }
gpio.close(pin);
}else{
if(errCb) { errCb(); }
}
});
}else{
if(errCb) { errCb(); }
}
});
},
writePin = function(pin, val, cb, errCb){
gpio.open(pin, 'output', function(err) {
if(!err){
gpio.write(pin, val, function(err) {
if(!err){
if(cb) { cb(val); }
gpio.close(pin);
}else{
if(errCb) { errCb(); }
}
});
}else{
if(errCb) { errCb(); }
}
});
};
router.get('/', function(req, res){
res.send('Simple Light API');
});
router.get('/light/status/{pin}', function(req, res){
var pin = req.body.pin;
readPin(pin, function(val){
res.send({pin: pin, status: val, success: true});
}, function(){
res.send({error: 'Cannot read pin ' + pin, success: false});
});
});
router.get('/light/off/{pin}', function(req, res){
var pin = req.body.pin;
writePin(pin, 0, function(){
res.send({success: true, pin: pin, status: 1});
}, function(){
res.send({error: 'Cannot turn off pin ' + pin, success: false});
});
});
router.get('/light/on/{pin}', function(){
var pin = req.body.pin;
writePin(pin, 1, function(val){
res.send({success: true, pin: pin, status: val});
}, function(){
res.send({error: 'Cannot turn on pin ' + pin, success: false});
});
});
router.listen(8080);Version
0.0.7: Added the sendImage method. Great for creating app to work with Tessel Camera module 0.0.8: Added the example folder 0.0.9: Minor changes to the gitignore file 0.1.0 Adding sample code for Raspberry Pi 0.1.2 Changing internal method to Async in order to interact with the filesystem. 0.1.6 Adding stream support and other engine templates
License
MIT
Free Software, Hell Yeah!