39 lines
1.5 KiB
ReStructuredText
39 lines
1.5 KiB
ReStructuredText
``tornado.platform.asyncio`` --- Bridge between ``asyncio`` and Tornado
|
|
=======================================================================
|
|
|
|
.. module:: tornado.platform.asyncio
|
|
|
|
.. versionadded:: 3.2
|
|
|
|
This module integrates Tornado with the ``asyncio`` module introduced
|
|
in Python 3.4 (and available `as a separate download
|
|
<https://pypi.python.org/pypi/asyncio>`_ for Python 3.3). This makes
|
|
it possible to combine the two libraries on the same event loop.
|
|
|
|
Most applications should use `AsyncIOMainLoop` to run Tornado on the
|
|
default ``asyncio`` event loop. Applications that need to run event
|
|
loops on multiple threads may use `AsyncIOLoop` to create multiple
|
|
loops.
|
|
|
|
.. py:class:: AsyncIOMainLoop
|
|
|
|
``AsyncIOMainLoop`` creates an `.IOLoop` that corresponds to the
|
|
current ``asyncio`` event loop (i.e. the one returned by
|
|
``asyncio.get_event_loop()``). Recommended usage::
|
|
|
|
from tornado.platform.asyncio import AsyncIOMainLoop
|
|
import asyncio
|
|
AsyncIOMainLoop().install()
|
|
asyncio.get_event_loop().run_forever()
|
|
|
|
.. py:class:: AsyncIOLoop
|
|
|
|
``AsyncIOLoop`` is an `.IOLoop` that runs on an ``asyncio`` event loop.
|
|
This class follows the usual Tornado semantics for creating new
|
|
``IOLoops``; these loops are not necessarily related to the
|
|
``asyncio`` default event loop. Recommended usage::
|
|
|
|
from tornado.ioloop import IOLoop
|
|
IOLoop.configure('tornado.platform.asyncio.AsyncIOLoop')
|
|
IOLoop.instance().start()
|