Comparing express@3.21.2...express@4.0.0 • npm-diff.app 📦🔃

 (The MIT License)
+Copyright (c) 2009-2013 TJ Holowaychuk <tj@vision-media.ca>
+Copyright (c) 2013 Roman Shtylman <shtylman+expressjs@gmail.com>
+Copyright (c) 2009-2014 TJ Holowaychuk <tj@vision-media.ca>
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

@@ -1,2 +1,4 @@
1		1
2	module.exports = require('./lib/express');	2	module.exports = process.env.EXPRESS_COV
		3	? require('./lib-cov/express')
		4	: require('./lib/express');

   Fast, unopinionated, minimalist web framework for [node](http://nodejs.org).
+  [![NPM version](https://img.shields.io/npm/v/express.svg)](https://www.npmjs.org/package/express)
+  [![Build Status](https://img.shields.io/travis/strongloop/express/3.x.svg)](https://travis-ci.org/strongloop/express)
+  [![Coverage Status](https://img.shields.io/coveralls/strongloop/express/3.x.svg)](https://coveralls.io/r/strongloop/express)
+  [![Build Status](https://secure.travis-ci.org/visionmedia/express.svg)](https://travis-ci.org/visionmedia/express) [![Gittip](https://img.shields.io/gittip/visionmedia.svg)](https://www.gittip.com/visionmedia/)
 ```js
 var express = require('express');
 app.listen(3000);
 ```
+  Note that Express v4 release candidates have been released.
+  Please try it out, but not in production, and report any issues you may find here or to the appropriate repositories.
+  Be sure to read [Migrating from 3.x to 4.x](https://github.com/visionmedia/express/wiki/Migrating-from-3.x-to-4.x) as well as [New features in 4.x](https://github.com/visionmedia/express/wiki/New-features-in-4.x).
 ## Installation
+    $ npm install express
 ## Quick Start
+ The quickest way to get started with express is to utilize the executable [`express(1)`](http://github.com/expressjs/generator) to generate an application as shown below:
+ Install the executable. The executable's major version will match Express's:
+    $ npm install -g express-generator@3
  Create the app:
+    $ npm install -g express
     $ express /tmp/foo && cd /tmp/foo
  Install dependencies:
  Start the server:
+    $ npm start
 ## Features
+  * Built on [Connect](http://github.com/senchalabs/connect)
   * Robust routing
   * HTTP helpers (redirection, caching, etc)
   * View system supporting 14+ template engines
   it a great solution for single page applications, web sites, hybrids, or public
   HTTP APIs.
+  Built on Connect, you can use _only_ what you need, and nothing more. Applications
+  can be as big or as small as you like, even a single file. Express does
+  Express does not force you to use any specific ORM or template engine. With support for over
 template engines via [Consolidate.js](http://github.com/visionmedia/consolidate.js),
   you can quickly craft your perfect framework.
 ## More Information
+  * [Website and Documentation](http://expressjs.com/) stored at [visionmedia/expressjs.com](https://github.com/visionmedia/expressjs.com)
   * Join #express on freenode
   * [Google Group](http://groups.google.com/group/express-js) for discussion
+  * Follow [tjholowaychuk](http://twitter.com/tjholowaychuk) on twitter for updates
+  * Follow [tjholowaychuk](http://twitter.com/tjholowaychuk) and [defunctzombie](https://twitter.com/defunctzombie) on twitter for updates
+  * Visit the [Wiki](http://github.com/visionmedia/express/wiki)
   * [Русскоязычная документация](http://jsman.ru/express/)
   * Run express examples [online](https://runnable.com/express)
 Clone the Express repo, then install the dev dependencies to install all the example / test suite dependencies:
+    $ git clone git://github.com/visionmedia/express.git --depth 1
     $ cd express
     $ npm install
 Then run the tests:
+```sh
+$ npm test
+    $ make test
 ## Contributors
+  https://github.com/visionmedia/express/graphs/contributors
 ## License
+(The MIT License)
+Copyright (c) 2009-2012 TJ Holowaychuk &lt;tj@vision-media.ca&gt;
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+MIT

  * Module dependencies.
  */
+var deprecate = require('depd')('express');
+var mixin = require('merge-descriptors');
+var merge = require('utils-merge');
+var connect = require('connect')
+  , proto = require('./application')
+  , Route = require('./router/route')
+  , Router = require('./router')
+  , req = require('./request')
+var EventEmitter = require('events').EventEmitter;
+var mixin = require('utils-merge');
+var proto = require('./application');
+var Route = require('./router/route');
+var Router = require('./router');
+var req = require('./request');
+var res = require('./response');
 /**
  * Expose `createApplication()`.
 exports = module.exports = createApplication;
 /**
+ * Expose mime.
+ */
+exports.mime = connect.mime;
+/**
  * Create an express application.
+ *
  * @return {Function}
  */
 function createApplication() {
+  var app = connect();
+  var app = function(req, res, next) {
+    app.handle(req, res, next);
+  };
+  mixin(app, proto);
+  mixin(app, EventEmitter.prototype);
   app.request = { __proto__: req, app: app };
   app.response = { __proto__: res, app: app };
   app.init();
+}
 /**
+ * Expose connect.middleware as express.*
+ * for example `express.logger` etc.
+ */
+mixin(exports, connect.middleware);
+/**
+ * Deprecated createServer().
+ */
+exports.createServer = deprecate.function(createApplication,
+  'createServer() is deprecated\n' +
+  'express applications no longer inherit from http.Server\n' +
+  'please use:\n' +
+  '\n' +
+  '  var express = require("express");\n' +
+  '  var app = express();\n' +
+  '\n'
+);
+/**
  * Expose the prototypes.
  */
 exports.Route = Route;
 exports.Router = Router;
+/**
+ * Expose middleware
+ */
+exports.query = require('./middleware/query');
+exports.static = require('serve-static');
+/**
+ * Replace removed middleware with an appropriate error message.
+ */
+[
+  'json',
+  'urlencoded',
+  'bodyParser',
+  'compress',
+  'cookieSession',
+  'session',
+  'logger',
+  'cookieParser',
+  'favicon',
+  'responseTime',
+  'errorHandler',
+  'timeout',
+  'methodOverride',
+  'vhost',
+  'csrf',
+  'directory',
+  'limit',
+  'multipart',
+  'staticCache',
+].forEach(function (name) {
+  Object.defineProperty(exports, name, {
+    get: function () {
+      throw new Error('Most middleware (like ' + name + ') is no longer bundled with Express and must be installed separately. Please see https://github.com/senchalabs/connect#middleware.');
+    }
+  });
+});

  * Module dependencies.
  */
+var path = require('path')
+  , fs = require('fs')
+  , utils = require('./utils')
+  , dirname = path.dirname
+  , basename = path.basename
+  , extname = path.extname
+  , exists = fs.existsSync || path.existsSync
+var path = require('path');
+var fs = require('fs');
+var utils = require('./utils');
+var dirname = path.dirname;
+var basename = path.basename;
+var extname = path.extname;
+var exists = fs.existsSync || path.existsSync;
+var join = path.join;
 /**
  * Expose `View`.

+MOCHA_OPTS= --check-leaks
+REPORTER = dot
+check: test
+test: test-unit test-acceptance
+test-unit:
+	@NODE_ENV=test ./node_modules/.bin/mocha \
+		--reporter $(REPORTER) \
+		--globals setImmediate,clearImmediate \
+		$(MOCHA_OPTS)
+test-acceptance:
+	@NODE_ENV=test ./node_modules/.bin/mocha \
+		--reporter $(REPORTER) \
+		--bail \
+		test/acceptance/*.js
+test-cov: lib-cov
+	@EXPRESS_COV=1 $(MAKE) test REPORTER=html-cov > coverage.html
+lib-cov:
+	@jscoverage lib lib-cov
+bench:
+	@$(MAKE) -C benchmarks
+clean:
+	rm -f coverage.html
+	rm -fr lib-cov
+.PHONY: test test-unit test-acceptance bench clean

+/**
+ * Initialization middleware, exposing the
+ * request and response to eachother, as well
+ * as defaulting the X-Powered-By header field.
+ *
+ * @param {Function} app
+ * @return {Function}
+ * @api private
+ */
+exports.init = function(app){
+  return function expressInit(req, res, next){
+    if (app.enabled('x-powered-by')) res.setHeader('X-Powered-By', 'Express');
+    req.res = res;
+    res.req = req;
+    req.next = next;
+    req.__proto__ = app.request;
+    res.__proto__ = app.response;
+    res.locals = res.locals || Object.create(null);
+    next();
+  };
+};

+/**
+ * Module dependencies.
+ */
+var qs = require('qs');
+var parseUrl = require('parseurl');
+/**
+ * Query:
+ *
+ * Automatically parse the query-string when available,
+ * populating the `req.query` object using
+ * [qs](https://github.com/visionmedia/node-querystring).
+ *
+ * Examples:
+ *
+ *       .use(connect.query())
+ *       .use(function(req, res){
+ *         res.end(JSON.stringify(req.query));
+ *       });
+ *
+ *  The `options` passed are provided to qs.parse function.
+ *
+ * @param {Object} options
+ * @return {Function}
+ * @api public
+ */
+module.exports = function query(options){
+  return function query(req, res, next){
+    if (!req.query) {
+      req.query = ~req.url.indexOf('?')
+        ? qs.parse(parseUrl(req).query, options)
+        : {};
+    }
+    next();
+  };
+};

+/**
+ * Module dependencies.
+ */
+var pathRegexp = require('path-to-regexp');
+var debug = require('debug')('express:router:layer');
+/**
+ * Expose `Layer`.
+ */
+module.exports = Layer;
+function Layer(path, options, fn) {
+  if (!(this instanceof Layer)) {
+    return new Layer(path, options, fn);
+  }
+  debug('new %s', path);
+  options = options || {};
+  this.regexp = pathRegexp(path, this.keys = [], options);
+  this.handle = fn;
+}
+/**
+ * Check if this route matches `path`, if so
+ * populate `.params`.
+ *
+ * @param {String} path
+ * @return {Boolean}
+ * @api private
+ */
+Layer.prototype.match = function(path){
+  var keys = this.keys;
+  var params = this.params = {};
+  var m = this.regexp.exec(path);
+  var n = 0;
+  var key;
+  var val;
+  if (!m) return false;
+  this.path = m[0];
+  for (var i = 1, len = m.length; i < len; ++i) {
+    key = keys[i - 1];
+    try {
+      val = 'string' == typeof m[i]
+        ? decodeURIComponent(m[i])
+        : m[i];
+    } catch(e) {
+      var err = new Error("Failed to decode param '" + m[i] + "'");
+      err.status = 400;
+      throw err;
+    }
+    if (key) {
+      params[key.name] = val;
+    } else {
+      params[n++] = val;
+    }
+  }
+  return true;
+};

+var http = require('http');
+var express = require('..');
+var app = express();
+// number of middleware
+var n = parseInt(process.env.MW || '1', 10);
+console.log('  %s middleware', n);
+while (n--) {
+  app.use(function(req, res, next){
+    next();
+  });
+}
+var body = new Buffer('Hello World');
+app.use(function(req, res, next){
+  res.send(body);
+});
+app.listen(3333);

+all:
+	@./run 1 middleware
+	@./run 5 middleware
+	@./run 10 middleware
+	@./run 15 middleware
+	@./run 20 middleware
+	@./run 30 middleware
+	@./run 50 middleware
+	@./run 100 middleware
+	@echo
+.PHONY: all

+#!/usr/bin/env bash
+echo
+MW=$1 node $2 &
+pid=$!
+sleep 2
+wrk 'http://localhost:3333/?foo[bar]=baz' \
+  -d 3 \
+  -c 50 \
+  -t 8 \
+  | grep 'Requests/sec' \
+  | awk '{ print "  " $2 }'
+kill $pid

Comparingexpress@3.21.2

Comparingexpress@3.21.2

Source

npm diff

Options

Bundlephobia

Packagephobia

Packagephobia

package.json +++66---58

LICENSE +++2---4

index.js +++3---1

History.md +++31---875

Readme.md +++20---42

bin/express +++0---440

lib/application.js +++156---215

lib/express.js +++50---40

lib/middleware.js +++0---32

lib/request.js +++60---217

lib/response.js +++114---182

lib/utils.js +++7---312

lib/view.js +++8---8

lib/router/index.js +++265---218

lib/router/route.js +++156---43

Makefile +++34---0

lib/middleware/init.js +++26---0

lib/middleware/query.js +++39---0

lib/router/layer.js +++67---0

benchmarks/middleware.js +++23---0

benchmarks/Makefile +++13---0

benchmarks/run +++16---0

+++0---0

Packagephobia

package.json +++66---58

LICENSE +++2---4

index.js +++3---1

History.md +++31---875

Readme.md +++20---42

bin/express +++0---440

lib/application.js +++156---215

lib/express.js +++50---40

lib/middleware.js +++0---32

lib/request.js +++60---217

lib/response.js +++114---182

lib/utils.js +++7---312

lib/view.js +++8---8

lib/router/index.js +++265---218

lib/router/route.js +++156---43

Makefile +++34---0

lib/middleware/init.js +++26---0

lib/middleware/query.js +++39---0

lib/router/layer.js +++67---0

benchmarks/middleware.js +++23---0

benchmarks/Makefile +++13---0

benchmarks/run +++16---0

Source

Comparing
`express@3.21.2`

Comparing
`express@3.21.2`