Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Flask-inspired routing system for node.js/connect

tree: 651f276efc

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.mkd

flask-router

Routing system for node.js/connect based on Flask(http://flask.pocoo.org/).

Usage

var connect = require('connect')
  , app = connect()
  , router = require('flask-router')();

app.use(router.route);

router.get('/users/<str(max=5,min=2):id>', function (req, res) {
  console.log(req.params.id);
  res.end();
});

router.post('/users/<str(len=7):id>', function (req, res) {
  console.log(req.params.id);
  res.end();
});

router.put('/customers/<id>', function (req, res) {
  console.log(req.params.id);
  res.end();
});

Can assign multiple handler functions to the same rule:

router.get('/pattern/that/uses/many/handlers'
, function(req, res, next) {
  res.write('part1');
  return next();
}, function(req, res, next) {
  res.write('part2');
  return next();
});

router.get('/pattern/that/uses/many/handlers', function(req, res) {
  res.write('part3');
  return res.end();
});
// All three handlers will be executed when the url match, so the final
// response will be 'part1part2part3'

Custom parameter parsers can be registered(these are known as 'converters' in Flask/Werkzeug):

router.registerParser('options', function(str) {
  var rv = {};
    , options = str.split('/')
    , i, len, kv, key, value;
  for (i = 0, len = options.length; i < len; i++) {
    option = options[i];
    kv = option.split('=');
    key = kv[0], value = kv[1];
    rv[key] = value;
  }
  return rv;
});

router.get('/queryable/<options:query>', function(req, res) {
  console.log(JSON.stringify(req.params.query));
  res.end();
});
// If '/queryable/gt=5/lt=10/limit=20' was requested,
// the output would be {"limit":"20","gt":"5","lt":"10"}

See tests for more examples.

Something went wrong with that request. Please try again.