From 2c153c155659e5be198fa1959907d80b6c5de67c Mon Sep 17 00:00:00 2001
From: Jason Emerick <jemerick@gmail.com>
Date: Mon, 19 Dec 2011 11:45:32 -0500
Subject: [PATCH] Add Twitter Streaming API example to Advanced Usage docs

---
 docs/user/advanced.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/user/advanced.rst b/docs/user/advanced.rst
index 099dabd..4b3430f 100644
--- a/docs/user/advanced.rst
+++ b/docs/user/advanced.rst
@@ -243,6 +243,27 @@ Then, we can make a request using our Pizza Auth::
     <Response [200]>
 
 
+Streaming Requests
+------------------
+
+With ``requests.Response.iter_lines()`` you can easily iterate over streaming 
+APIs such as the `Twitter Streaming API <https://dev.twitter.com/docs/streaming-api>`_.
+
+To use the Twitter Streaming API to track the keyword "requests":
+
+::
+
+    import requests
+    import json
+
+    r = requests.post('https://stream.twitter.com/1/statuses/filter.json',
+        data={'track': 'requests'}, auth=('username', 'password'))
+
+    for line in r.iter_lines():
+	    if line: # filter out keep-alive new lines
+		    print json.loads(line)
+
+
 Verbose Logging
 ---------------
 
-- 
2.7.4