[Python-checkins] cpython: asyncio doc: list Windows and Mac OS X limitations and explain how to work

Tue Jan 28 02:28:37 CET 2014

http://hg.python.org/cpython/rev/403565c0e5de
changeset: 88787:403565c0e5de
user: Victor Stinner <victor.stinner at gmail.com>
date: Tue Jan 28 02:24:22 2014 +0100
summary:
 asyncio doc: list Windows and Mac OS X limitations and explain how to work
around them
files:
 Doc/library/asyncio-eventloop.rst | 17 +++++++++++++----
 1 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst
--- a/Doc/library/asyncio-eventloop.rst
+++ b/Doc/library/asyncio-eventloop.rst
@@ -286,6 +286,19 @@
 
 Run subprocesses asynchronously using the :mod:`subprocess` module.
 
+.. note::
+
+ On Windows, the default event loop uses
+ :class:`selectors.SelectSelector` which only supports sockets. The
+ :class:`ProactorEventLoop` should be used instead.
+
+.. note::
+
+ On Mac OS X older than Maverick (10.9), :class:`selectors.KqueueSelector`
+ does not support character devices like PTY, whereas it is used by the
+ default event loop. The :class:`SelectorEventLoop` can be used with
+ :class:`SelectSelector` to handle character devices.
+
 .. method:: BaseEventLoop.subprocess_exec(protocol_factory, \*args, stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, universal_newlines=False, shell=False, bufsize=0, \*\*kwargs)
 
 XXX
@@ -294,8 +307,6 @@
 
 See the constructor of the :class:`subprocess.Popen` class for parameters.
 
- Availability: Unix.
-
 .. method:: BaseEventLoop.subprocess_shell(protocol_factory, cmd, \*, stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, universal_newlines=False, shell=True, bufsize=0, \*\*kwargs)
 
 XXX
@@ -304,8 +315,6 @@
 
 See the constructor of the :class:`subprocess.Popen` class for parameters.
 
- Availability: Unix.
-
 .. method:: BaseEventLoop.connect_read_pipe(protocol_factory, pipe)
 
 Register read pipe in eventloop.
-- 
Repository URL: http://hg.python.org/cpython
