3 nf\ d@sddlmZddlmZddlZddlZddlZddlmZ ddlm Z ddl m Z ddlmZmZmZmZmZmZmZdd lmZmZdd lmZdd lmZmZdd l m!Z!m"Z"ej#e$Z%Gd dde&Z'Gddde&Z(Gddde&Z)Gddde&Z*ddZ+Gdddej,Z-dS))absolute_import)contextmanagerN)timeout)error)HTTPHeaderDict)BodyNotHttplibCompatible ProtocolError DecodeErrorReadTimeoutErrorResponseNotChunkedIncompleteRead InvalidHeader) string_typesPY3) http_client) HTTPException BaseSSLError) is_fp_closedis_response_to_headc@s$eZdZddZddZddZdS)DeflateDecodercCsd|_d|_tj|_dS)NT) _first_try_datazlib decompressobj_obj)selfr/usr/lib/python3.6/response.py__init__szDeflateDecoder.__init__cCs t|j|S)N)getattrr)rnamerrr __getattr__szDeflateDecoder.__getattr__cCs|s|S|js|jj|S|j|7_y |jj|}|rFd|_d|_|Stjk rd|_tjtj |_z |j|jSd|_XYnXdS)NF)rr decompressrrrr MAX_WBITS)rdataZ decompressedrrrr$ s"   zDeflateDecoder.decompressN)__name__ __module__ __qualname__r r#r$rrrrrsrc@seZdZdZdZdZdS)GzipDecoderStaterrN)r'r(r) FIRST_MEMBER OTHER_MEMBERS SWALLOW_DATArrrrr*7sr*c@s$eZdZddZddZddZdS) GzipDecodercCstjdtj|_tj|_dS)N)rrr%rr*r,_state)rrrrr @szGzipDecoder.__init__cCs t|j|S)N)r!r)rr"rrrr#DszGzipDecoder.__getattr__c Cst}|jtjks| r t|Sxy||jj|7}Wn8tjk rn|j}tj|_|tj krht|SYnX|jj }|st|Stj |_tj dtj |_q"WdS)Nr0) bytearrayr1r*r.bytesrr$rrr-Z unused_datarr%)rr&retZprevious_staterrrr$Gs" zGzipDecoder.decompressN)r'r(r)r r#r$rrrrr/>sr/c@s(eZdZdZddZddZddZdS) MultiDecodera From RFC7231: If one or more encodings have been applied to a representation, the sender that applied the encodings MUST generate a Content-Encoding header field that lists the content codings in the order in which they were applied. cCsdd|jdD|_dS)NcSsg|]}t|jqSr) _get_decoderstrip).0mrrr gsz)MultiDecoder.__init__..,)split _decoders)rZmodesrrrr fszMultiDecoder.__init__cCs|jdjS)Nr)r=flush)rrrrr>iszMultiDecoder.flushcCs"xt|jD]}|j|}q W|S)N)reversedr=r$)rr&drrrr$lszMultiDecoder.decompressN)r'r(r)__doc__r r>r$rrrrr5]sr5cCs$d|krt|S|dkrtStS)Nr;gzip)r5r/r)moderrrr6rs r6c@s,eZdZdZddgZdddddgZdJddZddZddZe ddZ e ddZ ddZ ddZ ddZddZd d!Zd"d#Zed$d%ZdKd&d'ZdMd*d+Zed,d-Zd.d/ZdNd0d1Zd2d3Zd4d5Ze d6d7Zd8d9Zd:d;Zdd?Z d@dAZ!dBdCZ"dDdEZ#dOdFdGZ$dHdIZ%d S)P HTTPResponsea 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, will attempt to decode the body based on the 'content-encoding' header. :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. rBZdeflatei-i.i/i3i4NrTFcCst|tr||_n t||_||_||_||_||_||_| |_||_ d|_ d|_ d|_ | |_ d|_| |_||_|rt|ttfr||_ | |_| |_t|dr||_ d|_d|_|jjddj}dd|jdD}d |krd |_|j||_|o|j r |j|d |_ dS) NrreadFztransfer-encodingrEcss|]}|jVqdS)N)r7)r8encrrr sz(HTTPResponse.__init__..r;chunkedT)decode_content) isinstancerheadersstatusversionreasonstrictrJretriesenforce_content_length_decoder_body_fp_original_response_fp_bytes_readmsg _request_url basestringr3_pool _connectionhasattrrI chunk_leftgetlowerr< _init_lengthlength_remainingrF)rbodyrLrMrNrOrPZpreload_contentrJoriginal_responseZpool connectionrXrQrRrequest_methodZ request_urlZtr_enc encodingsrrrr s@    zHTTPResponse.__init__cCs|j|jkr|jjdSdS)a 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. locationF)rMREDIRECT_STATUSESrLr_)rrrrget_redirect_locations  z"HTTPResponse.get_redirect_locationcCs,|j s|j rdS|jj|jd|_dS)N)r[r\Z _put_conn)rrrr release_connszHTTPResponse.release_conncCs"|jr |jS|jr|jddSdS)NT) cache_content)rTrUrF)rrrrr&szHTTPResponse.datacCs|jS)N)r\)rrrrreszHTTPResponse.connectioncCs t|jS)N)rrU)rrrrisclosedszHTTPResponse.isclosedcCs|jS)z 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). )rW)rrrrtellszHTTPResponse.tellcCs|jjd}|dk r|jr(tjddSy.r;rz8Content-Length contained multiple unmatching values (%s)r0dZHEAD)rqrr) rLr_rIlogZwarningsetr<lenrpop ValueErrorrorM)rrfZlengthZlengthsrMrrrras,      (zHTTPResponse._init_lengthcshjjddj}jdkrd|jkr2t|_n2d|krdfdd|jdD}t|rdt|_dS)z= Set-up the _decoder attribute if necessary. zcontent-encodingrENr;cs"g|]}|jjkr|jqSr)r7CONTENT_DECODERS)r8e)rrrr::sz.HTTPResponse._init_decoder..)rLr_r`rSrzr6r<rw)rcontent_encodingrgr)rr _init_decoder/s   zHTTPResponse._init_decodercCs|y|r|jr|jj|}WnHttjfk rb}z&|jjddj}td||WYdd}~XnX|rx|rx||j 7}|S)zN Decode the data passed in and potentially flush the decoder. zcontent-encodingrEzEReceived response with content-encoding: %s, but failed to decode it.N) rSr$IOErrorrrrLr_r`r _flush_decoder)rr&rJ flush_decoderr{r|rrr_decode>s  zHTTPResponse._decodecCs$|jr |jjd}||jjSdS)zk Flushes the decoder. Should only be called if the decoder is actually being used. r)rSr$r>)rZbufrrrrPs zHTTPResponse._flush_decoderccsd}zy dVWntk r2t|jddYnptk rn}z"dt|krPt|jddWYdd}~Xn4ttfk r}ztd||WYdd}~XnXd}Wd|s|jr|jj |j r|j j |jr|jj r|j XdS)z 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. FNzRead timed out.zread operation timed outzConnection broken: %rT) SocketTimeoutr r[rstrr SocketErrorr rVcloser\rmrk)rZ clean_exitr{rrr_error_catcher[s(      zHTTPResponse._error_catcherc Cs|j|dkr|j}|jdkr$dSd}d}|jh|dkrN|jj}d}nJd}|jj|}|dkr| r|jjd}|jr|jdkrt|j |jWdQRX|r|j t |7_ |jdk r|jt |8_|j |||}|r||_ |S)aP 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.) NFTr)rN) r}rJrUrrFrrRrbr rWrwrrT)ramtrJrlrr&rrrrFs4      zHTTPResponse.readr+r0ccsZ|jr.|jr.xF|j||dD] }|VqWn(x&t|jsT|j||d}|r0|Vq0WdS)a_ 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. )rJ)rrJN)rIsupports_chunked_reads read_chunkedrrUrF)rrrJliner&rrrstreams  zHTTPResponse.streamc Ks`|j}t|ts,tr"t|j}n tj|}t|dd}|f|||j|j|j ||d|}|S)a  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``. rPr)rcrLrMrNrOrPrd) rXrKrritems from_httplibr!rMrNrO)Z ResponseClsrZ response_kwrLrPZresprrrrs    zHTTPResponse.from_httplibcCs|jS)N)rL)rrrr getheadersszHTTPResponse.getheaderscCs|jj||S)N)rLr_)rr"defaultrrr getheaderszHTTPResponse.getheadercCs|jS)N)rL)rrrrinfoszHTTPResponse.infocCs$|js|jj|jr |jjdS)N)closedrUrr\)rrrrrs zHTTPResponse.closecCs@|jdkrdSt|jdr$|jjSt|jdr8|jjSdSdS)NTrmr)rUr]rmr)rrrrr#s    zHTTPResponse.closedcCs6|jdkrtdnt|jdr*|jjStddS)Nz-HTTPResponse has no file to get a fileno fromfilenozOThe file-like object this HTTPResponse is wrapped around has no file descriptor)rUr~r]r)rrrrr.s     zHTTPResponse.filenocCs$|jdk r t|jdr |jjSdS)Nr>)rUr]r>)rrrrr>7szHTTPResponse.flushcCsdS)NTr)rrrrreadable;szHTTPResponse.readablecCs:|jt|}t|dkrdS||dt|<t|SdS)Nr)rFrw)rbZtemprrrreadinto?s  zHTTPResponse.readintocCs t|jdS)z 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(). fp)r]rU)rrrrrHsz#HTTPResponse.supports_chunked_readsc Csf|jdk rdS|jjj}|jddd}yt|d|_Wn&tk r`|jtj |YnXdS)N;rrr0) r^rUrreadliner<roryrhttplibr )rrrrr_update_chunk_lengthQs  z!HTTPResponse._update_chunk_lengthcCsd}|dkr2|jj|j}|}|jjdd|_nv||jkrZ|jj|}|j||_|}nN||jkr|jj|}|jjdd|_|}n |jj|j}|jjdd|_|S)Nr+)rUZ _safe_readr^)rrZreturned_chunkchunkvaluerrr _handle_chunk_s&        zHTTPResponse._handle_chunkc cs|j|jstd|js&td|j|jrNt|jrN|jjdS|j j dkr^dSx<|j |j dkrtP|j |}|j||dd}|r`|Vq`W|r|j}|r|Vx |j j j}|sP|dkrPqW|jr|jjWdQRXdS)a Similar to :meth:`HTTPResponse.read`, but with an additional parameter: ``decode_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. zHResponse is not chunked. Header 'transfer-encoding: chunked' is missing.zgBody should be httplib.HTTPResponse like. It should have have an fp attribute which returns raw chunks.NrF)rJrs )r}rIr rrrrVrrrUrrr^rrrr)rrrJrZdecodedrrrrrusD       zHTTPResponse.read_chunkedcCs.|jdk r$t|jjr$|jjdjS|jSdS)z Returns the URL that was the source of this response. If the request that generated this response redirected, this method will return the final redirect location. Nr)rQrwhistoryZredirect_locationrY)rrrrgeturlszHTTPResponse.geturl)rENrrNrTTNNNNNFNN)NNF)rN)N)NN)&r'r(r)rArzrir rjrkpropertyr&rermrnrar}rrrrrFr classmethodrrrrrrrr>rrrrrrrrrrrrD|sH /  0 9 E        CrD).Z __future__r contextlibrrioZloggingZsocketrrrr _collectionsr exceptionsrr r r r r rZ packages.sixrrZrZpackages.six.movesrrrerrZ util.responserrZ getLoggerr'ruobjectrr*r/r5r6IOBaserDrrrrs&     $  !