| Current File : //lib/python2.7/site-packages/requests/sessions.pyc |
�
ZЅ_c @ s� d 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 d d l m
Z
m Z m Z m Z d d l m Z m Z m Z d d
l m Z m Z d d l m Z m Z m Z m Z d d l m Z m Z 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) m* Z* m+ Z+ m, Z, d d l- m. Z. d d l m/ Z/ d Z0 e d � Z1 e d � Z2 d e3 f d � � YZ4 d e4 f d � � YZ5 d � Z6 d S( s�
requests.session
~~~~~~~~~~~~~~~~
This module provides a Session object to manage and persist settings across
requests (cookies, auth, proxies).
i����N( t Mapping( t datetimei ( t _basic_auth_str( t cookielibt OrderedDictt urljoint urlparse( t cookiejar_from_dictt extract_cookies_to_jart RequestsCookieJart
merge_cookies( t Requestt PreparedRequestt DEFAULT_REDIRECT_LIMIT( t
default_hookst
dispatch_hook( t to_key_val_listt default_headerst to_native_stringt
DEFAULT_PORTS( t TooManyRedirectst
InvalidSchemat ChunkedEncodingErrort ContentDecodingError( t RecentlyUsedContainer( t CaseInsensitiveDict( t HTTPAdapter( t requote_urit get_environ_proxiest get_netrc_autht should_bypass_proxiest get_auth_from_url( t codes( t REDIRECT_STATIi� c C s� | d k r | S| d k r | St | t � o; t | t � sB | S| t | � � } | j t | � � x0 | j � D]" \ } } | d k rt | | =qt qt Wt d � | j � D� � } | S( s�
Determines appropriate setting for a given request, taking into account the
explicit setting on that request, and the setting in the session. If a
setting is a dictionary, they will be merged together using `dict_class`
c s s- | ]# \ } } | d k r | | f Vq d S( N( t None( t .0t kt v( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pys <genexpr>F s N( R" t
isinstanceR R t updatet itemst dict( t request_settingt session_settingt
dict_classt merged_settingR$ R% ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt
merge_setting* s c C sZ | d k s! | j d � g k r% | S| d k sF | j d � g k rJ | St | | | � S( s�
Properly merges both requests and session hooks.
This is necessary because when request_hooks == {'response': []}, the
merge breaks Session hooks entirely.
t responseN( R" t getR. ( t
request_hookst
session_hooksR, ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt merge_hooksK s
!!t SessionRedirectMixinc B s; e Z d � Z e d e d d d � Z d � Z d � Z RS( c C s� t | � } t | � } | j | j k r. t S| j d k rn | j d k rn | j d k rn | j d k rn t S| j | j k } | j | j k } t j | j d � d f } | r� | j | k r� | j | k r� t S| p� | S( sF Decide whether Authorization header should be removed when redirectingt httpiP t httpsi� N( iP N( i� N( R t hostnamet Truet schemet portR" t FalseR R0 ( t selft old_urlt new_urlt
old_parsedt
new_parsedt changed_portt changed_schemet default_port( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt should_strip_auth] s c c s; d } g } x(| j r6| j � }
| d k rU | j | � t | � } | | _ n y | j Wn- t t t f k
r� | j j
d t � n X| | j k r� t
d | j � � n | j � | j d } | j }
| j d � r t | j � } d | j | f } n t | � } | j � } | j sEt | j t | � � } n t | � } t | � |
_ | j r�| j |
j k r�|
j | j | j <n | j t j k r�|
d k r�d }
n | j t j k r�|
d k r�d }
n | j t j k r|
d k rd }
n |
|
_ | j t j! t j" f k rRd
|
j k rF|
j d
=n d |
_$ n |
j } y | d =Wn t% k
ryn Xt& |
j' | | j � |
j' j( | j) � |
j* |
j' � | j+ |
| � } | j, |
| � |
} | j- | d | d
| d | d | d | d t �} t& | j) |
| j � | d 7} | Vq Wd S( s6 Receives a Response. Returns a generator of Responses.i t decode_contents Exceeded %s redirects.t locations //s %s:%st HEADt GETt POSTs Content-Lengtht Cookiet streamt timeoutt verifyt certt proxiest allow_redirectsi N(. t is_redirectt copyt appendt listt historyt contentR R t RuntimeErrort rawt readR; t
max_redirectsR t closet headerst methodt
startswithR t urlR9 t geturlt netlocR R R t is_permanent_redirectt redirect_cachet status_codeR t see_othert foundt movedt temporary_redirectt permanent_redirectR" t bodyt KeyErrorR t _cookiesR' t cookiest prepare_cookiest rebuild_proxiest rebuild_autht send( R< t respt reqRK RL RM RN RO t it histt prepared_requestt new_histR_ R] t parsed_rurlt parsedR\ ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt resolve_redirectsv s|
c C s{ | j } | j } d | k r@ | j | j j | � r@ | d =n | j rU t | � n d } | d k rw | j | � n d S( s�
When being redirected we may want to strip authentication from the
request to avoid leaking credentials. This method intelligently removes
and reapplies authentication where possible to avoid credential loss.
t
AuthorizationN( R\ R_ RD t requestt trust_envR R" t prepare_auth( R< Rv R/ R\ R_ t new_auth( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyRp � s $
c C s | j } | j } t | � j } | d k r9 | j � n i } | j r� t | � r� t | � } | j | � } | r� | j
| | | � q� n d | k r� | d =n y t | | � \ } }
Wn t k
r� d \ } }
n X| r|
rt
| |
� | d <n | S( s�
This method re-evaluates the proxy configuration by considering the
environment variables. If we are redirected to a URL covered by
NO_PROXY, we strip the proxy configuration. Otherwise, we set missing
proxy keys for this URL (in case they were stripped by a previous
redirect).
This method also replaces the Proxy-Authorization header where
necessary.
s Proxy-AuthorizationN( NN( R\ R_ R R9 R" RR R} R R R0 t
setdefaultR Rk R ( R< Rv RO R\ R_ R9 t new_proxiest environ_proxiest proxyt usernamet password( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyRo � s$
N( t __name__t
__module__RD R; R" R8 Rz Rp Ro ( ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyR4 [ s
n t Sessionc B s e Z d Z d d d d d d d d d d
d d d
g
Z d � Z d � Z d � Z d � Z d! d! d! d! d! d! d! e d! d! d! d! d! d! d � Z
d � Z d � Z d � Z
d! d! d � Z d! d � Z d! d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS(" s� A Requests session.
Provides cookie persistence, connection-pooling, and configuration.
Basic Usage::
>>> import requests
>>> s = requests.Session()
>>> s.get('http://httpbin.org/get')
200
R\ Rm t authRO t hookst paramsRM RN t prefetcht adaptersRK R} RZ c C s� t � | _ d | _ i | _ t � | _ i | _ t | _ t
| _ d | _ t
| _ t
| _ t i � | _ t � | _ | j d t � � | j d t � � t t � | _ d S( Ns https://s http://( R R\ R" R� RO R R� R� R; RK R8 RM RN R
RZ R} R Rm R R� t mountR R t REDIRECT_CACHE_SIZERc ( R< ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt __init__3 s c C s | S( N( ( R< ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt __enter__i s c G s | j � d S( N( R[ ( R< t args( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt __exit__l s c C s* | j p i } t | t j � s0 t | � } n t t t � | j � | � } | j } | j r� | r� | j r� t | j
� } n t � } | j d | j
j � d | j
d | j d | j d | j d t | j | j d t �d t | j | j � d t | | j � d
| d t | j | j � �
| S( sb Constructs a :class:`PreparedRequest <PreparedRequest>` for
transmission and returns it. The :class:`PreparedRequest` has settings
merged from the :class:`Request <Request>` instance and those of the
:class:`Session`.
:param request: :class:`Request` instance to prepare with this
session's settings.
R] R_ t filest datat jsonR\ R, R� R� Rm R� ( Rm R& R t CookieJarR R
R R� R} R R_ R t prepareR] t upperR� R� R� R. R\ R R� R3 R� ( R< R| Rm t merged_cookiesR� t p( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt prepare_requesto s* c C s� t | � } t d | j � d | d | d | d | p9 i d | d | pK i d | d | d
| �
} | j | � } | p{ i } | j | j | |
| | � } i | d 6|
d 6} | j | � | j | | � } | S(
sC Constructs a :class:`Request <Request>`, prepares it and sends it.
Returns :class:`Response <Response>` object.
:param method: method for the new :class:`Request` object.
:param url: URL for the new :class:`Request` object.
:param params: (optional) Dictionary or bytes to be sent in the query
string for the :class:`Request`.
:param data: (optional) Dictionary or bytes to send in the body of the
:class:`Request`.
:param json: (optional) json to send in the body of the
:class:`Request`.
:param headers: (optional) Dictionary of HTTP Headers to send with the
:class:`Request`.
:param cookies: (optional) Dict or CookieJar object to send with the
:class:`Request`.
:param files: (optional) Dictionary of ``'filename': file-like-objects``
for multipart encoding upload.
:param auth: (optional) Auth tuple or callable to enable
Basic/Digest/Custom HTTP Auth.
:param timeout: (optional) How long to wait for the server to send
data before giving up, as a float, or a (`connect timeout, read
timeout <user/advanced.html#timeouts>`_) tuple.
:type timeout: float or tuple
:param allow_redirects: (optional) Set to True by default.
:type allow_redirects: bool
:param proxies: (optional) Dictionary mapping protocol to the URL of
the proxy.
:param stream: (optional) whether to immediately download the response
content. Defaults to ``False``.
:param verify: (optional) if ``True``, the SSL cert will be verified.
A CA_BUNDLE path can also be provided.
:param cert: (optional) if String, path to ssl client cert file (.pem).
If Tuple, ('cert', 'key') pair.
R] R_ R\ R� R� R� R� R� Rm R� RL RP ( R R R� R� t merge_environment_settingsR_ R' Rq ( R< R] R_ R� R� R\ Rm R� R� RL RP RO R� RK RM RN R� Rs t prept settingst send_kwargsRr ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyR| � s, 2
c K s# | j d t � | j d | | � S( s� Sends a GET request. Returns :class:`Response` object.
:param url: URL for the new :class:`Request` object.
:param \*\*kwargs: Optional arguments that ``request`` takes.
RP RH ( R� R8 R| ( R< R_ t kwargs( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyR0 � s c K s# | j d t � | j d | | � S( s� Sends a OPTIONS request. Returns :class:`Response` object.
:param url: URL for the new :class:`Request` object.
:param \*\*kwargs: Optional arguments that ``request`` takes.
RP t OPTIONS( R� R8 R| ( R< R_ R� ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt options� s c K s# | j d t � | j d | | � S( s� Sends a HEAD request. Returns :class:`Response` object.
:param url: URL for the new :class:`Request` object.
:param \*\*kwargs: Optional arguments that ``request`` takes.
RP RG ( R� R; R| ( R< R_ R� ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt head� s c K s | j d | d | d | | �S( s� Sends a POST request. Returns :class:`Response` object.
:param url: URL for the new :class:`Request` object.
:param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`.
:param json: (optional) json to send in the body of the :class:`Request`.
:param \*\*kwargs: Optional arguments that ``request`` takes.
RI R� R� ( R| ( R< R_ R� R� R� ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt post s c K s | j d | d | | �S( s7 Sends a PUT request. Returns :class:`Response` object.
:param url: URL for the new :class:`Request` object.
:param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`.
:param \*\*kwargs: Optional arguments that ``request`` takes.
t PUTR� ( R| ( R< R_ R� R� ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt put s c K s | j d | d | | �S( s9 Sends a PATCH request. Returns :class:`Response` object.
:param url: URL for the new :class:`Request` object.
:param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`.
:param \*\*kwargs: Optional arguments that ``request`` takes.
t PATCHR� ( R| ( R< R_ R� R� ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt patch s c K s | j d | | � S( s� Sends a DELETE request. Returns :class:`Response` object.
:param url: URL for the new :class:`Request` object.
:param \*\*kwargs: Optional arguments that ``request`` takes.
t DELETE( R| ( R< R_ R� ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt delete' s c
K sq | j d | j � | j d | j � | j d | j � | j d | j � t | t � sj t d � � n t � } xT | j | j
k r� | j | j � | j
j | j � } | | k r� Pn | | _ qv W| j
d t � } | j d � } | j d � } | j d � } | j d � } | j d � }
| j } | j d | j � } t j � }
| j | | � } t j � |
| _ t d | | | � } | j r�x- | j D] } t | j | j | j � q�Wn t | j | | j � | j | | d | d | d | d | d |
�} | r)g | D] } | ^ qn g } | r]| j d
| � | j
� } | | _ n | sm| j n | S( s Send a given PreparedRequest.RK RM RN RO s# You can only send PreparedRequests.RP RL R_ R/ i ( R� RK RM RN RO R& R t
ValueErrort setR_ Rc t addR0 t popR8 R� t get_adapterR t utcnowRq t elapsedR RU R Rm R| RX Rz t insertRV ( R< R| R� t checked_urlsR> RP RK RL RM RN RO R� t adaptert startt rRr t genRU ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyRq 0 sV
%
c C s� | j r� t | � p i } x* | j � D] \ } } | j | | � q( W| t k s` | d k r� t j j d � p� t j j d � } q� n t | | j
� } t | | j � } t | | j � } t | | j
� } i | d 6| d 6| d 6| d 6S( s6 Check the environment and merge it with some settings.t REQUESTS_CA_BUNDLEt CURL_CA_BUNDLERM RO RK RN N( R} R R( R� R8 R" t ost environR0 R. RO RK RM RN ( R< R_ RO RK RM RN t env_proxiesR$ R% ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyR� s c C sM x6 | j j � D]% \ } } | j � j | � r | Sq Wt d | � � d S( s> Returns the appropriate connnection adapter for the given URL.s* No connection adapters were found for '%s'N( R� R( t lowerR^ R ( R< R_ t prefixR� ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyR� � s c C s( x! | j j � D] } | j � q Wd S( s+ Closes all adapters and as such the sessionN( R� t valuesR[ ( R< R% ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyR[ � s c C so | | j | <g | j D]$ } t | � t | � k r | ^ q } x' | D] } | j j | � | j | <qH Wd S( sk Registers a connection adapter to a prefix.
Adapters are sorted in descending order by key length.N( R� t lenR� ( R< R� R� R$ t keys_to_movet key( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyR� � s
4
c s6 t � f d � � j D� � } t � j � | d <| S( Nc 3 s' | ] } | t � | d � f Vq d S( N( t getattrR" ( R# t attr( R< ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pys <genexpr>� s Rc ( R) t __attrs__Rc ( R< t state( ( R< s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt __getstate__� s c C s| | j d i � } x* | j � D] \ } } t | | | � q Wt t � | _ x' | j � D] \ } } | | j | <q[ Wd S( NRc ( R� R( t setattrR R� Rc ( R< R� Rc R� t valuet redirectt to( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt __setstate__� s N( R� R� t __doc__R� R� R� R� R� R" R8 R| R0 R� R� R� R� R� R� Rq R� R� R[ R� R� R� ( ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyR� sH 6 ) E
O
c C s t � S( s2 Returns a :class:`Session` for context-management.( R� ( ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt session� s (7 R� R� t collectionsR R R� R t compatR R R R Rm R R R R
t modelsR R R
R� R R t utilsR R R R t
exceptionsR R R R t urllib3._collectionsR t
structuresR R� R R R R R R t status_codesR R! R� R. R3 t objectR4 R� R� ( ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt <module>
s. "" ""( ! �� �