Cichorium

Routing framework based on Promise using CoffeeScript.

Cichorium has a Route Table and a Error Route Table. Route Table is an Array contains some of:

• a Child Route Table (Array)
• a Middleware (Function)

Middleware will be executed sequentially, if middleware return a Promise, Cichorium will execute next middleware after the promise fulfilled.

Inside middleware, you can use nextRoute skip other middlewares on this route, enter next route on parent level directly. Conditional-route are implemented by this feature, like match HTTP method or URL prefix.

If middleware throws a Exception or Promise is rejected, Cichorium will enter error handling, middleware in error route table will be executed sequentially. if new exception has be thrown, the new exception will replace the original.

Error middleware can use errorResolved to resolve exception, the other error middleware will not be executed. Unless there are more than one exception, the last exception will be passed to next error middleware.

Usage

Cichorium = require 'cichorium'
app = new Cichorium()

app.use '/account', (req, res) ->
  Account.authenticate(req.headers['x-token']).then (account) ->
    req.account = account

app.get '/account/dashboard', (req, res) ->
  res.json 200,
    hello: req.account?.name

app.catch (err) ->
  res.send 500, err.message

app.listen 3000