Kaydet (Commit) 4b4f9ebf authored tarafından Victor Stinner's avatar Victor Stinner

asyncio doc: add a "Coroutines and protocols" section

üst 1374bd41
...@@ -403,6 +403,18 @@ buffer size reaches the low-water mark. ...@@ -403,6 +403,18 @@ buffer size reaches the low-water mark.
mark is zero. 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 Server
------ ------
......
.. currentmodule:: asyncio .. currentmodule:: asyncio
.. _streams:
++++++++++++++++++++++++ ++++++++++++++++++++++++
Streams (high-level API) Streams (high-level API)
++++++++++++++++++++++++ ++++++++++++++++++++++++
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment