�
u�-ec @@ sa d d l m Z d d l m Z d d l Z d d l Z d d l Z d d l m Z d d l m
Z d d l m
Z
d d l m Z m Z m Z m Z m Z m Z m Z d d l m Z m Z m Z d d
l m Z d d l m Z m Z d d l! m" Z" m# Z# e j$ e% � Z& d
e' f d � � YZ( d e' f d � � YZ) d � Z* d e j+ f d � � YZ, d S( i ( t absolute_import( t contextmanagerN( t timeout( t errori ( t HTTPHeaderDict( t BodyNotHttplibCompatiblet
ProtocolErrort DecodeErrort ReadTimeoutErrort ResponseNotChunkedt IncompleteReadt
InvalidHeader( t string_typest binary_typet PY3( t http_client( t
HTTPExceptiont BaseSSLError( t is_fp_closedt is_response_to_headt DeflateDecoderc B@ s# e Z d � Z d � Z d � Z RS( c C@ s( t | _ t � | _ t j � | _ d S( N( t Truet
_first_tryR
t _datat zlibt
decompressobjt _obj( t self( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt __init__ s c C@ s t | j | � S( N( t getattrR ( R t name( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt __getattr__ s c C@ s� | s
| S| j s# | j j | � S| j | 7_ y5 | j j | � } | rb t | _ d | _ n | SWnT t j k
r� t | _ t j t j � | _ z | j | j � SWd d | _ Xn Xd S( N(
R R t
decompressR t Falset NoneR R R t MAX_WBITS( R t datat decompressed( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR s" ( t __name__t
__module__R R R ( ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR s t GzipDecoderc B@ s# e Z d � Z d � Z d � Z RS( c C@ s t j d t j � | _ d S( Ni ( R R R# R ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR 9 s c C@ s t | j | � S( N( R R ( R R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR < s c C@ s | s
| S| j j | � S( N( R R ( R R$ ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR ? s ( R& R' R R R ( ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR( 7 s c C@ s | d k r t � St � S( Nt gzip( R( R ( t mode( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt _get_decoderE s t HTTPResponsec B@ s� e Z d Z d d g Z d d d d d g Z d d' d d d' d e e d' d' d' d' e d' d
� Z d � Z d � Z
e d
� � Z e d � � Z
d � Z d � Z d � Z d � Z d � Z e d � � Z d' d' e d � Z d( d' d � Z e d � � Z d � Z d' d � Z d � Z d � Z e d � � Z d � Z d � Z d! � Z d" � Z! d# � Z" d$ � Z# d% � Z$ d' d' d& � Z% RS() s
HTTP Response container.
Backwards-compatible to httplib's HTTPResponse but the response ``body`` is
loaded and decoded on-demand when the ``data`` property is accessed. This
class is also compatible with the Python standard library's :mod:`io`
module, and can hence be treated as a readable object in the context of that
framework.
Extra parameters for behaviour not present in httplib.HTTPResponse:
:param preload_content:
If True, the response's body will be preloaded during construction.
:param decode_content:
If True, attempts to decode specific content-encoding's based on headers
(like 'gzip' and 'deflate') will be skipped and raw data will be used
instead.
:param original_response:
When this HTTPResponse wrapper is generated from an httplib.HTTPResponse
object, it's convenient to include the original for debug purposes. It's
otherwise unused.
:param retries:
The retries contains the last :class:`~urllib3.util.retry.Retry` that
was used during the request.
:param enforce_content_length:
Enforce content length checking. Body returned by server must match
value of Content-Length header, if present. Otherwise, raise error.
R) t deflatei- i. i/ i3 i4 t i c C@ s� t | t � r | | _ n t | � | _ | | _ | | _ | | _ | | _ | | _ | | _ |
| _ d | _ d | _ d | _
| | _ d | _ | r� t | t t f � r� | | _ n |
| _ | | _ t | d � r� | | _
n t | _ d | _ | j j d d � j � } d � | j d � D� } d | k rHt | _ n | j | � | _ | r�| j r�| j d | � | _ n d S( Ni t reads transfer-encodingR. c s@ s | ] } | j � Vq d S( N( t strip( t .0t enc( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pys <genexpr>� s t ,t chunkedt decode_content( t
isinstanceR t headerst statust versiont reasont strictR5 t retriest enforce_content_lengthR" t _decodert _bodyt _fpt _original_responset _fp_bytes_readt
basestringR
t _poolt _connectiont hasattrR! R4 t
chunk_leftt gett lowert splitR t _init_lengtht length_remainingR/ ( R t bodyR7 R8 R9 R: R; t preload_contentR5 t original_responset poolt
connectionR< R= t request_methodt tr_enct encodings( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR q s< c C@ s& | j | j k r" | j j d � St S( s
Should we redirect and where to?
:returns: Truthy redirect location string if we got a redirect status
code and valid location. ``None`` if redirect status and no
location. ``False`` if not a redirect status code.
t location( R8 t REDIRECT_STATUSESR7 RH R! ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt get_redirect_location� s c C@ s8 | j s | j r d S| j j | j � d | _ d S( N( RD RE t _put_connR" ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt release_conn� s c C@ s- | j r | j S| j r) | j d t � Sd S( Nt
cache_content( R? R@ R/ R ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR$ � s c C@ s | j S( N( RE ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyRQ � s c C@ s | j S( s�
Obtain the number of bytes pulled over the wire so far. May differ from
the amount of content returned by :meth:``HTTPResponse.read`` if bytes
are encoded on the wire (e.g, compressed).
( RB ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt tell� s c C@ sG | j j d � } | d k r8 | j r8 t j d � d S| d k r� yc t g | j d � D] } t | � ^ qZ � } t | � d k r� t
d | � � n | j � } Wn t k
r� d } q� X| d k r� d } q� n y t | j
� } Wn t k
rd } n X| d
k s:d | k o)d
k n s:| d k rCd } n | S( sM
Set initial length value for Response content if available.
s content-lengths� Received response with both Content-Length and Transfer-Encoding set. This is expressly forbidden by RFC 7230 sec 3.3.2. Ignoring Content-Length and attempting to process response as Transfer-Encoding: chunked.R3 i s8 Content-Length contained multiple unmatching values (%s)i i� i0 id i� t HEADN( i� i0 ( R7 RH R" R4 t logt warningt setRJ t intt lenR t popt
ValueErrorR8 ( R RR t lengtht valt lengthsR8 ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyRK � s,
.
4 c C@ sO | j j d d � j � } | j d k rK | | j k rK t | � | _ n d S( s=
Set-up the _decoder attribute if necessary.
s content-encodingR. N( R7 RH RI R> R" t CONTENT_DECODERSR+ ( R t content_encoding( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt
_init_decoder� s c C@ s� y( | r' | j r' | j j | � } n WnJ t t j f k
rt } | j j d d � j � } t d | | � � n X| r� | r� | | j � 7} n | S( sN
Decode the data passed in and potentially flush the decoder.
s content-encodingR. sE Received response with content-encoding: %s, but failed to decode it.(
R> R t IOErrorR R R7 RH RI R t _flush_decoder( R R$ R5 t
flush_decodert eRh ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt _decode s c C@ s0 | j r, | j j d � } | | j j � Sd S( sk
Flushes the decoder. Should only be called if the decoder is actually
being used.
R. ( R> R t flush( R t buf( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyRk s c c@ s t } z� y d VWn� t k
r: t | j d d � � nk t k
ry } d t | � k ra � n t | j d d � � n, t t f k
r� } t d | | � � n Xt
} Wd | s� | j r� | j j � n | j
r� | j
j � q� n | j r| j j � r| j � n Xd S( s�
Catch low-level python exceptions, instead re-raising urllib3
variants, so that low-level exceptions are not leaked in the
high-level api.
On exit, release the connection back to the pool.
Ns Read timed out.s read operation timed outs Connection broken: %r( R! t
SocketTimeoutR RD R" R t strR t SocketErrorR R RA t closeRE t isclosedRY ( R t
clean_exitRm ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt _error_catcher! s(
c C@ sY | j � | d k r" | j } n | j d k r5 d St } d } | j � �� | d k rr | j j � } t } nq t } | j j | � } | d k r� | r� | j j � t } | j r� | j
d k r� t | j | j
� � q� n Wd QX| rU| j t
| � 7_ | j
d k r+| j
t
| � 8_
n | j | | | � } | rU| | _ qUn | S( sP
Similar to :meth:`httplib.HTTPResponse.read`, but with two additional
parameters: ``decode_content`` and ``cache_content``.
:param amt:
How much of the content to read. If specified, caching is skipped
because it doesn't make sense to cache partial content as the full
response.
:param decode_content:
If True, will attempt to decode the body based on the
'content-encoding' header.
:param cache_content:
If True, will save the returned data such that the same result is
returned despite of the state of the underlying file object. This
is useful if you want the ``.data`` property to continue working
after having ``.read()`` the file object. (Overridden if ``amt`` is
set.)
Ni ( i N( Ri R" R5 R@ R! Rw R/ R Rt R= RL R
RB Ra Rn R? ( R t amtR5 RZ Rl R$ ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR/ Z s4
!i i c c@ s} | j r= | j � r= xa | j | d | �D] } | Vq+ Wn< x9 t | j � sx | j d | d | � } | r@ | Vq@ q@ Wd S( s_
A generator wrapper for the read() method. A call will block until
``amt`` bytes have been read from the connection or until the
connection is closed.
:param amt:
How much of the content to read. The generator will return up to
much data per iteration, but may return less. This is particularly
likely when using compressed data. However, the empty string will
never be returned.
:param decode_content:
If True, will attempt to decode the body based on the
'content-encoding' header.
R5 Rx N( R4 t supports_chunked_readst read_chunkedR R@ R/ ( R Rx R5 t lineR$ ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt stream� s c K@ s� | j } t | t � sE t r3 t | j � � } qE t j | � } n t | d d � } | d | d | d | j d | j d | j d | d | | � } | S( s
Given an :class:`httplib.HTTPResponse` instance ``r``, return a
corresponding :class:`urllib3.response.HTTPResponse` object.
Remaining parameters are passed to the HTTPResponse constructor, along
with ``original_response=r``.
R; i RM R7 R8 R9 R: RO (
t msgR6 R R t itemst from_httplibR R8 R9 R: ( t ResponseClst rt response_kwR7 R; t resp( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR � s c C@ s | j S( N( R7 ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt
getheaders� s c C@ s | j j | | � S( N( R7 RH ( R R t default( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt getheader� s c C@ s | j S( N( R7 ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt info� s c C@ s6 | j s | j j � n | j r2 | j j � n d S( N( t closedR@ Rt RE ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyRt � s c C@ sV | j d k r t St | j d � r2 | j j � St | j d � rN | j j St Sd S( NRu R� ( R@ R" R RF Ru R� ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR� � s
c C@ sM | j d k r t d � � n+ t | j d � r= | j j � St d � � d S( Ns- HTTPResponse has no file to get a fileno fromt filenosO The file-like object this HTTPResponse is wrapped around has no file descriptor( R@ R" Rj RF R� ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR� � s
c C@ s2 | j d k r. t | j d � r. | j j � Sd S( NRo ( R@ R" RF Ro ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyRo � s !c C@ s t S( N( R ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt readable s c C@ sI | j t | � � } t | � d k r+ d S| | t | � *t | � Sd S( Ni ( R/ Ra ( R t bt temp( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt readinto s
c C@ s t | j d � S( s�
Checks if the underlying file-like object looks like a
httplib.HTTPResponse object. We do this by testing for the fp
attribute. If it is present we assume it returns raw chunks as
processed by read_chunked().
t fp( RF R@ ( R ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyRy s c C@ s� | j d k r d S| j j j � } | j d d � d } y t | d � | _ Wn* t k
r} | j � t j
| � � n Xd S( Nt ;i i i ( RG R" R@ R� t readlineRJ R` Rc Rt t httplibR
( R R{ ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt _update_chunk_length s
c C@ s� d } | d k rI | j j | j � } | } | j j d � d | _ n� | | j k r� | j j | � } | j | | _ | } nq | | j k r� | j j | � } | j j d � d | _ | } n. | j j | j � } | j j d � d | _ | S( Ni ( R" R@ t
_safe_readRG ( R Rx t returned_chunkt chunkt value( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt
_handle_chunk% s& c
c@ sT | j � | j s" t d � � n | j � s= t d � � n | j rf t | j � rf | j j � d S| j � �� x_ t r� | j
� | j d k r� Pn | j | � } | j
| d | d t �} | rv | Vqv qv W| r� | j � } | r� | Vq� n x6 t r0| j j j � } | s Pn | d k r� Pq� q� W| j rJ| j j � n Wd QXd S( s�
Similar to :meth:`HTTPResponse.read`, but with an additional
parameter: ``decode_content``.
:param decode_content:
If True, will attempt to decode the body based on the
'content-encoding' header.
sH Response is not chunked. Header 'transfer-encoding: chunked' is missing.sg Body should be httplib.HTTPResponse like. It should have have an fp attribute which returns raw chunks.Ni R5 Rl s
( Ri R4 R Ry R RA R Rt Rw R R� RG R� Rn R! Rk R@ R� R� ( R Rx R5 R� t decodedR{ ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyRz ; s@
Ni (& R& R' t __doc__Rg RV R" R R! R RW RY t propertyR$ RQ R[ RK Ri Rn Rk R Rw R/ R| t classmethodR R� R� R� Rt R� R� Ro R� R� Ry R� R� Rz ( ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyR, L sB -
0
9E (- t
__future__R t
contextlibR R t iot loggingt socketR Rq R Rs t _collectionsR t
exceptionsR R R R R R
R t packages.sixR RC R
R t packages.six.movesR R� RQ R R t
util.responseR R t getLoggerR& R] t objectR R( R+ t IOBaseR, ( ( ( s@ /usr/lib/python2.7/site-packages/pip/_vendor/urllib3/response.pyt <module> s" 4 !