course  #

A framework-independent express-like router.

Usage ##


$3

Creates a new router.

$3

Adds a new middleware to the router. method is an HTTP verb, such as get,
post or put, to filter requests by the request method used.

The first argument may optionally be a URL pattern or regular expression to
match URLs against. Each argument after the URL is an express-style middleware
function with the signature (req, res, next).

$3

Same as above, however without filtering by request method.

Example ##

`` javascript
var db = require('some-database')
var course = require('course')
var http = require('http')
var router = course()

var server = http.createServer(function(req, res) {
router(req, res, function(err) {
if (err) return res.end(err.message)
res.end('404')
})
})

router.all(function(req, res, next) {
// do something on every request...
next()
})

// pass in URL filters, and multiple
// middlewares
router.get('/'
, getUserData
, loadHomeView
, render
)

function getUserData(req, res, next) {
db.getUser(function(err, user) {
if (err) return next(err)
req.user = user
next()
})
}

function loadHomeView(req, res, next) {
req.view = require('./views/home')
next()
}

function render(req, res, next) {
req.end(req.view({
user: req.user
}))
}

// Or capture URL paths:
router.get('/user/:username/*', function(req, res, next) {
var name = this.username
var page = this[1]
})
``

License ##

MIT. See LICENSE.md for details.