From 041ff9be13546a11c34ffc1392b416aaed10608b Mon Sep 17 00:00:00 2001 From: Victor Stinner Date: Tue, 28 Jan 2014 02:24:22 +0100 Subject: asyncio doc: list Windows and Mac OS X limitations and explain how to work around them --- Doc/library/asyncio-eventloop.rst | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst index f589b20..a246e8c 100644 --- a/Doc/library/asyncio-eventloop.rst +++ b/Doc/library/asyncio-eventloop.rst @@ -286,6 +286,19 @@ Running subprocesses 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 @@ Run subprocesses asynchronously using the :mod:`subprocess` module. 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 @@ Run subprocesses asynchronously using the :mod:`subprocess` module. 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. -- cgit v0.12