ó qJ¿[c@s±dZddlZddlmZddlmZddlmZddlmZm Z m Z m Z m Z ddl mZmZmZmZdd lmZmZdd lmZmZdd lmZmZdd lmZmZdd lmZddl m!Z!ddlm"Z"m#Z#m$Z$m%Z%m&Z&ddl'm(Z(e(j)e(j*e(j+e(j,fZ-dZ.e d„Z/e d„Z0de1fd„ƒYZ2de2fd„ƒYZ3d„Z4dS(s” requests.session ~~~~~~~~~~~~~~~~ This module provides a Session object to manage and persist settings across requests (cookies, auth, proxies). iÿÿÿÿN(tMapping(tdatetimei(t_basic_auth_str(t cookielibt OrderedDictturljointurlparset builtin_str(tcookiejar_from_dicttextract_cookies_to_jartRequestsCookieJart merge_cookies(tRequesttPreparedRequest(t default_hookst dispatch_hook(tto_key_val_listtdefault_headers(tTooManyRedirectst InvalidSchema(tCaseInsensitiveDict(t HTTPAdapter(t requote_uritget_environ_proxiestget_netrc_authtshould_bypass_proxiestget_auth_from_url(tcodesicCsž|dkr|S|dkr |St|tƒo;t|tƒsB|S|t|ƒƒ}|jt|ƒƒx0|jƒD]"\}}|dkrt||=qtqtW|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` N(tNonet isinstanceRRtupdatetitems(trequest_settingtsession_settingt dict_classtmerged_settingtktv((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyt merge_setting*s   cCsZ|dks!|jdƒgkr%|S|dksF|jdƒgkrJ|St|||ƒS(s® Properly merges both requests and session hooks. This is necessary because when request_hooks == {'response': []}, the merge breaks Session hooks entirely. tresponseN(RtgetR&(t request_hookst session_hooksR"((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyt merge_hooksIs !!tSessionRedirectMixincBs;eZd„Zededdd„Zd„Zd„ZRS(cCst|ƒ}t|ƒ}|j|jkr.tS|jdkrn|jdkrn|jdkrn|jdkrntS|j|jkp|j|jkS(sFDecide whether Authorization header should be removed when redirectingthttpiPthttpsi»N(iPN(i»N(RthostnametTruetschemetportRtFalse(tselftold_urltnew_urlt old_parsedt new_parsed((s5/usr/lib/python2.7/dist-packages/requests/sessions.pytshould_strip_authZs  ccs´d}x§d|jkr¯|jtkr¯|jƒ} |j||jkr_td|jƒ‚n|jƒ|jd} |j} | j dƒr³t |j ƒ} d| j | f} nt | ƒ} | j ƒ} t | ƒjsõt|j t| ƒƒ} n t| ƒ} | | _ |jtjkr1| dkr1d} n|jtjkrX| dkrXd} n|jtjkr| dkrd} n| | _|jtjtjfkrËd | jkr¿| jd =nd| _n| j}y |d =Wntk rònXt| j||jƒ| jj|jƒ| j| jƒ|j | |ƒ}|j!| |ƒ| }|j"|d |d |d |d|d|dt#ƒ}t|j| |jƒ|d7}|Vq WdS(s6Receives a Response. Returns a generator of Responses.itlocationsExceeded %s redirects.s//s%s:%stHEADtGETtPOSTsContent-LengthtCookietstreamttimeouttverifytcerttproxiestallow_redirectsiN($theaderst status_codetREDIRECT_STATItcopytcontentt max_redirectsRtclosetmethodt startswithRturlR1tgeturltnetlocRRRt see_othertfoundtmovedt temporarytresumeRtbodytKeyErrorR t_cookiestrawRtcookiestprepare_cookiestrebuild_proxiest rebuild_authtsendR3(R4tresptreqR?R@RARBRCtitprepared_requestRNRLt parsed_rurltparsedRE((s5/usr/lib/python2.7/dist-packages/requests/sessions.pytresolve_redirectsjsh!                    cCs{|j}|j}d|kr@|j|jj|ƒr@|d=n|jrUt|ƒnd}|dk rw|j|ƒndS(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(RERNR9trequestt trust_envRRt prepare_auth(R4RbR'RERNtnew_auth((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyR]Ês  $  c Cs|j}|j}t|ƒj}|dk r9|jƒni}|jrt|ƒ rt|ƒ}|j |ƒ}|r|j |||ƒqnd|kr¦|d=nyt ||ƒ\} } Wnt k rßd\} } nX| r| rt | | ƒ|d>> import requests >>> s = requests.Session() >>> s.get('http://httpbin.org/get') 200 RERZtauthR@RCthookstparamsRARBtprefetchtadaptersR?RhRJcCs¥tƒ|_d|_i|_tƒ|_i|_t|_ t |_ d|_ t |_t |_tiƒ|_tƒ|_|jdtƒƒ|jdtƒƒdS(Nshttps://shttp://(RRERRtRCRRuRvR3R?R0RARBtDEFAULT_REDIRECT_LIMITRJRhRRZRRxtmountR(R4((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyt__init__s           cCs|S(N((R4((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyt __enter__JscGs|jƒdS(N(RK(R4targs((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyt__exit__MscCs!|jp i}t|tjƒs0t|ƒ}ntttƒ|jƒ|ƒ}|j}|jrƒ| rƒ|j rƒt |j ƒ}nt ƒ}|j d|j jƒd|j d|jd|jdt|j|jdtƒdt|j|jƒdt||jƒd |d t|j|jƒƒ |S( sbConstructs a :class:`PreparedRequest ` for transmission and returns it. The :class:`PreparedRequest` has settings merged from the :class:`Request ` instance and those of the :class:`Session`. :param request: :class:`Request` instance to prepare with this session's settings. RLRNtfilestdataRER"RvRtRZRu(RZRRt CookieJarRR R RtRhRRNR tprepareRLtupperRR€R&RERRvR+Ru(R4RgRZtmerged_cookiesRttp((s5/usr/lib/python2.7/dist-packages/requests/sessions.pytprepare_requestPs(       cCs¡t|ƒ}td|jƒd|d|d|d|p9id|pEid|d|d | ƒ }|j|ƒ}| pui} |jrt|ƒpi}x*|jƒD]\}}| j||ƒq W| rè|tk rèt j j d ƒ}n| r|tk rt j j d ƒ}qnt | |j ƒ} t | |jƒ} t ||jƒ}t ||jƒ}i| d 6| d 6|d6|d6| d6| d6}|j||}|S(s)Constructs a :class:`Request `, prepares it and sends it. Returns :class:`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 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) Float describing the timeout of the request. :param allow_redirects: (optional) Boolean. Set to True by default. :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. RLRNRERR€RvRtRZRutREQUESTS_CA_BUNDLEtCURL_CA_BUNDLER?R@RARBRCRD(RR RƒR†RhRRRkR3tostenvironR(R&RCR?RARBR^(R4RLRNRvR€RERZRRtR@RDRCRuR?RARBR`tprept env_proxiesR$R%t send_kwargsR_((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyRgwsD,        cKs#|jdtƒ|jd||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. RDR<(RkR0Rg(R4RNtkwargs((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyR(×scKs#|jdtƒ|jd||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. RDtOPTIONS(RkR0Rg(R4RNRŽ((s5/usr/lib/python2.7/dist-packages/requests/sessions.pytoptionsáscKs#|jdtƒ|jd||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. RDR;(RkR3Rg(R4RNRŽ((s5/usr/lib/python2.7/dist-packages/requests/sessions.pytheadëscKs|jd|d||S(s8Sends 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 \*\*kwargs: Optional arguments that ``request`` takes. R=R€(Rg(R4RNR€RŽ((s5/usr/lib/python2.7/dist-packages/requests/sessions.pytpostõscKs|jd|d||S(s7Sends 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. tPUTR€(Rg(R4RNR€RŽ((s5/usr/lib/python2.7/dist-packages/requests/sessions.pytputÿscKs|jd|d||S(s9Sends 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. tPATCHR€(Rg(R4RNR€RŽ((s5/usr/lib/python2.7/dist-packages/requests/sessions.pytpatch scKs|jd||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. tDELETE(Rg(R4RNRŽ((s5/usr/lib/python2.7/dist-packages/requests/sessions.pytdeletesc Ks|jd|jƒ|jd|jƒ|jd|jƒ|jd|jƒt|tƒsjtdƒ‚n|jdt ƒ}|j dƒ}|j dƒ}|j dƒ}|j dƒ}|j dƒ}|j } |j d|j ƒ} tjƒ} | j||} tjƒ| | _td | | |} | jrdx-| jD]} t|j| j| jƒq>Wnt|j|| jƒ|j| |d|d|d|d|d|ƒ}|rÉg|D]} | ^q·ng}|r|jd | ƒ|jƒ} t|ƒ| _n| S( sSend a given PreparedRequest.R?RARBRCs#You can only send PreparedRequests.RDR@RNR'i(RkR?RARBRCRR t ValueErrortpopR0R(Rut get_adapterRNRtutcnowR^telapsedRthistoryR RZRgRYRetinsertttuple(R4RgRŽRDR?R@RARBRCRutadaptertstarttrR_tgenRž((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyR^s>     % cCsMx6|jjƒD]%\}}|jƒj|ƒr|SqWtd|ƒ‚dS(s>Returns the appropriate connnection adapter for the given URL.s*No connection adapters were found for '%s'N(RxRtlowerRMR(R4RNtprefixR¡((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyR›ZscCs(x!|jjƒD]}|jƒqWdS(s+Closes all adapters and as such the sessionN(RxtvaluesRK(R4R%((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyRKdscCso||j|ss(tdictt __attrs__(R4((R4s5/usr/lib/python2.7/dist-packages/requests/sessions.pyt __getstate__rscCs1x*|jƒD]\}}t|||ƒq WdS(N(Rtsetattr(R4tstateR­tvalue((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyt __setstate__usN(RqRrt__doc__R¯R{R|R~R†RR0RgR(RR‘R’R”R–R˜R^R›RKRzR°R´(((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyRssD   3   ( S >  cCstƒS(s2Returns a :class:`Session` for context-management.(Rs(((s5/usr/lib/python2.7/dist-packages/requests/sessions.pytsessionzs(5RµR‰t collectionsRRRtRtcompatRRRRRRZRR R R tmodelsR R RuRRtutilsRRt exceptionsRRt structuresRRxRRRRRRt status_codesRRSRRtotherttemporary_movedRGRyR&R+tobjectR,RsR¶(((s5/usr/lib/python2.7/dist-packages/requests/sessions.pyt s2 ("(   ¬ÿv