From 10b6d7794573b8099d944a5acc00d3b316ef12bc Mon Sep 17 00:00:00 2001 From: homm Date: Thu, 12 Sep 2013 10:20:47 +0400 Subject: [PATCH] remove extra mention of dangerous `r.raw` --- docs/api.rst | 9 +++++---- docs/user/advanced.rst | 2 +- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/api.rst b/docs/api.rst index a1c2cb9..12ae8a8 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -147,13 +147,14 @@ API Changes * The parameter for streaming requests was changed from ``prefetch`` to ``stream`` and the logic was inverted. In addition, ``stream`` is now - required for raw response reading. + required for chunked response reading. :: # in 0.x, passing prefetch=False would accomplish the same thing r = requests.get('https://github.com/timeline.json', stream=True) - r.raw.read(10) + for chunk in r.iter_content(8192): + ... * The ``config`` parameter to the requests method has been removed. Some of these options are now configured on a ``Session`` such as keep-alive and @@ -170,13 +171,13 @@ API Changes # the only thing missing will be the response.body which is not logged. import httplib httplib.HTTPConnection.debuglevel = 1 - + logging.basicConfig() # you need to initialize logging, otherwise you will not see anything from requests logging.getLogger().setLevel(logging.DEBUG) requests_log = logging.getLogger("requests.packages.urllib3") requests_log.setLevel(logging.DEBUG) requests_log.propagate = True - + requests.get('http://httpbin.org/headers') diff --git a/docs/user/advanced.rst b/docs/user/advanced.rst index 3665c64..5a8b9b2 100644 --- a/docs/user/advanced.rst +++ b/docs/user/advanced.rst @@ -161,7 +161,7 @@ At this point only the response headers have been downloaded and the connection content = r.content ... -You can further control the workflow by use of the :class:`Response.iter_content` and :class:`Response.iter_lines` methods, or reading from the underlying urllib3 :class:`urllib3.HTTPResponse` at :class:`Response.raw`. +You can further control the workflow by use of the :class:`Response.iter_content` and :class:`Response.iter_lines` methods. Keep-Alive -- 2.7.4