What’s new in Tornado 6.2.0¶
Jul 3, 2022¶
Python 3.10 has begun the process of significant changes to the APIs for managing the event loop. Calls to methods such as
asyncio.get_event_loopmay now raise
DeprecationWarningif no event loop is running. This has significant impact on the patterns for initializing applications, and in particular invalidates patterns that have long been the norm in Tornado’s documentation and actual usage. In the future (with some as-yet-unspecified future version of Python), the old APIs will be removed. The new recommended pattern is to start the event loop with
asyncio.run. More detailed migration guides will be coming in the future.
IOLoopconstructor is deprecated unless the
make_current=Falseargument is used. Use
IOLoop.currentwhen the loop is already running instead.
AsyncHTTPTestCase) are deprecated. Use
TCPServer.startis deprecated. See
TCPServerdocs for supported alternatives.
AnyThreadEventLoopPolicyis deprecated. This class controls the creation of the “current” event loop so it will be removed when that concept is no longer supported.
IOLoop.clear_currentare deprecated. In the future the concept of a “current” event loop as distinct from one that is currently running will be removed.
CaresResolverare deprecated and will be removed in Tornado 7.0.
The minimum supported Python version is now 3.7.
Wheels are now published with the Python stable ABI (
abi3) for compatibility across versions of Python.
SSL certificate verification and hostname checks are now enabled by default in more places (primarily in client-side usage of
Various improvements to type hints throughout the package.
CI has moved from Travis and Appveyor to Github Actions.
Fixed a bug in which
WaitIterator.current_indexcould be incorrect.
tornado.gen.TimeoutErroris now an alias for
max_body_sizemay now be set to zero to disallow a non-empty body.
Content-Encoding: gzipis now recognized case-insensitively.
curl_httpclientnow supports non-ASCII (ISO-8859-1) header values, same as
PeriodicCallbacknow understands coroutines and will not start multiple copies if a previous invocation runs too long.
datetime.timedeltaobjects in addition to numbers of milliseconds.
Avoid logging “Event loop is closed” during shutdown-related race conditions.
Tornado no longer calls
logging.basicConfigwhen starting an IOLoop; this has been unnecessary since Python 3.2 added a logger of last resort.
IOLoopconstructor now accepts an
asyncio_loopkeyword argument to initialize with a specfied asyncio event loop.
It is now possible to construct an
IOLoopon one thread (with
make_current=False) and start it on a different thread.
SSLIOStreamnow supports reading more than 2GB at a time.
IOStream.writenow supports typed
load_gettext_translationsno longer logs errors when language directories exist but do not contain the expected file.
is_valid_ipno longer raises exceptions when the input is too long.
The default resolver now uses the same methods (and thread pool) as
TCPServer.listennow supports more arguments to pass through to
bind_unused_portnow takes an optional
Wrapped test methods now include the
When using a custom
reset()method is now called on this subclass instead of the base class.
Improved handling of the
Application.listennow supports more arguments to pass through to
dictarguments for consistency with
WebSocketClientConnection.write_messagenow raises an exception as documented if the connection is already closed.