Skip to content

Commit aa879d1

Browse files
committed
docs: Add notice about WindowsSelectorEventLoop on py38
Fixes tornadoweb#2608
1 parent dbc00f9 commit aa879d1

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

docs/index.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -120,6 +120,13 @@ is limited (Even though Tornado is built on ``asyncio``, which
120120
supports Windows, Tornado does not use the APIs that are necessary for
121121
scalable networking on Windows).
122122

123+
On Windows, Tornado requires the ``WindowsSelectorEventLoop``. This is
124+
the default in Python 3.7 and older, but Python 3.8 defaults to an
125+
event loop that is not compatible with Tornado. Applications that use
126+
Tornado on Windows with Python 3.8 must call
127+
``asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())``
128+
at the beginning of their ``main`` file/function.
129+
123130
Documentation
124131
-------------
125132

0 commit comments

Comments
 (0)