Skip to content

Commit

Permalink
bpo-38242: Revert "bpo-36889: Merge asyncio streams (GH-13251)"
Browse files Browse the repository at this point in the history
  • Loading branch information
aeros authored and 1st1 committed Sep 30, 2019
1 parent fb4ae15 commit aae2233
Show file tree
Hide file tree
Showing 13 changed files with 381 additions and 2,755 deletions.
36 changes: 6 additions & 30 deletions Doc/library/asyncio-api-index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -132,47 +132,23 @@ High-level APIs to work with network IO.
:widths: 50 50
:class: full-width-table

* - ``await`` :func:`connect`
- Establish a TCP connection to send and receive data.

* - ``await`` :func:`open_connection`
- Establish a TCP connection. (Deprecated in favor of :func:`connect`)

* - ``await`` :func:`connect_unix`
- Establish a Unix socket connection to send and receive data.
- Establish a TCP connection.

* - ``await`` :func:`open_unix_connection`
- Establish a Unix socket connection. (Deprecated in favor of :func:`connect_unix`)

* - :class:`StreamServer`
- Start a TCP server.
- Establish a Unix socket connection.

* - ``await`` :func:`start_server`
- Start a TCP server. (Deprecated in favor of :class:`StreamServer`)

* - :class:`UnixStreamServer`
- Start a Unix socket server.
- Start a TCP server.

* - ``await`` :func:`start_unix_server`
- Start a Unix socket server. (Deprecated in favor of :class:`UnixStreamServer`)

* - :func:`connect_read_pipe`
- Establish a connection to :term:`file-like object <file object>` *pipe*
to receive data.

* - :func:`connect_write_pipe`
- Establish a connection to :term:`file-like object <file object>` *pipe*
to send data.

* - :class:`Stream`
- Stream is a single object combining APIs of :class:`StreamReader` and
:class:`StreamWriter`.
- Start a Unix socket server.

* - :class:`StreamReader`
- High-level async/await object to receive network data. (Deprecated in favor of :class:`Stream`)
- High-level async/await object to receive network data.

* - :class:`StreamWriter`
- High-level async/await object to send network data. (Deprecated in favor of :class:`Stream`)
- High-level async/await object to send network data.


.. rubric:: Examples
Expand Down
3 changes: 2 additions & 1 deletion Doc/library/asyncio-eventloop.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1637,7 +1637,8 @@ Wait until a file descriptor received some data using the
:meth:`loop.create_connection` method.

* Another similar :ref:`example <asyncio_example_create_connection-streams>`
using the high-level :func:`asyncio.connect` function and streams.
using the high-level :func:`asyncio.open_connection` function
and streams.


.. _asyncio_example_unix_signals:
Expand Down
4 changes: 2 additions & 2 deletions Doc/library/asyncio-protocol.rst
Original file line number Diff line number Diff line change
Expand Up @@ -809,7 +809,7 @@ data, and waits until the connection is closed::
.. seealso::

The :ref:`TCP echo client using streams <asyncio-tcp-echo-client-streams>`
example uses the high-level :func:`asyncio.connect` function.
example uses the high-level :func:`asyncio.open_connection` function.


.. _asyncio-udp-echo-server-protocol:
Expand Down Expand Up @@ -978,7 +978,7 @@ Wait until a socket receives data using the

The :ref:`register an open socket to wait for data using streams
<asyncio_example_create_connection-streams>` example uses high-level streams
created by the :func:`asyncio.connect` function in a coroutine.
created by the :func:`open_connection` function in a coroutine.

.. _asyncio_example_subprocess_proto:

Expand Down
Loading

0 comments on commit aae2233

Please sign in to comment.