Add new asyncio-based implementation.

Author: aaugustin

docs/reference/index.rst

@@ -26,6 +26,18 @@ clients concurrently.
    asyncio/server
    asyncio/client
 
+:mod:`asyncio` (new)
+--------------------
+
+This is a rewrite of the :mod:`asyncio` implementation. It will become the
+default implementation.
+
+.. toctree::
+   :titlesonly:
+
+   new-asyncio/server
+   new-asyncio/client
+
 :mod:`threading`
 ----------------
 

docs/reference/new-asyncio/client.rst

@@ -0,0 +1,51 @@
+Client (:mod:`asyncio` - new)
+=============================
+
+.. automodule:: websockets.asyncio.client
+
+Opening a connection
+--------------------
+
+.. autofunction:: connect
+    :async:
+
+.. autofunction:: unix_connect
+    :async:
+
+Using a connection
+------------------
+
+.. autoclass:: ClientConnection
+
+    .. automethod:: __aiter__
+
+    .. automethod:: recv
+
+    .. automethod:: recv_streaming
+
+    .. automethod:: send
+
+    .. automethod:: close
+
+    .. automethod:: ping
+
+    .. automethod:: pong
+
+    WebSocket connection objects also provide these attributes:
+
+    .. autoattribute:: id
+
+    .. autoattribute:: logger
+
+    .. autoproperty:: local_address
+
+    .. autoproperty:: remote_address
+
+    The following attributes are available after the opening handshake,
+    once the WebSocket connection is open:
+
+    .. autoattribute:: request
+
+    .. autoattribute:: response
+
+    .. autoproperty:: subprotocol

docs/reference/new-asyncio/common.rst

@@ -0,0 +1,41 @@
+:orphan:
+
+Both sides (:mod:`asyncio` - new)
+=================================
+
+.. automodule:: websockets.asyncio.connection
+
+.. autoclass:: Connection
+
+    .. automethod:: __aiter__
+
+    .. automethod:: recv
+
+    .. automethod:: recv_streaming
+
+    .. automethod:: send
+
+    .. automethod:: close
+
+    .. automethod:: ping
+
+    .. automethod:: pong
+
+    WebSocket connection objects also provide these attributes:
+
+    .. autoattribute:: id
+
+    .. autoattribute:: logger
+
+    .. autoproperty:: local_address
+
+    .. autoproperty:: remote_address
+
+    The following attributes are available after the opening handshake,
+    once the WebSocket connection is open:
+
+    .. autoattribute:: request
+
+    .. autoattribute:: response
+
+    .. autoproperty:: subprotocol

docs/reference/new-asyncio/server.rst

@@ -0,0 +1,62 @@
+Server (:mod:`asyncio` - new)
+=============================
+
+.. automodule:: websockets.asyncio.server
+
+.. Creating a server
+.. -----------------
+
+.. .. autofunction:: serve
+..     :async:
+
+.. .. autofunction:: unix_serve
+..     :async:
+
+.. Running a server
+.. ----------------
+
+.. .. autoclass:: WebSocketServer
+
+..     .. automethod:: serve_forever
+
+..     .. automethod:: shutdown
+
+..     .. automethod:: fileno
+
+Using a connection
+------------------
+
+.. autoclass:: ServerConnection
+
+    .. automethod:: __aiter__
+
+    .. automethod:: recv
+
+    .. automethod:: recv_streaming
+
+    .. automethod:: send
+
+    .. automethod:: close
+
+    .. automethod:: ping
+
+    .. automethod:: pong
+
+    WebSocket connection objects also provide these attributes:
+
+    .. autoattribute:: id
+
+    .. autoattribute:: logger
+
+    .. autoproperty:: local_address
+
+    .. autoproperty:: remote_address
+
+    The following attributes are available after the opening handshake,
+    once the WebSocket connection is open:
+
+    .. autoattribute:: request
+
+    .. autoattribute:: response
+
+    .. autoproperty:: subprotocol