asyncio doc: list limitations to run subprocesses from different threads

This commit is contained in:
Victor Stinner 2015-01-09 01:32:02 +01:00
parent 15cc678d89
commit 399c59d7bd
2 changed files with 24 additions and 0 deletions

View File

@ -74,6 +74,11 @@ the event loop.
The :ref:`Synchronization primitives <asyncio-sync>` section describes ways
to synchronize tasks.
The :ref:`Subprocess and threads <asyncio-subprocess-threads>` section lists
asyncio limitations to run subprocesses from different threads.
.. _asyncio-handle-blocking:

View File

@ -297,6 +297,25 @@ Process
``N`` (Unix only).
.. _asyncio-subprocess-threads:
Subprocess and threads
======================
asyncio supports running subprocesses from different threads, but there
are limits:
* An event loop must run in the main thread
* The child watcher must be instantiated in the main thread, before executing
subprocesses from other threads. Call the :func:`get_child_watcher`
function in the main thread to instantiate the child watcher.
.. seealso::
The :ref:`Concurrency and multithreading in asyncio
<asyncio-multithreading>` section.
Subprocess examples
===================