asyncio doc: add a "Coroutines and protocols" section

This commit is contained in:
Victor Stinner 2014-01-24 17:33:20 +01:00
parent 1374bd41b1
commit 4b4f9ebfea
2 changed files with 14 additions and 0 deletions

View File

@ -403,6 +403,18 @@ buffer size reaches the low-water mark.
mark is zero.
Coroutines and protocols
------------------------
Coroutines can be scheduled in a protocol method using :func:`async`, but there
is not guarantee on the execution order. Protocols are not aware of coroutines
created in protocol methods and so will not wait for them.
To have a reliable execution order, use :ref:`stream objects <streams>` in a
coroutine with ``yield from``. For example, the :meth:`StreamWriter.drain`
coroutine can be used to wait until the write buffer is flushed.
Server
------

View File

@ -1,5 +1,7 @@
.. currentmodule:: asyncio
.. _streams:
++++++++++++++++++++++++
Streams (high-level API)
++++++++++++++++++++++++