Add asyncio & threading client & server examples.

They're convenient to tweak to reproduce issues.

Author: aaugustin

example/asyncio/client.py

@@ -0,0 +1,22 @@
+#!/usr/bin/env python
+
+"""Client example using the asyncio API."""
+
+import asyncio
+
+from websockets.asyncio.client import connect
+
+
+async def hello():
+    async with connect("ws://localhost:8765") as websocket:
+        name = input("What's your name? ")
+
+        await websocket.send(name)
+        print(f">>> {name}")
+
+        greeting = await websocket.recv()
+        print(f"<<< {greeting}")
+
+
+if __name__ == "__main__":
+    asyncio.run(hello())

example/asyncio/server.py

@@ -0,0 +1,25 @@
+#!/usr/bin/env python
+
+"""Server example using the asyncio API."""
+
+import asyncio
+from websockets.asyncio.server import serve
+
+
+async def hello(websocket):
+    name = await websocket.recv()
+    print(f"<<< {name}")
+
+    greeting = f"Hello {name}!"
+
+    await websocket.send(greeting)
+    print(f">>> {greeting}")
+
+
+async def main():
+    async with serve(hello, "localhost", 8765) as server:
+        await server.serve_forever()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

example/sync/client.py

@@ -0,0 +1,20 @@
+#!/usr/bin/env python
+
+"""Client example using the threading API."""
+
+from websockets.sync.client import connect
+
+
+def hello():
+    with connect("ws://localhost:8765") as websocket:
+        name = input("What's your name? ")
+
+        websocket.send(name)
+        print(f">>> {name}")
+
+        greeting = websocket.recv()
+        print(f"<<< {greeting}")
+
+
+if __name__ == "__main__":
+    hello()

example/sync/server.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python
+
+"""Server example using the threading API."""
+
+from websockets.sync.server import serve
+
+
+def hello(websocket):
+    name = websocket.recv()
+    print(f"<<< {name}")
+
+    greeting = f"Hello {name}!"
+
+    websocket.send(greeting)
+    print(f">>> {greeting}")
+
+
+def main():
+    with serve(hello, "localhost", 8765) as server:
+        server.serve_forever()
+
+
+if __name__ == "__main__":
+    main()