[Python-checkins] cpython: asyncio doc: add an client example using streams

victor.stinner python-checkins at python.org
Thu Jan 23 11:25:57 CET 2014


http://hg.python.org/cpython/rev/8fe59931b64d
changeset:   88652:8fe59931b64d
user:        Victor Stinner <victor.stinner at gmail.com>
date:        Thu Jan 23 11:25:48 2014 +0100
summary:
  asyncio doc: add an client example using streams

files:
  Doc/library/asyncio-stream.rst |  35 ++++++++++++++++++++++
  1 files changed, 35 insertions(+), 0 deletions(-)


diff --git a/Doc/library/asyncio-stream.rst b/Doc/library/asyncio-stream.rst
--- a/Doc/library/asyncio-stream.rst
+++ b/Doc/library/asyncio-stream.rst
@@ -205,3 +205,38 @@
 
        XXX
 
+
+Example
+=======
+
+Simple example querying HTTP headers of the URL passed on the command line::
+
+    import asyncio
+    import urllib.parse
+    import sys
+
+    @asyncio.coroutine
+    def print_http_headers(url):
+        url = urllib.parse.urlsplit(url)
+        reader, writer = yield from asyncio.open_connection(url.hostname, 80)
+        query = ('HEAD {url.path} HTTP/1.0\r\n'
+                 'Host: {url.hostname}\r\n'
+                 '\r\n').format(url=url)
+        writer.write(query.encode('latin-1'))
+        while True:
+            line = yield from reader.readline()
+            if not line:
+                break
+            line = line.decode('latin1').rstrip()
+            if line:
+                print('HTTP header> %s' % line)
+
+    url = sys.argv[1]
+    loop = asyncio.get_event_loop()
+    task = asyncio.async(print_http_headers(url))
+    loop.run_until_complete(task)
+
+Usage::
+
+    python example.py http://example.com/path/page.html
+

-- 
Repository URL: http://hg.python.org/cpython


More information about the Python-checkins mailing list