4.1.1
[express.git] / History.md
blob291d7bba6fab57fc7deb1ca5d6b1a5527e58b3f4
1 4.1.1 / 2014-04-27
2 ==================
4  * fix package.json to reflect supported node version
6 4.1.0 / 2014-04-24
7 ==================
9  * pass options from `res.sendfile` to `send`
10  * preserve casing of headers in `res.header` and `res.set`
11  * support unicode file names in `res.attachment` and `res.download`
12  * update accepts to 1.0.1
13  * update cookie to 0.1.2
14  * update send to 0.3.0
15  * update serve-static to 1.1.0
16  * update type-is to 1.1.0
18 4.0.0 / 2014-04-09
19 ==================
21  * remove:
22    - node 0.8 support
23    - connect and connect's patches except for charset handling
24    - express(1) - moved to [express-generator](https://github.com/expressjs/generator)
25    - `express.createServer()` - it has been deprecated for a long time. Use `express()`
26    - `app.configure` - use logic in your own app code
27    - `app.router` - is removed
28    - `req.auth` - use `basic-auth` instead
29    - `req.accepted*` - use `req.accepts*()` instead
30    - `res.location` - relative URL resolution is removed
31    - `res.charset` - include the charset in the content type when using `res.set()`
32    - all bundled middleware except `static`
33  * change:
34    - `app.route` -> `app.mountpath` when mounting an express app in another express app
35    - `json spaces` no longer enabled by default in development
36    - `req.accepts*` -> `req.accepts*s` - i.e. `req.acceptsEncoding` -> `req.acceptsEncodings`
37    - `req.params` is now an object instead of an array
38    - `res.locals` is no longer a function. It is a plain js object. Treat it as such.
39    - `res.headerSent` -> `res.headersSent` to match node.js ServerResponse object
40  * refactor:
41    - `req.accepts*` with [accepts](https://github.com/expressjs/accepts)
42    - `req.is` with [type-is](https://github.com/expressjs/type-is)
43    - [path-to-regexp](https://github.com/component/path-to-regexp)
44  * add:
45    - `app.router()` - returns the app Router instance
46    - `app.route()` - Proxy to the app's `Router#route()` method to create a new route
47    - Router & Route - public API
49 3.5.2 / 2014-04-24
50 ==================
52  * update connect to 2.14.5
53  * update cookie to 0.1.2
54  * update mkdirp to 0.4.0
55  * update send to 0.3.0
57 3.5.1 / 2014-03-25
58 ==================
60  * pin less-middleware in generated app
62 3.5.0 / 2014-03-06
63 ==================
65  * bump deps
67 3.4.8 / 2014-01-13
68 ==================
70  * prevent incorrect automatic OPTIONS responses #1868 @dpatti
71  * update binary and examples for jade 1.0 #1876 @yossi, #1877 @reqshark, #1892 @matheusazzi
72  * throw 400 in case of malformed paths @rlidwka
74 3.4.7 / 2013-12-10
75 ==================
77  * update connect
79 3.4.6 / 2013-12-01
80 ==================
82  * update connect (raw-body)
84 3.4.5 / 2013-11-27
85 ==================
87  * update connect
88  * res.location: remove leading ./ #1802 @kapouer
89  * res.redirect: fix `res.redirect('toString') #1829 @michaelficarra
90  * res.send: always send ETag when content-length > 0
91  * router: add Router.all() method
93 3.4.4 / 2013-10-29
94 ==================
96  * update connect
97  * update supertest
98  * update methods
99  * express(1): replace bodyParser() with urlencoded() and json() #1795 @chirag04
101 3.4.3 / 2013-10-23
102 ==================
104  * update connect
106 3.4.2 / 2013-10-18
107 ==================
109  * update connect
110  * downgrade commander
112 3.4.1 / 2013-10-15
113 ==================
115  * update connect
116  * update commander
117  * jsonp: check if callback is a function
118  * router: wrap encodeURIComponent in a try/catch #1735 (@lxe)
119  * res.format: now includes chraset @1747 (@sorribas)
120  * res.links: allow multiple calls @1746 (@sorribas)
122 3.4.0 / 2013-09-07
123 ==================
125  * add res.vary(). Closes #1682
126  * update connect
128 3.3.8 / 2013-09-02
129 ==================
131  * update connect
133 3.3.7 / 2013-08-28
134 ==================
136  * update connect
138 3.3.6 / 2013-08-27
139 ==================
141  * Revert "remove charset from json responses. Closes #1631" (causes issues in some clients)
142  * add: req.accepts take an argument list
144 3.3.4 / 2013-07-08
145 ==================
147  * update send and connect
149 3.3.3 / 2013-07-04
150 ==================
152  * update connect
154 3.3.2 / 2013-07-03
155 ==================
157  * update connect
158  * update send
159  * remove .version export
161 3.3.1 / 2013-06-27
162 ==================
164  * update connect
166 3.3.0 / 2013-06-26
167 ==================
169  * update connect
170  * add support for multiple X-Forwarded-Proto values. Closes #1646
171  * change: remove charset from json responses. Closes #1631
172  * change: return actual booleans from req.accept* functions
173  * fix jsonp callback array throw
175 3.2.6 / 2013-06-02
176 ==================
178  * update connect
180 3.2.5 / 2013-05-21
181 ==================
183  * update connect
184  * update node-cookie
185  * add: throw a meaningful error when there is no default engine
186  * change generation of ETags with res.send() to GET requests only. Closes #1619
188 3.2.4 / 2013-05-09
189 ==================
191   * fix `req.subdomains` when no Host is present
192   * fix `req.host` when no Host is present, return undefined
194 3.2.3 / 2013-05-07
195 ==================
197   * update connect / qs
199 3.2.2 / 2013-05-03
200 ==================
202   * update qs
204 3.2.1 / 2013-04-29
205 ==================
207   * add app.VERB() paths array deprecation warning
208   * update connect
209   * update qs and remove all ~ semver crap
210   * fix: accept number as value of Signed Cookie
212 3.2.0 / 2013-04-15
213 ==================
215   * add "view" constructor setting to override view behaviour
216   * add req.acceptsEncoding(name)
217   * add req.acceptedEncodings
218   * revert cookie signature change causing session race conditions
219   * fix sorting of Accept values of the same quality
221 3.1.2 / 2013-04-12
222 ==================
224   * add support for custom Accept parameters
225   * update cookie-signature
227 3.1.1 / 2013-04-01
228 ==================
230   * add X-Forwarded-Host support to `req.host`
231   * fix relative redirects
232   * update mkdirp
233   * update buffer-crc32
234   * remove legacy app.configure() method from app template.
236 3.1.0 / 2013-01-25
237 ==================
239   * add support for leading "." in "view engine" setting
240   * add array support to `res.set()`
241   * add node 0.8.x to travis.yml
242   * add "subdomain offset" setting for tweaking `req.subdomains`
243   * add `res.location(url)` implementing `res.redirect()`-like setting of Location
244   * use app.get() for x-powered-by setting for inheritance
245   * fix colons in passwords for `req.auth`
247 3.0.6 / 2013-01-04
248 ==================
250   * add http verb methods to Router
251   * update connect
252   * fix mangling of the `res.cookie()` options object
253   * fix jsonp whitespace escape. Closes #1132
255 3.0.5 / 2012-12-19
256 ==================
258   * add throwing when a non-function is passed to a route
259   * fix: explicitly remove Transfer-Encoding header from 204 and 304 responses
260   * revert "add 'etag' option"
262 3.0.4 / 2012-12-05
263 ==================
265   * add 'etag' option to disable `res.send()` Etags
266   * add escaping of urls in text/plain in `res.redirect()`
267     for old browsers interpreting as html
268   * change crc32 module for a more liberal license
269   * update connect
271 3.0.3 / 2012-11-13
272 ==================
274   * update connect
275   * update cookie module
276   * fix cookie max-age
278 3.0.2 / 2012-11-08
279 ==================
281   * add OPTIONS to cors example. Closes #1398
282   * fix route chaining regression. Closes #1397
284 3.0.1 / 2012-11-01
285 ==================
287   * update connect
289 3.0.0 / 2012-10-23
290 ==================
292   * add `make clean`
293   * add "Basic" check to req.auth
294   * add `req.auth` test coverage
295   * add cb && cb(payload) to `res.jsonp()`. Closes #1374
296   * add backwards compat for `res.redirect()` status. Closes #1336
297   * add support for `res.json()` to retain previously defined Content-Types. Closes #1349
298   * update connect
299   * change `res.redirect()` to utilize a pathname-relative Location again. Closes #1382
300   * remove non-primitive string support for `res.send()`
301   * fix view-locals example. Closes #1370
302   * fix route-separation example
304 3.0.0rc5 / 2012-09-18
305 ==================
307   * update connect
308   * add redis search example
309   * add static-files example
310   * add "x-powered-by" setting (`app.disable('x-powered-by')`)
311   * add "application/octet-stream" redirect Accept test case. Closes #1317
313 3.0.0rc4 / 2012-08-30
314 ==================
316   * add `res.jsonp()`. Closes #1307
317   * add "verbose errors" option to error-pages example
318   * add another route example to express(1) so people are not so confused
319   * add redis online user activity tracking example
320   * update connect dep
321   * fix etag quoting. Closes #1310
322   * fix error-pages 404 status
323   * fix jsonp callback char restrictions
324   * remove old OPTIONS default response
326 3.0.0rc3 / 2012-08-13
327 ==================
329   * update connect dep
330   * fix signed cookies to work with `connect.cookieParser()` ("s:" prefix was missing) [tnydwrds]
331   * fix `res.render()` clobbering of "locals"
333 3.0.0rc2 / 2012-08-03
334 ==================
336   * add CORS example
337   * update connect dep
338   * deprecate `.createServer()` & remove old stale examples
339   * fix: escape `res.redirect()` link
340   * fix vhost example
342 3.0.0rc1 / 2012-07-24
343 ==================
345   * add more examples to view-locals
346   * add scheme-relative redirects (`res.redirect("//foo.com")`) support
347   * update cookie dep
348   * update connect dep
349   * update send dep
350   * fix `express(1)` -h flag, use -H for hogan. Closes #1245
351   * fix `res.sendfile()` socket error handling regression
353 3.0.0beta7 / 2012-07-16
354 ==================
356   * update connect dep for `send()` root normalization regression
358 3.0.0beta6 / 2012-07-13
359 ==================
361   * add `err.view` property for view errors. Closes #1226
362   * add "jsonp callback name" setting
363   * add support for "/foo/:bar*" non-greedy matches
364   * change `res.sendfile()` to use `send()` module
365   * change `res.send` to use "response-send" module
366   * remove `app.locals.use` and `res.locals.use`, use regular middleware
368 3.0.0beta5 / 2012-07-03
369 ==================
371   * add "make check" support
372   * add route-map example
373   * add `res.json(obj, status)` support back for BC
374   * add "methods" dep, remove internal methods module
375   * update connect dep
376   * update auth example to utilize cores pbkdf2
377   * updated tests to use "supertest"
379 3.0.0beta4 / 2012-06-25
380 ==================
382   * Added `req.auth`
383   * Added `req.range(size)`
384   * Added `res.links(obj)`
385   * Added `res.send(body, status)` support back for backwards compat
386   * Added `.default()` support to `res.format()`
387   * Added 2xx / 304 check to `req.fresh`
388   * Revert "Added + support to the router"
389   * Fixed `res.send()` freshness check, respect res.statusCode
391 3.0.0beta3 / 2012-06-15
392 ==================
394   * Added hogan `--hjs` to express(1) [nullfirm]
395   * Added another example to content-negotiation
396   * Added `fresh` dep
397   * Changed: `res.send()` always checks freshness
398   * Fixed: expose connects mime module. Cloases #1165
400 3.0.0beta2 / 2012-06-06
401 ==================
403   * Added `+` support to the router
404   * Added `req.host`
405   * Changed `req.param()` to check route first
406   * Update connect dep
408 3.0.0beta1 / 2012-06-01
409 ==================
411   * Added `res.format()` callback to override default 406 behaviour
412   * Fixed `res.redirect()` 406. Closes #1154
414 3.0.0alpha5 / 2012-05-30
415 ==================
417   * Added `req.ip`
418   * Added `{ signed: true }` option to `res.cookie()`
419   * Removed `res.signedCookie()`
420   * Changed: dont reverse `req.ips`
421   * Fixed "trust proxy" setting check for `req.ips`
423 3.0.0alpha4 / 2012-05-09
424 ==================
426   * Added: allow `[]` in jsonp callback. Closes #1128
427   * Added `PORT` env var support in generated template. Closes #1118 [benatkin]
428   * Updated: connect 2.2.2
430 3.0.0alpha3 / 2012-05-04
431 ==================
433   * Added public `app.routes`. Closes #887
434   * Added _view-locals_ example
435   * Added _mvc_ example
436   * Added `res.locals.use()`. Closes #1120
437   * Added conditional-GET support to `res.send()`
438   * Added: coerce `res.set()` values to strings
439   * Changed: moved `static()` in generated apps below router
440   * Changed: `res.send()` only set ETag when not previously set
441   * Changed connect 2.2.1 dep
442   * Changed: `make test` now runs unit / acceptance tests
443   * Fixed req/res proto inheritance
445 3.0.0alpha2 / 2012-04-26
446 ==================
448   * Added `make benchmark` back
449   * Added `res.send()` support for `String` objects
450   * Added client-side data exposing example
451   * Added `res.header()` and `req.header()` aliases for BC
452   * Added `express.createServer()` for BC
453   * Perf: memoize parsed urls
454   * Perf: connect 2.2.0 dep
455   * Changed: make `expressInit()` middleware self-aware
456   * Fixed: use app.get() for all core settings
457   * Fixed redis session example
458   * Fixed session example. Closes #1105
459   * Fixed generated express dep. Closes #1078
461 3.0.0alpha1 / 2012-04-15
462 ==================
464   * Added `app.locals.use(callback)`
465   * Added `app.locals` object
466   * Added `app.locals(obj)`
467   * Added `res.locals` object
468   * Added `res.locals(obj)`
469   * Added `res.format()` for content-negotiation
470   * Added `app.engine()`
471   * Added `res.cookie()` JSON cookie support
472   * Added "trust proxy" setting
473   * Added `req.subdomains`
474   * Added `req.protocol`
475   * Added `req.secure`
476   * Added `req.path`
477   * Added `req.ips`
478   * Added `req.fresh`
479   * Added `req.stale`
480   * Added comma-delmited / array support for `req.accepts()`
481   * Added debug instrumentation
482   * Added `res.set(obj)`
483   * Added `res.set(field, value)`
484   * Added `res.get(field)`
485   * Added `app.get(setting)`. Closes #842
486   * Added `req.acceptsLanguage()`
487   * Added `req.acceptsCharset()`
488   * Added `req.accepted`
489   * Added `req.acceptedLanguages`
490   * Added `req.acceptedCharsets`
491   * Added "json replacer" setting
492   * Added "json spaces" setting
493   * Added X-Forwarded-Proto support to `res.redirect()`. Closes #92
494   * Added `--less` support to express(1)
495   * Added `express.response` prototype
496   * Added `express.request` prototype
497   * Added `express.application` prototype
498   * Added `app.path()`
499   * Added `app.render()`
500   * Added `res.type()` to replace `res.contentType()`
501   * Changed: `res.redirect()` to add relative support
502   * Changed: enable "jsonp callback" by default
503   * Changed: renamed "case sensitive routes" to "case sensitive routing"
504   * Rewrite of all tests with mocha
505   * Removed "root" setting
506   * Removed `res.redirect('home')` support
507   * Removed `req.notify()`
508   * Removed `app.register()`
509   * Removed `app.redirect()`
510   * Removed `app.is()`
511   * Removed `app.helpers()`
512   * Removed `app.dynamicHelpers()`
513   * Fixed `res.sendfile()` with non-GET. Closes #723
514   * Fixed express(1) public dir for windows. Closes #866
516 2.5.9/ 2012-04-02
517 ==================
519   * Added support for PURGE request method [pbuyle]
520   * Fixed `express(1)` generated app `app.address()` before `listening` [mmalecki]
522 2.5.8 / 2012-02-08
523 ==================
525   * Update mkdirp dep. Closes #991
527 2.5.7 / 2012-02-06
528 ==================
530   * Fixed `app.all` duplicate DELETE requests [mscdex]
532 2.5.6 / 2012-01-13
533 ==================
535   * Updated hamljs dev dep. Closes #953
537 2.5.5 / 2012-01-08
538 ==================
540   * Fixed: set `filename` on cached templates [matthewleon]
542 2.5.4 / 2012-01-02
543 ==================
545   * Fixed `express(1)` eol on 0.4.x. Closes #947
547 2.5.3 / 2011-12-30
548 ==================
550   * Fixed `req.is()` when a charset is present
552 2.5.2 / 2011-12-10
553 ==================
555   * Fixed: express(1) LF -> CRLF for windows
557 2.5.1 / 2011-11-17
558 ==================
560   * Changed: updated connect to 1.8.x
561   * Removed sass.js support from express(1)
563 2.5.0 / 2011-10-24
564 ==================
566   * Added ./routes dir for generated app by default
567   * Added npm install reminder to express(1) app gen
568   * Added 0.5.x support
569   * Removed `make test-cov` since it wont work with node 0.5.x
570   * Fixed express(1) public dir for windows. Closes #866
572 2.4.7 / 2011-10-05
573 ==================
575   * Added mkdirp to express(1). Closes #795
576   * Added simple _json-config_ example
577   * Added  shorthand for the parsed request's pathname via `req.path`
578   * Changed connect dep to 1.7.x to fix npm issue...
579   * Fixed `res.redirect()` __HEAD__ support. [reported by xerox]
580   * Fixed `req.flash()`, only escape args
581   * Fixed absolute path checking on windows. Closes #829 [reported by andrewpmckenzie]
583 2.4.6 / 2011-08-22
584 ==================
586   * Fixed multiple param callback regression. Closes #824 [reported by TroyGoode]
588 2.4.5 / 2011-08-19
589 ==================
591   * Added support for routes to handle errors. Closes #809
592   * Added `app.routes.all()`. Closes #803
593   * Added "basepath" setting to work in conjunction with reverse proxies etc.
594   * Refactored `Route` to use a single array of callbacks
595   * Added support for multiple callbacks for `app.param()`. Closes #801
596 Closes #805
597   * Changed: removed .call(self) for route callbacks
598   * Dependency: `qs >= 0.3.1`
599   * Fixed `res.redirect()` on windows due to `join()` usage. Closes #808
601 2.4.4 / 2011-08-05
602 ==================
604   * Fixed `res.header()` intention of a set, even when `undefined`
605   * Fixed `*`, value no longer required
606   * Fixed `res.send(204)` support. Closes #771
608 2.4.3 / 2011-07-14
609 ==================
611   * Added docs for `status` option special-case. Closes #739
612   * Fixed `options.filename`, exposing the view path to template engines
614 2.4.2. / 2011-07-06
615 ==================
617   * Revert "removed jsonp stripping" for XSS
619 2.4.1 / 2011-07-06
620 ==================
622   * Added `res.json()` JSONP support. Closes #737
623   * Added _extending-templates_ example. Closes #730
624   * Added "strict routing" setting for trailing slashes
625   * Added support for multiple envs in `app.configure()` calls. Closes #735
626   * Changed: `res.send()` using `res.json()`
627   * Changed: when cookie `path === null` don't default it
628   * Changed; default cookie path to "home" setting. Closes #731
629   * Removed _pids/logs_ creation from express(1)
631 2.4.0 / 2011-06-28
632 ==================
634   * Added chainable `res.status(code)`
635   * Added `res.json()`, an explicit version of `res.send(obj)`
636   * Added simple web-service example
638 2.3.12 / 2011-06-22
639 ==================
641   * \#express is now on freenode! come join!
642   * Added `req.get(field, param)`
643   * Added links to Japanese documentation, thanks @hideyukisaito!
644   * Added; the `express(1)` generated app outputs the env
645   * Added `content-negotiation` example
646   * Dependency: connect >= 1.5.1 < 2.0.0
647   * Fixed view layout bug. Closes #720
648   * Fixed; ignore body on 304. Closes #701
650 2.3.11 / 2011-06-04
651 ==================
653   * Added `npm test`
654   * Removed generation of dummy test file from `express(1)`
655   * Fixed; `express(1)` adds express as a dep
656   * Fixed; prune on `prepublish`
658 2.3.10 / 2011-05-27
659 ==================
661   * Added `req.route`, exposing the current route
662   * Added _package.json_ generation support to `express(1)`
663   * Fixed call to `app.param()` function for optional params. Closes #682
665 2.3.9 / 2011-05-25
666 ==================
668   * Fixed bug-ish with `../' in `res.partial()` calls
670 2.3.8 / 2011-05-24
671 ==================
673   * Fixed `app.options()`
675 2.3.7 / 2011-05-23
676 ==================
678   * Added route `Collection`, ex: `app.get('/user/:id').remove();`
679   * Added support for `app.param(fn)` to define param logic
680   * Removed `app.param()` support for callback with return value
681   * Removed module.parent check from express(1) generated app. Closes #670
682   * Refactored router. Closes #639
684 2.3.6 / 2011-05-20
685 ==================
687   * Changed; using devDependencies instead of git submodules
688   * Fixed redis session example
689   * Fixed markdown example
690   * Fixed view caching, should not be enabled in development
692 2.3.5 / 2011-05-20
693 ==================
695   * Added export `.view` as alias for `.View`
697 2.3.4 / 2011-05-08
698 ==================
700   * Added `./examples/say`
701   * Fixed `res.sendfile()` bug preventing the transfer of files with spaces
703 2.3.3 / 2011-05-03
704 ==================
706   * Added "case sensitive routes" option.
707   * Changed; split methods supported per rfc [slaskis]
708   * Fixed route-specific middleware when using the same callback function several times
710 2.3.2 / 2011-04-27
711 ==================
713   * Fixed view hints
715 2.3.1 / 2011-04-26
716 ==================
718   * Added `app.match()` as `app.match.all()`
719   * Added `app.lookup()` as `app.lookup.all()`
720   * Added `app.remove()` for `app.remove.all()`
721   * Added `app.remove.VERB()`
722   * Fixed template caching collision issue. Closes #644
723   * Moved router over from connect and started refactor
725 2.3.0 / 2011-04-25
726 ==================
728   * Added options support to `res.clearCookie()`
729   * Added `res.helpers()` as alias of `res.locals()`
730   * Added; json defaults to UTF-8 with `res.send()`. Closes #632. [Daniel   * Dependency `connect >= 1.4.0`
731   * Changed; auto set Content-Type in res.attachement [Aaron Heckmann]
732   * Renamed "cache views" to "view cache". Closes #628
733   * Fixed caching of views when using several apps. Closes #637
734   * Fixed gotcha invoking `app.param()` callbacks once per route middleware.
735 Closes #638
736   * Fixed partial lookup precedence. Closes #631
737 Shaw]
739 2.2.2 / 2011-04-12
740 ==================
742   * Added second callback support for `res.download()` connection errors
743   * Fixed `filename` option passing to template engine
745 2.2.1 / 2011-04-04
746 ==================
748   * Added `layout(path)` helper to change the layout within a view. Closes #610
749   * Fixed `partial()` collection object support.
750     Previously only anything with `.length` would work.
751     When `.length` is present one must still be aware of holes,
752     however now `{ collection: {foo: 'bar'}}` is valid, exposes
753     `keyInCollection` and `keysInCollection`.
755   * Performance improved with better view caching
756   * Removed `request` and `response` locals
757   * Changed; errorHandler page title is now `Express` instead of `Connect`
759 2.2.0 / 2011-03-30
760 ==================
762   * Added `app.lookup.VERB()`, ex `app.lookup.put('/user/:id')`. Closes #606
763   * Added `app.match.VERB()`, ex `app.match.put('/user/12')`. Closes #606
764   * Added `app.VERB(path)` as alias of `app.lookup.VERB()`.
765   * Dependency `connect >= 1.2.0`
767 2.1.1 / 2011-03-29
768 ==================
770   * Added; expose `err.view` object when failing to locate a view
771   * Fixed `res.partial()` call `next(err)` when no callback is given [reported by aheckmann]
772   * Fixed; `res.send(undefined)` responds with 204 [aheckmann]
774 2.1.0 / 2011-03-24
775 ==================
777   * Added `<root>/_?<name>` partial lookup support. Closes #447
778   * Added `request`, `response`, and `app` local variables
779   * Added `settings` local variable, containing the app's settings
780   * Added `req.flash()` exception if `req.session` is not available
781   * Added `res.send(bool)` support (json response)
782   * Fixed stylus example for latest version
783   * Fixed; wrap try/catch around `res.render()`
785 2.0.0 / 2011-03-17
786 ==================
788   * Fixed up index view path alternative.
789   * Changed; `res.locals()` without object returns the locals
791 2.0.0rc3 / 2011-03-17
792 ==================
794   * Added `res.locals(obj)` to compliment `res.local(key, val)`
795   * Added `res.partial()` callback support
796   * Fixed recursive error reporting issue in `res.render()`
798 2.0.0rc2 / 2011-03-17
799 ==================
801   * Changed; `partial()` "locals" are now optional
802   * Fixed `SlowBuffer` support. Closes #584 [reported by tyrda01]
803   * Fixed .filename view engine option [reported by drudge]
804   * Fixed blog example
805   * Fixed `{req,res}.app` reference when mounting [Ben Weaver]
807 2.0.0rc / 2011-03-14
808 ==================
810   * Fixed; expose `HTTPSServer` constructor
811   * Fixed express(1) default test charset. Closes #579 [reported by secoif]
812   * Fixed; default charset to utf-8 instead of utf8 for lame IE [reported by NickP]
814 2.0.0beta3 / 2011-03-09
815 ==================
817   * Added support for `res.contentType()` literal
818     The original `res.contentType('.json')`,
819     `res.contentType('application/json')`, and `res.contentType('json')`
820     will work now.
821   * Added `res.render()` status option support back
822   * Added charset option for `res.render()`
823   * Added `.charset` support (via connect 1.0.4)
824   * Added view resolution hints when in development and a lookup fails
825   * Added layout lookup support relative to the page view.
826     For example while rendering `./views/user/index.jade` if you create
827     `./views/user/layout.jade` it will be used in favour of the root layout.
828   * Fixed `res.redirect()`. RFC states absolute url [reported by unlink]
829   * Fixed; default `res.send()` string charset to utf8
830   * Removed `Partial` constructor (not currently used)
832 2.0.0beta2 / 2011-03-07
833 ==================
835   * Added res.render() `.locals` support back to aid in migration process
836   * Fixed flash example
838 2.0.0beta / 2011-03-03
839 ==================
841   * Added HTTPS support
842   * Added `res.cookie()` maxAge support
843   * Added `req.header()` _Referrer_ / _Referer_ special-case, either works
844   * Added mount support for `res.redirect()`, now respects the mount-point
845   * Added `union()` util, taking place of `merge(clone())` combo
846   * Added stylus support to express(1) generated app
847   * Added secret to session middleware used in examples and generated app
848   * Added `res.local(name, val)` for progressive view locals
849   * Added default param support to `req.param(name, default)`
850   * Added `app.disabled()` and `app.enabled()`
851   * Added `app.register()` support for omitting leading ".", either works
852   * Added `res.partial()`, using the same interface as `partial()` within a view. Closes #539
853   * Added `app.param()` to map route params to async/sync logic
854   * Added; aliased `app.helpers()` as `app.locals()`. Closes #481
855   * Added extname with no leading "." support to `res.contentType()`
856   * Added `cache views` setting, defaulting to enabled in "production" env
857   * Added index file partial resolution, eg: partial('user') may try _views/user/index.jade_.
858   * Added `req.accepts()` support for extensions
859   * Changed; `res.download()` and `res.sendfile()` now utilize Connect's
860     static file server `connect.static.send()`.
861   * Changed; replaced `connect.utils.mime()` with npm _mime_ module
862   * Changed; allow `req.query` to be pre-defined (via middleware or other parent
863   * Changed view partial resolution, now relative to parent view
864   * Changed view engine signature. no longer `engine.render(str, options, callback)`, now `engine.compile(str, options) -> Function`, the returned function accepts `fn(locals)`.
865   * Fixed `req.param()` bug returning Array.prototype methods. Closes #552
866   * Fixed; using `Stream#pipe()` instead of `sys.pump()` in `res.sendfile()`
867   * Fixed; using _qs_ module instead of _querystring_
868   * Fixed; strip unsafe chars from jsonp callbacks
869   * Removed "stream threshold" setting
871 1.0.8 / 2011-03-01
872 ==================
874   * Allow `req.query` to be pre-defined (via middleware or other parent app)
875   * "connect": ">= 0.5.0 < 1.0.0". Closes #547
876   * Removed the long deprecated __EXPRESS_ENV__ support
878 1.0.7 / 2011-02-07
879 ==================
881   * Fixed `render()` setting inheritance.
882     Mounted apps would not inherit "view engine"
884 1.0.6 / 2011-02-07
885 ==================
887   * Fixed `view engine` setting bug when period is in dirname
889 1.0.5 / 2011-02-05
890 ==================
892   * Added secret to generated app `session()` call
894 1.0.4 / 2011-02-05
895 ==================
897   * Added `qs` dependency to _package.json_
898   * Fixed namespaced `require()`s for latest connect support
900 1.0.3 / 2011-01-13
901 ==================
903   * Remove unsafe characters from JSONP callback names [Ryan Grove]
905 1.0.2 / 2011-01-10
906 ==================
908   * Removed nested require, using `connect.router`
910 1.0.1 / 2010-12-29
911 ==================
913   * Fixed for middleware stacked via `createServer()`
914     previously the `foo` middleware passed to `createServer(foo)`
915     would not have access to Express methods such as `res.send()`
916     or props like `req.query` etc.
918 1.0.0 / 2010-11-16
919 ==================
921   * Added; deduce partial object names from the last segment.
922     For example by default `partial('forum/post', postObject)` will
923     give you the _post_ object, providing a meaningful default.
924   * Added http status code string representation to `res.redirect()` body
925   * Added; `res.redirect()` supporting _text/plain_ and _text/html_ via __Accept__.
926   * Added `req.is()` to aid in content negotiation
927   * Added partial local inheritance [suggested by masylum]. Closes #102
928     providing access to parent template locals.
929   * Added _-s, --session[s]_ flag to express(1) to add session related middleware
930   * Added _--template_ flag to express(1) to specify the
931     template engine to use.
932   * Added _--css_ flag to express(1) to specify the
933     stylesheet engine to use (or just plain css by default).
934   * Added `app.all()` support [thanks aheckmann]
935   * Added partial direct object support.
936     You may now `partial('user', user)` providing the "user" local,
937     vs previously `partial('user', { object: user })`.
938   * Added _route-separation_ example since many people question ways
939     to do this with CommonJS modules. Also view the _blog_ example for
940     an alternative.
941   * Performance; caching view path derived partial object names
942   * Fixed partial local inheritance precedence. [reported by Nick Poulden] Closes #454
943   * Fixed jsonp support; _text/javascript_ as per mailinglist discussion
945 1.0.0rc4 / 2010-10-14
946 ==================
948   * Added _NODE_ENV_ support, _EXPRESS_ENV_ is deprecated and will be removed in 1.0.0
949   * Added route-middleware support (very helpful, see the [docs](http://expressjs.com/guide.html#Route-Middleware))
950   * Added _jsonp callback_ setting to enable/disable jsonp autowrapping [Dav Glass]
951   * Added callback query check on response.send to autowrap JSON objects for simple webservice implementations [Dav Glass]
952   * Added `partial()` support for array-like collections. Closes #434
953   * Added support for swappable querystring parsers
954   * Added session usage docs. Closes #443
955   * Added dynamic helper caching. Closes #439 [suggested by maritz]
956   * Added authentication example
957   * Added basic Range support to `res.sendfile()` (and `res.download()` etc)
958   * Changed; `express(1)` generated app using 2 spaces instead of 4
959   * Default env to "development" again [aheckmann]
960   * Removed _context_ option is no more, use "scope"
961   * Fixed; exposing _./support_ libs to examples so they can run without installs
962   * Fixed mvc example
964 1.0.0rc3 / 2010-09-20
965 ==================
967   * Added confirmation for `express(1)` app generation. Closes #391
968   * Added extending of flash formatters via `app.flashFormatters`
969   * Added flash formatter support. Closes #411
970   * Added streaming support to `res.sendfile()` using `sys.pump()` when >= "stream threshold"
971   * Added _stream threshold_ setting for `res.sendfile()`
972   * Added `res.send()` __HEAD__ support
973   * Added `res.clearCookie()`
974   * Added `res.cookie()`
975   * Added `res.render()` headers option
976   * Added `res.redirect()` response bodies
977   * Added `res.render()` status option support. Closes #425 [thanks aheckmann]
978   * Fixed `res.sendfile()` responding with 403 on malicious path
979   * Fixed `res.download()` bug; when an error occurs remove _Content-Disposition_
980   * Fixed; mounted apps settings now inherit from parent app [aheckmann]
981   * Fixed; stripping Content-Length / Content-Type when 204
982   * Fixed `res.send()` 204. Closes #419
983   * Fixed multiple _Set-Cookie_ headers via `res.header()`. Closes #402
984   * Fixed bug messing with error handlers when `listenFD()` is called instead of `listen()`. [thanks guillermo]
987 1.0.0rc2 / 2010-08-17
988 ==================
990   * Added `app.register()` for template engine mapping. Closes #390
991   * Added `res.render()` callback support as second argument (no options)
992   * Added callback support to `res.download()`
993   * Added callback support for `res.sendfile()`
994   * Added support for middleware access via `express.middlewareName()` vs `connect.middlewareName()`
995   * Added "partials" setting to docs
996   * Added default expresso tests to `express(1)` generated app. Closes #384
997   * Fixed `res.sendfile()` error handling, defer via `next()`
998   * Fixed `res.render()` callback when a layout is used [thanks guillermo]
999   * Fixed; `make install` creating ~/.node_libraries when not present
1000   * Fixed issue preventing error handlers from being defined anywhere. Closes #387
1002 1.0.0rc / 2010-07-28
1003 ==================
1005   * Added mounted hook. Closes #369
1006   * Added connect dependency to _package.json_
1008   * Removed "reload views" setting and support code
1009     development env never caches, production always caches.
1011   * Removed _param_ in route callbacks, signature is now
1012     simply (req, res, next), previously (req, res, params, next).
1013     Use _req.params_ for path captures, _req.query_ for GET params.
1015   * Fixed "home" setting
1016   * Fixed middleware/router precedence issue. Closes #366
1017   * Fixed; _configure()_ callbacks called immediately. Closes #368
1019 1.0.0beta2 / 2010-07-23
1020 ==================
1022   * Added more examples
1023   * Added; exporting `Server` constructor
1024   * Added `Server#helpers()` for view locals
1025   * Added `Server#dynamicHelpers()` for dynamic view locals. Closes #349
1026   * Added support for absolute view paths
1027   * Added; _home_ setting defaults to `Server#route` for mounted apps. Closes #363
1028   * Added Guillermo Rauch to the contributor list
1029   * Added support for "as" for non-collection partials. Closes #341
1030   * Fixed _install.sh_, ensuring _~/.node_libraries_ exists. Closes #362 [thanks jf]
1031   * Fixed `res.render()` exceptions, now passed to `next()` when no callback is given [thanks guillermo]
1032   * Fixed instanceof `Array` checks, now `Array.isArray()`
1033   * Fixed express(1) expansion of public dirs. Closes #348
1034   * Fixed middleware precedence. Closes #345
1035   * Fixed view watcher, now async [thanks aheckmann]
1037 1.0.0beta / 2010-07-15
1038 ==================
1040   * Re-write
1041     - much faster
1042     - much lighter
1043     - Check [ExpressJS.com](http://expressjs.com) for migration guide and updated docs
1045 0.14.0 / 2010-06-15
1046 ==================
1048   * Utilize relative requires
1049   * Added Static bufferSize option [aheckmann]
1050   * Fixed caching of view and partial subdirectories [aheckmann]
1051   * Fixed mime.type() comments now that ".ext" is not supported
1052   * Updated haml submodule
1053   * Updated class submodule
1054   * Removed bin/express
1056 0.13.0 / 2010-06-01
1057 ==================
1059   * Added node v0.1.97 compatibility
1060   * Added support for deleting cookies via Request#cookie('key', null)
1061   * Updated haml submodule
1062   * Fixed not-found page, now using using charset utf-8
1063   * Fixed show-exceptions page, now using using charset utf-8
1064   * Fixed view support due to fs.readFile Buffers
1065   * Changed; mime.type() no longer accepts ".type" due to node extname() changes
1067 0.12.0 / 2010-05-22
1068 ==================
1070   * Added node v0.1.96 compatibility
1071   * Added view `helpers` export which act as additional local variables
1072   * Updated haml submodule
1073   * Changed ETag; removed inode, modified time only
1074   * Fixed LF to CRLF for setting multiple cookies
1075   * Fixed cookie complation; values are now urlencoded
1076   * Fixed cookies parsing; accepts quoted values and url escaped cookies
1078 0.11.0 / 2010-05-06
1079 ==================
1081   * Added support for layouts using different engines
1082     - this.render('page.html.haml', { layout: 'super-cool-layout.html.ejs' })
1083     - this.render('page.html.haml', { layout: 'foo' }) // assumes 'foo.html.haml'
1084     - this.render('page.html.haml', { layout: false }) // no layout
1085   * Updated ext submodule
1086   * Updated haml submodule
1087   * Fixed EJS partial support by passing along the context. Issue #307
1089 0.10.1 / 2010-05-03
1090 ==================
1092   * Fixed binary uploads.
1094 0.10.0 / 2010-04-30
1095 ==================
1097   * Added charset support via Request#charset (automatically assigned to 'UTF-8' when respond()'s
1098     encoding is set to 'utf8' or 'utf-8'.
1099   * Added "encoding" option to Request#render(). Closes #299
1100   * Added "dump exceptions" setting, which is enabled by default.
1101   * Added simple ejs template engine support
1102   * Added error reponse support for text/plain, application/json. Closes #297
1103   * Added callback function param to Request#error()
1104   * Added Request#sendHead()
1105   * Added Request#stream()
1106   * Added support for Request#respond(304, null) for empty response bodies
1107   * Added ETag support to Request#sendfile()
1108   * Added options to Request#sendfile(), passed to fs.createReadStream()
1109   * Added filename arg to Request#download()
1110   * Performance enhanced due to pre-reversing plugins so that plugins.reverse() is not called on each request
1111   * Performance enhanced by preventing several calls to toLowerCase() in Router#match()
1112   * Changed; Request#sendfile() now streams
1113   * Changed; Renamed Request#halt() to Request#respond(). Closes #289
1114   * Changed; Using sys.inspect() instead of JSON.encode() for error output
1115   * Changed; run() returns the http.Server instance. Closes #298
1116   * Changed; Defaulting Server#host to null (INADDR_ANY)
1117   * Changed; Logger "common" format scale of 0.4f
1118   * Removed Logger "request" format
1119   * Fixed; Catching ENOENT in view caching, preventing error when "views/partials" is not found
1120   * Fixed several issues with http client
1121   * Fixed Logger Content-Length output
1122   * Fixed bug preventing Opera from retaining the generated session id. Closes #292
1124 0.9.0 / 2010-04-14
1125 ==================
1127   * Added DSL level error() route support
1128   * Added DSL level notFound() route support
1129   * Added Request#error()
1130   * Added Request#notFound()
1131   * Added Request#render() callback function. Closes #258
1132   * Added "max upload size" setting
1133   * Added "magic" variables to collection partials (\_\_index\_\_, \_\_length\_\_, \_\_isFirst\_\_, \_\_isLast\_\_). Closes #254
1134   * Added [haml.js](http://github.com/visionmedia/haml.js) submodule; removed haml-js
1135   * Added callback function support to Request#halt() as 3rd/4th arg
1136   * Added preprocessing of route param wildcards using param(). Closes #251
1137   * Added view partial support (with collections etc)
1138   * Fixed bug preventing falsey params (such as ?page=0). Closes #286
1139   * Fixed setting of multiple cookies. Closes #199
1140   * Changed; view naming convention is now NAME.TYPE.ENGINE (for example page.html.haml)
1141   * Changed; session cookie is now httpOnly
1142   * Changed; Request is no longer global
1143   * Changed; Event is no longer global
1144   * Changed; "sys" module is no longer global
1145   * Changed; moved Request#download to Static plugin where it belongs
1146   * Changed; Request instance created before body parsing. Closes #262
1147   * Changed; Pre-caching views in memory when "cache view contents" is enabled. Closes #253
1148   * Changed; Pre-caching view partials in memory when "cache view partials" is enabled
1149   * Updated support to node --version 0.1.90
1150   * Updated dependencies
1151   * Removed set("session cookie") in favour of use(Session, { cookie: { ... }})
1152   * Removed utils.mixin(); use Object#mergeDeep()
1154 0.8.0 / 2010-03-19
1155 ==================
1157   * Added coffeescript example app. Closes #242
1158   * Changed; cache api now async friendly. Closes #240
1159   * Removed deprecated 'express/static' support. Use 'express/plugins/static'
1161 0.7.6 / 2010-03-19
1162 ==================
1164   * Added Request#isXHR. Closes #229
1165   * Added `make install` (for the executable)
1166   * Added `express` executable for setting up simple app templates
1167   * Added "GET /public/*" to Static plugin, defaulting to <root>/public
1168   * Added Static plugin
1169   * Fixed; Request#render() only calls cache.get() once
1170   * Fixed; Namespacing View caches with "view:"
1171   * Fixed; Namespacing Static caches with "static:"
1172   * Fixed; Both example apps now use the Static plugin
1173   * Fixed set("views"). Closes #239
1174   * Fixed missing space for combined log format
1175   * Deprecated Request#sendfile() and 'express/static'
1176   * Removed Server#running
1178 0.7.5 / 2010-03-16
1179 ==================
1181   * Added Request#flash() support without args, now returns all flashes
1182   * Updated ext submodule
1184 0.7.4 / 2010-03-16
1185 ==================
1187   * Fixed session reaper
1188   * Changed; class.js replacing js-oo Class implementation (quite a bit faster, no browser cruft)
1190 0.7.3 / 2010-03-16
1191 ==================
1193   * Added package.json
1194   * Fixed requiring of haml / sass due to kiwi removal
1196 0.7.2 / 2010-03-16
1197 ==================
1199   * Fixed GIT submodules (HAH!)
1201 0.7.1 / 2010-03-16
1202 ==================
1204   * Changed; Express now using submodules again until a PM is adopted
1205   * Changed; chat example using millisecond conversions from ext
1207 0.7.0 / 2010-03-15
1208 ==================
1210   * Added Request#pass() support (finds the next matching route, or the given path)
1211   * Added Logger plugin (default "common" format replaces CommonLogger)
1212   * Removed Profiler plugin
1213   * Removed CommonLogger plugin
1215 0.6.0 / 2010-03-11
1216 ==================
1218   * Added seed.yml for kiwi package management support
1219   * Added HTTP client query string support when method is GET. Closes #205
1221   * Added support for arbitrary view engines.
1222     For example "foo.engine.html" will now require('engine'),
1223     the exports from this module are cached after the first require().
1225   * Added async plugin support
1227   * Removed usage of RESTful route funcs as http client
1228     get() etc, use http.get() and friends
1230   * Removed custom exceptions
1232 0.5.0 / 2010-03-10
1233 ==================
1235   * Added ext dependency (library of js extensions)
1236   * Removed extname() / basename() utils. Use path module
1237   * Removed toArray() util. Use arguments.values
1238   * Removed escapeRegexp() util. Use RegExp.escape()
1239   * Removed process.mixin() dependency. Use utils.mixin()
1240   * Removed Collection
1241   * Removed ElementCollection
1242   * Shameless self promotion of ebook "Advanced JavaScript" (http://dev-mag.com)  ;)
1244 0.4.0 / 2010-02-11
1245 ==================
1247   * Added flash() example to sample upload app
1248   * Added high level restful http client module (express/http)
1249   * Changed; RESTful route functions double as HTTP clients. Closes #69
1250   * Changed; throwing error when routes are added at runtime
1251   * Changed; defaulting render() context to the current Request. Closes #197
1252   * Updated haml submodule
1254 0.3.0 / 2010-02-11
1255 ==================
1257   * Updated haml / sass submodules. Closes #200
1258   * Added flash message support. Closes #64
1259   * Added accepts() now allows multiple args. fixes #117
1260   * Added support for plugins to halt. Closes #189
1261   * Added alternate layout support. Closes #119
1262   * Removed Route#run(). Closes #188
1263   * Fixed broken specs due to use(Cookie) missing
1265 0.2.1 / 2010-02-05
1266 ==================
1268   * Added "plot" format option for Profiler (for gnuplot processing)
1269   * Added request number to Profiler plugin
1270   * Fixed binary encoding for multi-part file uploads, was previously defaulting to UTF8
1271   * Fixed issue with routes not firing when not files are present. Closes #184
1272   * Fixed process.Promise -> events.Promise
1274 0.2.0 / 2010-02-03
1275 ==================
1277   * Added parseParam() support for name[] etc. (allows for file inputs with "multiple" attr) Closes #180
1278   * Added Both Cache and Session option "reapInterval" may be "reapEvery". Closes #174
1279   * Added expiration support to cache api with reaper. Closes #133
1280   * Added cache Store.Memory#reap()
1281   * Added Cache; cache api now uses first class Cache instances
1282   * Added abstract session Store. Closes #172
1283   * Changed; cache Memory.Store#get() utilizing Collection
1284   * Renamed MemoryStore -> Store.Memory
1285   * Fixed use() of the same plugin several time will always use latest options. Closes #176
1287 0.1.0 / 2010-02-03
1288 ==================
1290   * Changed; Hooks (before / after) pass request as arg as well as evaluated in their context
1291   * Updated node support to 0.1.27 Closes #169
1292   * Updated dirname(__filename) -> __dirname
1293   * Updated libxmljs support to v0.2.0
1294   * Added session support with memory store / reaping
1295   * Added quick uid() helper
1296   * Added multi-part upload support
1297   * Added Sass.js support / submodule
1298   * Added production env caching view contents and static files
1299   * Added static file caching. Closes #136
1300   * Added cache plugin with memory stores
1301   * Added support to StaticFile so that it works with non-textual files.
1302   * Removed dirname() helper
1303   * Removed several globals (now their modules must be required)
1305 0.0.2 / 2010-01-10
1306 ==================
1308   * Added view benchmarks; currently haml vs ejs
1309   * Added Request#attachment() specs. Closes #116
1310   * Added use of node's parseQuery() util. Closes #123
1311   * Added `make init` for submodules
1312   * Updated Haml
1313   * Updated sample chat app to show messages on load
1314   * Updated libxmljs parseString -> parseHtmlString
1315   * Fixed `make init` to work with older versions of git
1316   * Fixed specs can now run independant specs for those who cant build deps. Closes #127
1317   * Fixed issues introduced by the node url module changes. Closes 126.
1318   * Fixed two assertions failing due to Collection#keys() returning strings
1319   * Fixed faulty Collection#toArray() spec due to keys() returning strings
1320   * Fixed `make test` now builds libxmljs.node before testing
1322 0.0.1 / 2010-01-03
1323 ==================
1325   * Initial release