koa-rutt v0.2.0

koa-rutt

Swedish routing, for Koa.

Install

npm install koa-rutt

Usage

Most features will be demonstrated below.

var app = require('koa')();
    Router = require('koa-rutt');

var router = new Router();

// Add pre-middleware.
router
.pre(function*(next) {
   // This will run on all HTTP methods first (GET, POST, etc);
})
.pre('post', function*(next) {
  // Run a middleware just on this HTTP method (POST), such as a body parser
})
.get('/', function*(next) {
  this.body = "Index!";
})
.get('/item/:id', function(next) {
  // a `params` object is added to `this`.
  var id = this.params.id;
})
.post('/item/:id', function(next) {
  // You can use this just like koa-router, although repeating yourself
  // does get annoying.
})
.route('/item2/:id', {
  // How about we define them all at once?
  get: function*(next) {
    var id = this.params.id;
  },
  post: function*(next) {
    // Oh this is much better!
  }
});

// You can also return individual Route objects if you prefer
router
.route('/some/route')
.get(function*(next) {
  // ...
})
.post(function(next) {
  // ...
})
.delete(function(next) {
  // ...
}),
.put(function(next) {
  // ...
});

// Add the router as middleware to the app.
app.use(router.middleware());

app.listen(3000);

API

• class Route
  • new Route (router, path)
  • Route#get|post|delete|put (...middleware) → {Route}
• class Router
  • new Router ([options])
  • Router#get|post|delete|put (path, ...middleware) → {Router}
  • Router#route (path, [methods]) → {Router|Route}
  • Router#pre ([method], ...middleware) → {Router}
  • Router#middleware () → {GeneratorFunction}

class Route

new Route (router, path)

The route.

Route#get|post|delete|put (...middleware) → {Route}

Assign middleware to be run upon relevant HTTP method being triggered.

Returns: Route Returns this instance of Route.

class Router

new Router ([options])

The router.

Router#get|post|delete|put (path, ...middleware) → {Router}

Assign middleware to be run upon relevant HTTP method being triggered.

Returns: Router Returns this instance of Router.

Router#route (path, [methods]) → {Router|Route}

Create or get a Route from the Router object, or HTTP methods on Route by using the optional methods parameter.

Returns: Router|Route Returns this instance of Router, or Route for path if no methods specified.

Example: Usage with optional methods parameter

router.route('/test', {
  * get(next) {
    // Do something
  },
  * post(next) {
    // Do something
  }
})

Example: Usage with only path parameter

const testRoute = router.route('/test')

Router#pre ([method], ...middleware) → {Router}

Define middleware to run prior to HTTP method middleware. If no method provided, the middleware will run before all other middlewares on the router.

Returns: Router Returns this instance of Router.

Example: Example of #pre usage.

router.pre(function* (next) {
  this.type = 'application/json'
  yield next
}).pre('post', bodyParser())

Router#middleware () → {GeneratorFunction}

Returns the middleware to be provided to the Koa app instance.

Returns: GeneratorFunction Middleware to provide to Koa.

License

BSD 2-clause license. See LICENSE.