tornado/docs/releases/v2.3.0.rst

111 lines
4.9 KiB
ReStructuredText

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``