tornado/docs/releases/v2.3.0.rst

What's new in Tornado 2.3
=========================

May 31, 2012
------------

HTTP clients
~~~~~~~~~~~~

* `tornado.httpclient.HTTPClient` now supports the same constructor
  keyword arguments as `.AsyncHTTPClient`.
* The ``max_clients`` keyword argument to `.AsyncHTTPClient.configure` now works.
* ``tornado.simple_httpclient`` now supports the ``OPTIONS`` and ``PATCH``
  HTTP methods.
* ``tornado.simple_httpclient`` is better about closing its sockets
  instead of leaving them for garbage collection.
* ``tornado.simple_httpclient`` correctly verifies SSL certificates for
  URLs containing IPv6 literals (This bug affected Python 2.5 and 2.6).
* ``tornado.simple_httpclient`` no longer includes basic auth credentials
  in the ``Host`` header when those credentials are extracted from the URL.
* ``tornado.simple_httpclient`` no longer modifies the caller-supplied header
  dictionary, which caused problems when following redirects.
* ``tornado.curl_httpclient`` now supports client SSL certificates (using
  the same ``client_cert`` and ``client_key`` arguments as
  ``tornado.simple_httpclient``)

HTTP Server
~~~~~~~~~~~

* `.HTTPServer` now works correctly with paths starting with ``//``
* ``HTTPHeaders.copy`` (inherited from `dict.copy`) now works correctly.
* ``HTTPConnection.address`` is now always the socket address, even for non-IP
  sockets.  ``HTTPRequest.remote_ip`` is still always an IP-style address
  (fake data is used for non-IP sockets)
* Extra data at the end of multipart form bodies is now ignored, which fixes
  a compatibility problem with an iOS HTTP client library.


``IOLoop`` and ``IOStream``
~~~~~~~~~~~~~~~~~~~~~~~~~~~

* `.IOStream` now has an ``error`` attribute that can be used to determine
  why a socket was closed.
* ``tornado.iostream.IOStream.read_until`` and ``read_until_regex`` are much
  faster with large input.
* ``IOStream.write`` performs better when given very large strings.
* `.IOLoop.instance()` is now thread-safe.

``tornado.options``
~~~~~~~~~~~~~~~~~~~

* `tornado.options` options with ``multiple=True`` that are set more than
  once now overwrite rather than append.  This makes it possible to override
  values set in ``parse_config_file`` with ``parse_command_line``.
* `tornado.options` ``--help`` output is now prettier.
* `tornado.options.options` now supports attribute assignment.

``tornado.template``
~~~~~~~~~~~~~~~~~~~~

* Template files containing non-ASCII (utf8) characters now work on Python 3
  regardless of the locale environment variables.
* Templates now support ``else`` clauses in
  ``try``/``except``/``finally``/``else`` blocks.

``tornado.web``
~~~~~~~~~~~~~~~

* `tornado.web.RequestHandler` now supports the ``PATCH`` HTTP method.
  Note that this means any existing methods named ``patch`` in
  ``RequestHandler`` subclasses will need to be renamed.
* `tornado.web.addslash` and ``removeslash`` decorators now send permanent
  redirects (301) instead of temporary (302).
* `.RequestHandler.flush` now invokes its callback whether there was any data
  to flush or not.
* Repeated calls to `.RequestHandler.set_cookie` with the same name now
  overwrite the previous cookie instead of producing additional copies.
* ``tornado.web.OutputTransform.transform_first_chunk`` now takes and returns
  a status code in addition to the headers and chunk.  This is a
  backwards-incompatible change to an interface that was never technically
  private, but was not included in the documentation and does not appear
  to have been used outside Tornado itself.
* Fixed a bug on python versions before 2.6.5 when `.URLSpec` regexes
  are constructed from unicode strings and keyword arguments are extracted.
* The ``reverse_url`` function in the template namespace now comes from
  the `.RequestHandler` rather than the `.Application`.  (Unless overridden,
  `.RequestHandler.reverse_url` is just an alias for the `.Application`
  method).
* The ``Etag`` header is now returned on 304 responses to an ``If-None-Match``
  request, improving compatibility with some caches.
* `tornado.web` will no longer produce responses with status code 304
  that also have entity headers such as ``Content-Length``.

Other modules
~~~~~~~~~~~~~

* `tornado.auth.FacebookGraphMixin` no longer sends ``post_args`` redundantly
  in the url.
* The ``extra_params`` argument to `tornado.escape.linkify` may now be
  a callable, to allow parameters to be chosen separately for each link.
* `tornado.gen` no longer leaks ``StackContexts`` when a ``@gen.engine`` wrapped
  function is called repeatedly.
* `tornado.locale.get_supported_locales` no longer takes a meaningless
  ``cls`` argument.
* `.StackContext` instances now have a deactivation callback that can be
  used to prevent further propagation.
* `tornado.testing.AsyncTestCase.wait` now resets its timeout on each call.
* `tornado.wsgi.WSGIApplication` now parses arguments correctly on Python 3.
* Exception handling on Python 3 has been improved; previously some exceptions
  such as `UnicodeDecodeError` would generate ``TypeErrors``