From: homm Date: Thu, 12 Sep 2013 06:20:47 +0000 (+0400) Subject: remove extra mention of dangerous `r.raw` X-Git-Tag: v2.0~10^2~3 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=10b6d7794573b8099d944a5acc00d3b316ef12bc;p=services%2Fpython-requests.git remove extra mention of dangerous `r.raw` --- 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