New Case Study:See how Anthropic automated 95% of dependency reviews with Socket.Learn More
Socket
Sign inDemoInstall
Socket

annotation-router

Package Overview
Dependencies
Maintainers
1
Versions
10
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

annotation-router

Bring annotations to your everyday routing framework

  • 0.8.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
3
decreased by-57.14%
Maintainers
1
Weekly downloads
 
Created
Source

node-annotation-router Build Status Coverage Status

Bring annotations to your favorite routing framework

Install

$ npm install --save annotation-router

Usage

given this file controller.js

/*
    @routePrefix('/api')
*/
module.exports = {

    // @httpGet()
    // @route('/collection')
    collection: function(){

    },


    // @route('/collection/{id}')
    getIndex: function(){

    },

    // @route('/collection')
    postItem: function(){

    },
> };

You can then simply retrieve each single route by doing so:


var annotationRouter = require('annotation-router');

annotationRouter('controller.js', function(err, route){

    console.log(route);
    /*
        {
            url: '/api/collection',
            method: 'GET',
            action: /* the action function */
        },
        ...
    */
}, function(err){
    // all routes have been parsed
});

API

annotationRouter(paths, eachCallback, finalCallback);

paths

Required
Type: string, array

paths of the all the controllers in the solution that will be checked for routing annotations
check globby for details

eachCallback(err, route)
route.url

Type: string

route.method

Type: string
Possible Values: GET, POST, PUT, DELETE, HEAD

route.action

Type: Function

The action function associated with the route

finalCallback(err)

Annotations API

@routePrefix(url)

All the functions inside the module will prepend the prefixUrl to theirs urls

@route(url)

The function following this annotation will be called when someone request the url

@httpGet() and equivalents

Set the method of the route
If none of the available method definition annotation could be found, the route's method will be guessed from the name of the function

Inspiration

Vatican is another library which use annotation to define routes. Although it's a standalone library which means you can't use your favorite routing library.

If you ever work with Microsoft's MVC library, you surely noticed that we are trying to reproduce the same behavior.

Licence

MIT © Thomas Sileghem

FAQs

Package last updated on 11 Jul 2015

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc