tiny-router

0.1.5 • Public • Published

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-router

Features

  • 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!

Package Sidebar

Install

npm i tiny-router

Weekly Downloads

5

Version

0.1.5

License

MIT

Last publish

Collaborators

  • pirumpi