관리-도구
편집 파일: models.cpython-34.pyc
� �ReDg � @ s; d Z d d l Z d d l Z d d l m Z m Z d d l m Z d d l m Z d d l m Z d d l m Z m Z d d l m 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 d d l m Z m Z m! Z! m" Z" m# Z# m$ Z$ m% Z% m& Z& m' Z' m( Z( d d l) m* Z* m+ Z+ m, Z, m- Z- m. Z. m/ Z/ m0 Z0 m1 Z1 m2 Z2 m3 Z3 m4 Z4 m5 Z5 m6 Z6 d d l7 m8 Z8 e8 j9 e8 j: e8 j; e8 j< f Z= d Z> d Z? d Z@ Gd d � d eA � ZB Gd d � d eA � ZC Gd d � d eC � ZD Gd d � d eB eC � ZE Gd d � d eA � ZF d S) z` requests.models ~~~~~~~~~~~~~~~ This module contains the primary objects that power Requests. � N)�BytesIO�UnsupportedOperation� )� default_hooks)�CaseInsensitiveDict)� HTTPBasicAuth)�cookiejar_from_dict�get_cookie_header)� RequestField)�encode_multipart_formdata)� parse_url)� DecodeError)� HTTPError�RequestException� MissingSchema� InvalidURL�ChunkedEncodingError�ContentDecodingError) �guess_filename�get_auth_from_url� requote_uri� stream_decode_response_unicode�to_key_val_list�parse_header_links� iter_slices�guess_json_utf� super_len�to_native_string) � cookielib� urlunparse�urlsplit� urlencode�str�bytes�StringIO�is_py2�chardet�json� builtin_str� basestring�IncompleteRead)�codes� � i i c @ sF e Z d Z e d d � � Z e d d � � Z e d d � � Z d S)�RequestEncodingMixinc C ss g } t | j � } | j } | s- d } n | j | � | j } | rf | j d � | j | � n d j | � S)zBuild the path URL to use.�/�?� )r �url�path�append�query�join)�selfr2 �pr3 r5 � r9 �6/tmp/pip-ztkk0jow-build/pip/_vendor/requests/models.py�path_url1 s z RequestEncodingMixin.path_urlc C s t | t t f � r | St | d � r, | St | d � rg } x� t | � D]� \ } } t | t � sy t | d � r� | g } n xl | D]d } | d k r� | j t | t � r� | j d � n | t | t � r� | j d � n | f � q� q� WqN Wt | d d �S| Sd S)z�Encode parameters in a piece of data. Will successfully encode parameters when passed as a dict or a list of 2-tuples. Order is retained if data is a list of 2-tuples but arbitrary if parameters are supplied as a dict. �read�__iter__Nzutf-8�doseqT) � isinstancer" r# �hasattrr r) r4 �encoder! )�data�result�k�vs�vr9 r9 r: �_encode_paramsF s !3z#RequestEncodingMixin._encode_paramsc C sr | s t d � � n t | t � r3 t d � � n g } t | pE i � } t | pW i � } x� | D]� \ } } t | t � s� t | d � r� | g } n x� | D]� } | d k r� t | t � s� t | � } n | j t | t � r� | j d � n | t | t � r| j d � n | f � q� q� Wqd Wx'| D] \ } } d } d } t | t t f � r�t | � d k r�| \ } } q�t | � d k r�| \ } } } q�| \ } } } } n t | � p�| } | } t | t � r�t | � } n t | t � rt | � } n t d | d | j � d | d | � } | j d | � | j | � q3Wt | � \ } } | | f S) a Build the body for a multipart/form-data request. Will successfully encode files when passed as a dict or a list of 2-tuples. Order is retained if data is a list of 2-tuples but arbitrary if parameters are supplied as a dict. zFiles must be provided.zData must not be a string.r= Nzutf-8� � �namerB �filename�headers� content_type)� ValueErrorr? r) r r@ r# r" r4 �decoderA �tuple�list�lenr r$ r r r< �make_multipartr )�filesrB � new_fields�fields�field�valrF rD �ft�fh�fn�fp�rf�bodyrM r9 r9 r: � _encode_filesa sL !3z"RequestEncodingMixin._encode_filesN)�__name__� __module__� __qualname__�propertyr; � staticmethodrG r_ r9 r9 r9 r: r. 0 s r. c @ s( e Z d Z d d � Z d d � Z d S)�RequestHooksMixinc C s� | | j k r" t d | � � n t | t j � rK | j | j | � n3 t | d � r~ | j | j d d � | D� � n d S)zProperly register a hook.z1Unsupported event specified, with event name "%s"r= c s s' | ] } t | t j � r | Vq d S)N)r? � collections�Callable)�.0�hr9 r9 r: � <genexpr>� s z2RequestHooksMixin.register_hook.<locals>.<genexpr>N)�hooksrN r? rf rg r4 r@ �extend)r7 �event�hookr9 r9 r: � register_hook� s z RequestHooksMixin.register_hookc C s9 y | j | j | � d SWn t k r4 d SYn Xd S)ziDeregister a previously registered hook. Returns True if the hook existed, False if not. TFN)rk �removerN )r7 rm rn r9 r9 r: �deregister_hook� s z!RequestHooksMixin.deregister_hookN)r` ra rb ro rq r9 r9 r9 r: re � s re c @ sU e Z d Z d Z d d d d d d d d d d d � Z d d � Z d d � Z d S) �Requesta A user-created :class:`Request <Request>` object. Used to prepare a :class:`PreparedRequest <PreparedRequest>`, which is sent to the server. :param method: HTTP method to use. :param url: URL to send. :param headers: dictionary of headers to send. :param files: dictionary of {filename: fileobject} files to multipart upload. :param data: the body to attach the request. If a dictionary is provided, form-encoding will take place. :param params: dictionary of URL parameters to append to the URL. :param auth: Auth handler or (user, pass) tuple. :param cookies: dictionary or CookieJar of cookies to attach to this request. :param hooks: dictionary of callback hooks, for internal usage. Usage:: >>> import requests >>> req = requests.Request('GET', 'http://httpbin.org/get') >>> req.prepare() <PreparedRequest [GET]> Nc C s | d k r g n | } | d k r* g n | } | d k rB i n | } | d k rZ i n | } | d k rr i n | } t � | _ x6 t | j � � D]" \ } } | j d | d | � q� W| | _ | | _ | | _ | | _ | | _ | | _ | | _ | | _ d S)Nrm rn ) r rk rQ �itemsro �methodr2 rL rT rB �params�auth�cookies) r7 rt r2 rL rT rB ru rv rw rk rD rF r9 r9 r: �__init__� s zRequest.__init__c C s d | j S)Nz<Request [%s]>)rt )r7 r9 r9 r: �__repr__� s zRequest.__repr__c C sh t � } | j d | j d | j d | j d | j d | j d | j d | j d | j d | j � | S) zXConstructs a :class:`PreparedRequest <PreparedRequest>` for transmission and returns it.rt r2 rL rT rB ru rv rw rk ) �PreparedRequest�preparert r2 rL rT rB ru rv rw rk )r7 r8 r9 r9 r: r{ � s zRequest.prepare)r` ra rb �__doc__rx ry r{ r9 r9 r9 r: rr � s rr c @ s� e Z d Z d Z d d � Z d d d d d d d d d d d � Z d d � Z d d � Z d d � Z d d � Z d d � Z d d � Z d d � Z d d d � Z d d � Z d d � Z d S) rz a� The fully mutable :class:`PreparedRequest <PreparedRequest>` object, containing the exact bytes that will be sent to the server. Generated from either a :class:`Request <Request>` object or manually. Usage:: >>> import requests >>> req = requests.Request('GET', 'http://httpbin.org/get') >>> r = req.prepare() <PreparedRequest [GET]> >>> s = requests.Session() >>> s.send(r) <Response [200]> c C s= d | _ d | _ d | _ d | _ d | _ t � | _ d S)N)rt r2 rL �_cookiesr^ r rk )r7 r9 r9 r: rx s zPreparedRequest.__init__Nc C sh | j | � | j | | � | j | � | j | � | j | | � | j | | � | j | � d S)z6Prepares the entire request with the given parameters.N)�prepare_method� prepare_url�prepare_headers�prepare_cookies� prepare_body� prepare_auth� prepare_hooks) r7 rt r2 rL rT rB ru rv rw rk r9 r9 r: r{ ! s zPreparedRequest.preparec C s d | j S)Nz<PreparedRequest [%s]>)rt )r7 r9 r9 r: ry 1 s zPreparedRequest.__repr__c C sa t � } | j | _ | j | _ | j j � | _ | j j � | _ | j | _ | j | _ | S)N)rz rt r2 rL �copyr} r^ rk )r7 r8 r9 r9 r: r� 4 s zPreparedRequest.copyc C s1 | | _ | j d k r- | j j � | _ n d S)z Prepares the given HTTP method.N)rt �upper)r7 rt r9 r9 r: r~ > s z PreparedRequest.prepare_methodc C sq y t | � } Wn/ t k r0 t | � } Yn t k rA Yn Xd | k rq | j � j d � rq | | _ d St | � \ } } } } } } } | s� t d j | � � � n | s� t d | � � n y | j d � j d � } Wn t k rt d � � Yn X| pd } | r%| d 7} n | | 7} | rL| d t | � 7} n | s[d } n t r t | t � r�| j d � } n t | t � r�| j d � } n t | t � r�| j d � } n t | t � r�| j d � } n t | t � r | j d � } q n | j | � } | r@| r7d | | f } q@| } n t t | | | d | | g � � } | | _ d S) z Prepares the given HTTP URL.�:�httpNzDInvalid URL {0!r}: No schema supplied. Perhaps you meant http://{0}?z Invalid URL %r: No host supplied�idnazutf-8zURL has an invalid label.r1 �@r/ z%s&%s)�unicode� NameErrorr" �UnicodeDecodeError�lower� startswithr2 r r �formatr rA rO � UnicodeErrorr% r? rG r r ) r7 r2 ru �schemerv �host�portr3 r5 �fragment�netloc� enc_paramsr9 r9 r: r D sZ " ! $zPreparedRequest.prepare_urlc C s; | r+ t d d � | j � D� � | _ n t � | _ d S)z Prepares the given HTTP headers.c s s' | ] \ } } t | � | f Vq d S)N)r )rh rJ �valuer9 r9 r: rj � s z2PreparedRequest.prepare_headers.<locals>.<genexpr>N)r rs rL )r7 rL r9 r9 r: r� � s %z PreparedRequest.prepare_headersc C s~ d } d } d } t t | d � t | t t t t f � g � } y t | � } Wn! t t t f k rv d } Yn X| r� | } | r� t d � � n | d k r� t | � | j d <qqd | j d <n� | r� | j | | � \ } } nT | r?| j | � } t | t � s-t | t � s-t | d � r6d } q?d } n | j | � | rqd | j k rq| | j d <n | | _ d S) z"Prepares the given HTTP body data.Nr= z1Streamed bodies and files are mutually exclusive.zContent-Length�chunkedzTransfer-Encodingr< z!application/x-www-form-urlencodedz content-typez Content-Type)�allr@ r? r) rQ rP �dictr � TypeError�AttributeErrorr �NotImplementedErrorr( rL r_ rG r" �prepare_content_lengthr^ )r7 rB rT r^ rM �length� is_streamr9 r9 r: r� � s8 " - z PreparedRequest.prepare_bodyc C s� t | d � rZ t | d � rZ | j d d � t | j � � | j d <| j d d � nV | d k r� t | � } | r� t | � | j d <q� n | j d k r� d | j d <n d S) N�seek�tellr rH zContent-Length�GET�HEAD�0)zGETzHEAD)r@ r� r( r� rL r rt )r7 r^ �lr9 r9 r: r� � s z&PreparedRequest.prepare_content_lengthr1 c C s� | d k r6 t | j � } t | � r- | n d } n | r� t | t � rl t | � d k rl t | � } n | | � } | j j | j � | j | j � n d S)z"Prepares the given HTTP auth data.NrH ) r r2 �anyr? rP rR r �__dict__�updater� r^ )r7 rv r2 �url_auth�rr9 r9 r: r� � s ! z PreparedRequest.prepare_authc C s_ t | t j � r | | _ n t | � | _ t | j | � } | d k r[ | | j d <n d S)z$Prepares the given HTTP cookie data.N�Cookie)r? r � CookieJarr} r r rL )r7 rw � cookie_headerr9 r9 r: r� � s z PreparedRequest.prepare_cookiesc C s) x" | D] } | j | | | � q Wd S)zPrepares the given hooks.N)ro )r7 rk rm r9 r9 r: r� � s z PreparedRequest.prepare_hooks)r` ra rb r| rx r{ ry r� r~ r r� r� r� r� r� r� r9 r9 r9 r: rz � s B 3 rz c sH e Z d Z d Z d d d d d d d d d d g Z � f d d � Z d d � Z d d � Z d d � Z d d � Z d d � Z d d � Z e d d � � Z e d d � � Z e d d � � Z d d! d" d# � Z e d$ d% d& � Z e d' d( � � Z e d) d* � � Z d+ d, � Z e d- d. � � Z d/ d0 � Z d1 d2 � Z � S)3�ResponsezhThe :class:`Response <Response>` object, which contains a server's response to an HTTP request. �_content� status_coderL r2 �history�encoding�reasonrw �elapsed�requestc s� t t | � j � d | _ d | _ d | _ t � | _ d | _ d | _ d | _ g | _ d | _ t i � | _ t j d � | _ d S)NFr )�superr� rx r� �_content_consumedr� r rL �rawr2 r� r� r� r rw �datetime� timedeltar� )r7 )� __class__r9 r: rx s zResponse.__init__c s3 � j s � j n t � f d d � � j D� � S)Nc 3 s' | ] } | t � | d � f Vq d S)N)�getattr)rh �attr)r7 r9 r: rj 6 s z(Response.__getstate__.<locals>.<genexpr>)r� �contentr� � __attrs__)r7 r9 )r7 r: � __getstate__/ s zResponse.__getstate__c C sQ x* | j � D] \ } } t | | | � q Wt | d d � t | d d � d S)Nr� Tr� )rs �setattr)r7 �staterJ r� r9 r9 r: � __setstate__: s zResponse.__setstate__c C s d | j S)Nz<Response [%s]>)r� )r7 r9 r9 r: ry B s zResponse.__repr__c C s | j S)z,Returns true if :attr:`status_code` is 'OK'.)�ok)r7 r9 r9 r: �__bool__E s zResponse.__bool__c C s | j S)z,Returns true if :attr:`status_code` is 'OK'.)r� )r7 r9 r9 r: � __nonzero__I s zResponse.__nonzero__c C s | j d � S)z,Allows you to use a response as an iterator.� )� iter_content)r7 r9 r9 r: r= M s zResponse.__iter__c C s+ y | j � Wn t k r& d SYn Xd S)NFT)�raise_for_statusr )r7 r9 r9 r: r� Q s z Response.okc C s d | j k o | j t k S)z�True if this Response is a well-formed HTTP redirect that could have been processed automatically (by :meth:`Session.resolve_redirects`). �location)rL r� �REDIRECT_STATI)r7 r9 r9 r: � is_redirectY s zResponse.is_redirectc C s t j | j � d S)z6The apparent encoding, provided by the chardet libraryr� )r& �detectr� )r7 r9 r9 r: �apparent_encoding` s zResponse.apparent_encodingr Fc sa � � f d d � } t � j � � } | � } � j r? | n | } | r] t | � � } n | S)a� Iterates over the response data. When stream=True is set on the request, this avoids reading the content at once into memory for large responses. The chunk size is the number of bytes it should read into memory. This is not necessarily the length of each item returned as decoding can take place. If decode_unicode is True, content will be decoded using the best available encoding based on the response. c 3 s� y� y, x% � j j � d d �D] } | Vq WWna t k rb } z t | � � WYd d } ~ Xn1 t k r� } z t | � � WYd d } ~ Xn XWn: t k r� x% � j j � � } | s� Pn | Vq� WYn Xd � _ d S)N�decode_contentT) r� �streamr* r r r r� r< r� )�chunk�e)� chunk_sizer7 r9 r: �generateo s # z'Response.iter_content.<locals>.generate)r r� r� r )r7 r� �decode_unicoder� � reused_chunks� stream_chunks�chunksr9 )r� r7 r: r� e s zResponse.iter_contentNc c s� d } x� | j d | d | � D]� } | d k r> | | } n | j � } | r� | d r� | r� | d d | d k r� | j � } n d } x | D] } | Vq� Wq W| d k r� | Vn d S) z�Iterates over the response data, one line at a time. When stream=True is set on the request, this avoids reading the content at once into memory for large responses. Nr� r� r ���r� r� r� )r� � splitlines�pop)r7 r� r� �pendingr� �lines�liner9 r9 r: � iter_lines� s . zResponse.iter_linesc C s� | j d k r� y^ | j r* t d � � n | j d k rE d | _ n' t � j | j t � � pf t � | _ Wq� t k r� d | _ Yq� Xn d | _ | j S)z"Content of the response, in bytes.Fz2The content for this response was already consumedr NT) r� r� � RuntimeErrorr� r# r6 r� �CONTENT_CHUNK_SIZEr� )r7 r9 r9 r: r� � s + zResponse.contentc C s� d } | j } | j s" t d � S| j d k r= | j } n y t | j | d d �} Wn- t t f k r� t | j d d �} Yn X| S)a� Content of the response, in unicode. If Response.encoding is None, encoding will be guessed using ``chardet``. The encoding of the response content is determined based solely on HTTP headers, following RFC 2616 to the letter. If you can take advantage of non-HTTP knowledge to make a better guess at the encoding, you should set ``r.encoding`` appropriately before accessing this property. Nr1 �errors�replace)r� r� r" r� � LookupErrorr� )r7 r� r� r9 r9 r: �text� s z Response.textc K s� | j ru t | j � d k ru t | j � } | d k ru y t j | j j | � | � SWqr t k rn Yqr Xqu n t j | j | � S)z�Returns the json-encoded content of a response, if any. :param \*\*kwargs: Optional arguments that ``json.loads`` takes. rI N) r� rR r� r r' �loadsrO r� r� )r7 �kwargsr� r9 r9 r: r' � s z Response.jsonc C sj | j j d � } i } | rf t | � } x9 | D]. } | j d � pR | j d � } | | | <q1 Wn | S)z8Returns the parsed header links of the response, if any.�link�relr2 )rL �getr )r7 �headerr� �linksr� �keyr9 r9 r: r� � s zResponse.linksc C s� d } d | j k o d k n r> d | j | j f } n8 d | j k oX d k n rv d | j | j f } n | r� t | d | �� n d S) z2Raises stored :class:`HTTPError`, if one occurred.r1 i� i� z%s Client Error: %siX z%s Server Error: %s�responseN)r� r� r )r7 �http_error_msgr9 r9 r: r� s zResponse.raise_for_statusc C s | j j � S)z�Releases the connection back to the pool. Once this method has been called the underlying ``raw`` object must not be accessed again. *Note: Should not normally need to be called explicitly.* )r� � release_conn)r7 r9 r9 r: �close s zResponse.close)r` ra rb r| r� rx r� r� ry r� r� r= rc r� r� r� r� �ITER_CHUNK_SIZEr� r� r� r' r� r� r� r9 r9 )r� r: r� � s: ( *& r� i ( )Gr| rf r� �ior r rk r � structuresr rv r rw r r Zpackages.urllib3.fieldsr Zpackages.urllib3.filepostr Zpackages.urllib3.utilr Zpackages.urllib3.exceptionsr � exceptionsr r r r r r �utilsr r r r r r r r r r �compatr r r r! r" r# r$ r% r& r' r( r) r* � status_codesr+ �moved�found�other�temporary_movedr� �DEFAULT_REDIRECT_LIMITr� r� �objectr. re rr rz r� r9 r9 r9 r: �<module> s6 .FX mJ�