npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

rainbowy

v0.0.2

Published

Express router middleware for RESTful API base on certain folder path

Downloads

4

Readme

Rainbow

npm install rainbowy

以文件夹嵌套的形式来表示route配置。

controllers文件夹里可以放置很多controller,而且程序初始化的时候会扫描这个文件夹,对所有controller进行初始化,然后自动生成对应的url的route,这是本框架的一大特色。

controllers里可以创建多层文件夹,每个文件夹代表route里的一级。

例如 这样的目录结构 /controllers/user/admin.js 里面有一个 createUser: get的定义。

则在浏览器里这样访问 www.example.com/controllers/user/admin/createUser

同样,你可以这样来创建一个文件夹里的多个controller /controllers/user/admin/index.js

这样的效果跟上面的完全一样,然后admin文件夹下可以继续细分其他的controller文件。

支持正则route,写法:"reg:/(.*)" reg:指定是正则,后面跟正则路径

controller代码的结构:

module.exports.controllers = {
   "/list":{
       "get:doc":{
           "desc":"接口说明",
           ”params":{
               "token":"token"
           }
       },
       "get":function(req,res){
           var userId = commUtil.decrypt(req.query.token);
           detectionService.getAll(req.query.page||1,20,{

           },function(err,orders){
               if (err) {
                   res.send(commUtil.createParameterErrorMsg(err.message));
               } else {
                   res.send(commUtil.createNormalOK(orders));
               }
           })
       }
   }
}
module.exports.filters = {
   "/list":{
       get:['checkLogin']
       post:['checkLoginJson']
   }
}

配置方法:

rainbow.route(app, {
    controllers: '/controllers/',
    filters: '/filters/',
    template: '/views/'
});

blow is rainbow's document

A node Express router middleware for Ajax RESTful API base on certain folder path.

Rainbow mapping all HTTP request route to controllers folder each as path to file as URL.

Installation

$ npm install rainbow

Usage

In your express application main file app.js:

var express = require('express');
var rainbow = require('rainbow');

var app = express();

// Here using Rainbow to initialize all routers
rainbow.route(app);

app.listen(6060);

Controllers

All your controllers for catching HTTP request should be defined in each file in controllers/ folder (could be changed) as same path in URL.

This is the core design for Rainbow! And it makes routing much simpler only by files' paths!

Here writes a router something.js in your controllers/ folder like this:

exports.get = function (req, res, next) {
	res.send(200, 'Simple getting.');
};

If you need some filters, just add a filters array property which contains your filters in filters/ folder to the handle function like this:

exports.get = function (req, res, next) {
	res.send(200, 'Simple getting.');
};
// add filters
exports.get.filters = ['authorization'];

Also you could define other HTTP methods handlers, but make sure in one file each URL! Example in controllers/user.js:

exports.get = function (req, res, next) {
	User.find({where: req.query.name}).success(function (user) {
		res.send(200, user);
	});
};

exports.put = function (req, res, next) {
	User.create(req.body).success(function (user) {
		res.send(201, user.id);
	});
};

// You can also define `post` and `delete` handlers.
// ...

If you want all methods to be process in only one controller(something not RESTful), just make exports to be the handle function:

module.exports = function (req, res, next) {
	// all your process
};

Notice

Rainbow controllers only design for tranditional URL form like /path?query=value but not like /path/user/:id yet.

In rich Ajax apps tranditional URL form could be more useful. However, Rainbow may consider param form URL in future versions.

Filters

Make sure the filters you need had been defined in filters/ folder (could be changed) as same module name, because them will be required when initilizing. Here authorization.js is a example for intecepting by non-authenticated user before GET http://yourapp:6060/something:

module.exports = function (req, res, next) {
	console.log('processing authorization...');
	var session = req.session;
	
	if (session.userId) {
		console.log('user(%d) in session', session.userId);
		next();
	} else {
		console.log('out of session');
		// Async filter is ok with express!
		db.User.find().success(function (user) {
			if (!user) {
				res.send(403);
				res.end();
			}
		});
	}
};

You could see filters is as same as a origin router in Express, just be put together in filters/ folder to be interceptors like in Java SSH.

Change default path

Controllers and filters default path could be changed by passing a path config object to route function when initializing:

rainbow.route(app, {
	controllers: '/your/controllers/path',
	filters: '/your/filters/path'
});

These paths are all RELATIVE to your app path!

Troubleshooting

  1. Gmail me: mytharcher
  2. Write a issue
  3. Send your pull request to me.

MIT Licensed

-EOF-