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)BytesIOUnsupportedOperation )
default_hooks)CaseInsensitiveDict)
HTTPBasicAuth)cookiejar_from_dictget_cookie_header) RequestField)encode_multipart_formdata) parse_url) DecodeError) HTTPErrorRequestException
MissingSchema
InvalidURLChunkedEncodingErrorContentDecodingError)
guess_filenameget_auth_from_url requote_uri stream_decode_response_unicodeto_key_val_listparse_header_links iter_slicesguess_json_utf super_lento_native_string)
cookielib
urlunparseurlsplit urlencodestrbytesStringIOis_py2chardetjson builtin_str
basestringIncompleteRead)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 urlpathappendqueryjoin)selfr2 pr3 r5 r9 6/tmp/pip-ztkk0jow-build/pip/_vendor/requests/models.pypath_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)zEncode 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-8doseqT)
isinstancer" r# hasattrr r) r4 encoder! )dataresultkvsvr9 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 rt | d k r| \ }
} qt | d k r| \ }
} } q| \ }
} } } n t
| p| }
| } t | t rt | } 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 filenameheaders content_type)
ValueErrorr? r) r r@ r# r" r4 decoderA tuplelistlenr r$ r r
r< make_multipartr )filesrB
new_fieldsfieldsfieldvalrF rD ftfhfnfprfbodyrM 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? collectionsCallable).0hr9 r9 r: s z2RequestHooksMixin.register_hook..N)hooksrN r? rf rg r4 r@ extend)r7 eventhookr9 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 ` object.
Used to prepare a :class:`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()
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 paramsauthcookies) 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)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 ` for transmission and returns it.rt r2 rL rT rB ru rv rw rk ) PreparedRequestpreparert 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 ` object,
containing the exact bytes that will be sent to the server.
Generated from either a :class:`Request ` object or manually.
Usage::
>>> import requests
>>> req = requests.Request('GET', 'http://httpbin.org/get')
>>> r = req.prepare()
>>> s = requests.Session()
>>> s.send(r)
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_urlprepare_headersprepare_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)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 suppliedidnazutf-8zURL has an invalid label.r1 @r/ z%s&%s)unicode NameErrorr" UnicodeDecodeErrorlower
startswithr2 r r formatr rA rO UnicodeErrorr% r? rG r r ) r7 r2 ru schemerv hostportr3 r5 fragmentnetloc
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..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 ` object, which contains a
server's response to an HTTP request.
_content status_coderL r2 historyencodingreasonrw elapsedrequestc 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__..)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)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)zTrue 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)Ndecode_contentT) r streamr* r r
r r r< r )chunke)
chunk_sizer7 r9 r: generateo s
#
z'Response.iter_content..generate)r r r r )r7 r decode_unicoder
reused_chunks
stream_chunkschunksr9 )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) zIterates 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
splitlinespop)r7 r r pendingr linesliner9 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 errorsreplace)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)zReturns 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 } | | | 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: %sresponseN)r r r )r7 http_error_msgr9 r9 r: r s zResponse.raise_for_statusc C s
| j j S)zReleases 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+ movedfoundothertemporary_movedr DEFAULT_REDIRECT_LIMITr r objectr. re rr rz r r9 r9 r9 r: s6 .FX mJ