10371b7b1e
• Add linting with eslint • Add unit testing support with mocha with unit tests • Add Router class with support for only matching exact strings • Add RouteNode class for transversing all routes |
9 years ago | |
---|---|---|
lib | 9 years ago | |
test | 9 years ago | |
.eslintrc | 9 years ago | |
.gitignore | 9 years ago | |
LICENSE | 9 years ago | |
README.md | 9 years ago | |
package.json | 9 years ago |
README.md
routing-buddy
Yet another routing library in JavaScript. This project was created after looking at and trying several JavaScript routing libraries out there and not finding one that really worked that way I wanted it to work. I wanted a library that could be used both on the client and server side without feeling like it was designed for one side with the other bolted on like it was an afterthought. I also wanted a library that gave more flexibility for defining routes.
Status
NOTE: This is currently a Work in progress. I'm not yet sure if this will be the routing library I want.
Design
The main class exported in this library is Router
.
Router
is a wrapper around RouteNode
.
A RouteNode
is a tree structure to define all routes.
For development
To run unit tests:
$ # run unit tests and lint
$ npm test
$ # run unit tests only
$ mocha
$ # run linter only
$ eslint
See unit tests for more details.
Usage:
var Router = require('routing-buddy')
var router = new Router()
// Define a handler to be called when routed to the url
router.add('/some/path/here', function () {
// do something for '/some/path/here'
})
// Get the handler for '/some/path/here' and call it.
// Call the callback after finding the route
router.route('/some/path/here', function (err, maybeResults) {
// `err` will be either null or Error.
// null: everything was fine
// Error: missing route or any other error that might happen
// maybeResults: The return value from the hander from add
})