What’s new in Tornado 3.2¶
Jan 14, 2014¶
Installation¶
- Tornado now depends on the backports.ssl_match_hostname when running on Python 2. This will be installed automatically when using pip or easy_install
- Tornado now includes an optional C extension module, which greatly improves performance of websockets. This extension will be built automatically if a C compiler is found at install time.
New modules¶
- The tornado.platform.asyncio module provides integration with the asyncio module introduced in Python 3.4 (also available for Python 3.3 with pip install asyncio).
tornado.auth¶
- Added GoogleOAuth2Mixin support authentication to Google services with OAuth 2 instead of OpenID and OAuth 1.
- FacebookGraphMixin has been updated to use the current Facebook login URL, which saves a redirect.
tornado.concurrent¶
- TracebackFuture now accepts a timeout keyword argument (although it is still incorrect to use a non-zero timeout in non-blocking code).
tornado.curl_httpclient¶
- tornado.curl_httpclient now works on Python 3 with the soon-to-be-released pycurl 7.19.3, which will officially support Python 3 for the first time. Note that there are some unofficial Python 3 ports of pycurl (Ubuntu has included one for its past several releases); these are not supported for use with Tornado.
tornado.escape¶
- xhtml_escape now escapes apostrophes as well.
- tornado.escape.utf8, to_unicode, and native_str now raise TypeError instead of AssertionError when given an invalid value.
tornado.gen¶
- Coroutines may now yield dicts in addition to lists to wait for multiple tasks in parallel.
- Improved performance of tornado.gen when yielding a Future that is already done.
tornado.httpclient¶
- tornado.httpclient.HTTPRequest now uses property setters so that setting attributes after construction applies the same conversions as __init__ (e.g. converting the body attribute to bytes).
tornado.httpserver¶
- Malformed x-www-form-urlencoded request bodies will now log a warning and continue instead of causing the request to fail (similar to the existing handling of malformed multipart/form-data bodies. This is done mainly because some libraries send this content type by default even when the data is not form-encoded.
- Fix some error messages for unix sockets (and other non-IP sockets)
tornado.ioloop¶
- IOLoop now uses handle_callback_exception consistently for error logging.
- IOLoop now frees callback objects earlier, reducing memory usage while idle.
- IOLoop will no longer call logging.basicConfig if there is a handler defined for the root logger or for the tornado or tornado.application loggers (previously it only looked at the root logger).
tornado.iostream¶
- IOStream now recognizes ECONNABORTED error codes in more places (which was mainly an issue on Windows).
- IOStream now frees memory earlier if a connection is closed while there is data in the write buffer.
- PipeIOStream now handles EAGAIN error codes correctly.
- SSLIOStream now initiates the SSL handshake automatically without waiting for the application to try and read or write to the connection.
- Swallow a spurious exception from set_nodelay when a connection has been reset.
tornado.locale¶
- Locale.format_date no longer forces the use of absolute dates in Russian.
tornado.log¶
- Fix an error from tornado.log.enable_pretty_logging when sys.stderr does not have an isatty method.
- tornado.log.LogFormatter now accepts keyword arguments fmt and datefmt.
tornado.netutil¶
- is_valid_ip (and therefore HTTPRequest.remote_ip) now rejects empty strings.
- Synchronously using ThreadedResolver at import time to resolve a unicode hostname no longer deadlocks.
tornado.platform.twisted¶
- TwistedResolver now has better error handling.
tornado.process¶
- Subprocess no longer leaks file descriptors if subprocess.Popen fails.
tornado.simple_httpclient¶
- simple_httpclient now applies the connect_timeout to requests that are queued and have not yet started.
- On Python 2.6, simple_httpclient now uses TLSv1 instead of SSLv3.
- simple_httpclient now enforces the connect timeout during DNS resolution.
- The embedded ca-certificates.crt file has been updated with the current Mozilla CA list.
tornado.web¶
- StaticFileHandler no longer fails if the client requests a Range that is larger than the entire file (Facebook has a crawler that does this).
- RequestHandler.on_connection_close now works correctly on subsequent requests of a keep-alive connection.
- New application setting default_handler_class can be used to easily set up custom 404 pages.
- New application settings autoreload, compiled_template_cache, static_hash_cache, and serve_traceback can be used to control individual aspects of debug mode.
- New methods RequestHandler.get_query_argument and RequestHandler.get_body_argument and new attributes HTTPRequest.query_arguments and HTTPRequest.body_arguments allow access to arguments without intermingling those from the query string with those from the request body.
- RequestHandler.decode_argument and related methods now raise an HTTPError(400) instead of UnicodeDecodeError when the argument could not be decoded.
- RequestHandler.clear_all_cookies now accepts domain and path arguments, just like clear_cookie.
- It is now possible to specify handlers by name when using the URLSpec class.
- Application now accepts 4-tuples to specify the name parameter (which previously required constructing a URLSpec object instead of a tuple).
- Fixed an incorrect error message when handler methods return a value other than None or a Future.
- Exceptions will no longer be logged twice when using both @asynchronous and @gen.coroutine
tornado.websocket¶
- WebSocketHandler.write_message now raises WebSocketClosedError instead of AttributeError when the connection has been closed.
- websocket_connect now accepts preconstructed HTTPRequest objects.
- Fix a bug with WebSocketHandler when used with some proxies that unconditionally modify the Connection header.
- websocket_connect now returns an error immediately for refused connections instead of waiting for the timeout.
- WebSocketClientConnection now has a close method.
tornado.wsgi¶
- WSGIContainer now calls the iterable’s close() method even if an error is raised, in compliance with the spec.