2.1.2 • Published 5 years ago

express-recursive-routes v2.1.2

Weekly downloads
1
License
MIT
Repository
github
Last release
5 years ago

express-recursive-routes

Recursively configure Express.js routes in a folder. It uses sensible defaults (filenames) but can be easily customized.

Usage

express-generator creates routes under /routes folder, but you have to manually register routes like this:

var index = require('./routes/index');
var users = require('./routes/users');

app.use('/', index);
app.use('/users', users);

With express-recursive-routes you can let function mountRoutes() do the magic:

const routeUtils = require('express-recursive-routes');
routeUtils.mountRoutes(app);

Configuration

If your setup is different, you can pass configuration parameters to mountRoutes():

  • rootDir: folder containing route files. Defaults to ./routes
  • basePath: prefix path added to all routes. Defaults to '' (empty)
  • filter: search for filenames containing this string
    • defaults to .js
    • strips filter from route path
    • it always strips the trailing .js suffix

Logging

You can activate various logging levels setting EXPRESS_RECURSIVE_ROUTES_LOG_LEVEL environment variable. Valid values are:

  • ERROR (default)
  • WARN
  • INFO
  • DEBUG

Example 1: custom routes folder

If your routes files are stored in a folder different from routes, for example:
src/my-routes

you can configure them like this:

routeUtils.mountRoutes(app, './src/my-routes');

Example 1: custom prefix path

Sometimes you want your routes to have a special prefix, for example /api:

routeUtils.mountRoutes(app, null, '/api');

Development

Install semantic-release-cli:

npm install -g semantic-release-cli
semantic-release-cli setup

Commit using commit script (commit-zen):

npm run commit
2.1.2

5 years ago

2.1.1

5 years ago

2.1.0

6 years ago

2.0.1

8 years ago

2.0.0

8 years ago

1.2.0

8 years ago

1.1.0

8 years ago

1.1.0-beta.0

8 years ago

1.0.2

8 years ago

1.0.0

8 years ago