ó ú—7Tc@sµdZddlZddlmZddlmZddlmZddlmZm Z m Z m Z m Z ddl mZmZmZmZdd lmZmZmZdd lmZmZdd lmZmZmZdd lmZmZm Z m!Z!dd l"m#Z#ddl$m%Z%ddlm&Z&m'Z'm(Z(m)Z)m*Z*ddl+m,Z,ddlm-Z-e d„Z.e d„Z/de0fd„ƒYZ1de1fd„ƒYZ2d„Z3dS(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(tRequesttPreparedRequesttDEFAULT_REDIRECT_LIMIT(t default_hookst dispatch_hook(tto_key_val_listtdefault_headerstto_native_string(tTooManyRedirectst InvalidSchematChunkedEncodingErrortContentDecodingError(tCaseInsensitiveDict(t HTTPAdapter(t requote_uritget_environ_proxiestget_netrc_authtshould_bypass_proxiestget_auth_from_url(tcodes(tREDIRECT_STATIcCsº|dkr|S|dkr |St|tƒo;t|tƒsB|S|t|ƒƒ}|jt|ƒƒx0|jƒD]"\}}|dkrt||=qtqtWtd„|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` css-|]#\}}|dk r||fVqdS(N(tNone(t.0tktv((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pys CsN(R!t isinstanceRRtupdatetitemstdict(trequest_settingtsession_settingt dict_classtmerged_settingR#R$((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/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(R!tgetR-(t request_hookst session_hooksR+((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyt merge_hooksHs !!tSessionRedirectMixincBs2eZededdd„Zd„Zd„ZRS(ccsÙd}xÌ|jrÔ|jƒ} y |jWn-tttfk rX|jjdtƒnX||j kr~t d|j ƒ‚n|j ƒ|j d} |j } | jdƒrÒt|jƒ} d| j| f} nt| ƒ} | jƒ} t| ƒjst|jt| ƒƒ} n t| ƒ} t| ƒ| _|jtjkrV| dkrVd} n|jtjkr}| dkr}d} n|jtjkr¤| d kr¤d} n| | _ |jtjtjfkrðd | j krä| j d =nd| _n| j }y |d =Wnt k rnXt!| j"| |jƒ| j"j#|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.itdecode_contentsExceeded %s redirects.tlocations//s%s:%stHEADtGETtPOSTsContent-LengthtCookietstreamttimeouttverifytcerttproxiestallow_redirectsiN()t is_redirecttcopytcontentRRt RuntimeErrortrawtreadtFalset max_redirectsRtclosetheaderstmethodt startswithRturltschemetgeturltnetlocRRRt status_codeRt see_othertfoundtmovedt temporarytresumeR!tbodytKeyErrorR t_cookiesR&tcookiestprepare_cookiestrebuild_proxiest rebuild_authtsend(tselftresptreqR:R;R<R=R>titprepared_requestRLRJt parsed_rurltparsedRI((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pytresolve_redirectsYsn                     cCs–|j}|j}d|kr[t|jjƒ}t|ƒ}|j|jkr[|d=q[n|jrpt|ƒnd}|dk r’|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( RIRLRtrequestthostnamet trust_envRR!t prepare_auth(R^RbR.RIRLtoriginal_parsedtredirect_parsedtnew_auth((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/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 | | ƒ|dRIRLRMt new_proxiestenviron_proxiestproxytusernametpassword((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyR[Ôs$       N(t__name__t __module__RFR!tTrueReR\R[(((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyR3Xsa tSessioncBseZdZddddddddd d d d d dgZd„Zd„Zd„Zd„Zd!d!d!d!d!d!d!e d!d!d!d!d!d„ Z d„Z d„Z d„Z d!d„Zd!d„Zd!d„Zd„Zd„Zd„Zd„Zd„Zd„Zd „ZRS("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 RIRYtauthR;R>thookstparamsR<R=tprefetchtadaptersR:RiRGcCs¥tƒ|_d|_i|_tƒ|_i|_t|_ t |_ d|_ t |_t |_tiƒ|_tƒ|_|jdtƒƒ|jdtƒƒdS(Nshttps://shttp://(RRIR!RxR>RRyRzRFR:RvR<R=RRGRiRRYRR|tmountR(R^((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyt__init__ s           cCs|S(N((R^((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyt __enter__?scGs|jƒdS(N(RH(R^targs((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyt__exit__BscCs!|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. RJRLtfilestdataRIR+RzRxRYRy(RYR%Rt CookieJarRR R RxRiRRLR tprepareRJtupperR‚RƒR-RIRRzR2Ry(R^RgRYtmerged_cookiesRxtp((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pytprepare_requestEs(       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(s4Constructs 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 in seconds. :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. RJRLRIR‚RƒRzRxRYRytREQUESTS_CA_BUNDLEtCURL_CA_BUNDLER:R;R<R=R>R?(RR R†R‰RiRR'RnRFtostenvironR/R-R>R:R<R=R](R^RJRLRzRƒRIRYR‚RxR;R?R>RyR:R<R=R`tprept env_proxiesR#R$t send_kwargsR_((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyRglsD,        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. R?R7(RnRvRg(R^RLtkwargs((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/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. R?tOPTIONS(RnRvRg(R^RLR‘((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/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. R?R6(RnRFRg(R^RLR‘((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/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. R8Rƒ(Rg(R^RLRƒR‘((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/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(R^RLRƒR‘((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/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(R^RLRƒR‘((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/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(R^RLR‘((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/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ƒ} || _n|s | jn| S( sSend a given PreparedRequest.R:R<R=R>s#You can only send PreparedRequests.R?R;RLR.i(RnR:R<R=R>R%R t ValueErrortpopRvR/Ryt get_adapterRLRtutcnowR]telapsedRthistoryR RYRgRDRetinsertRB(R^RgR‘R?R:R;R<R=R>RytadaptertstarttrR_tgenR¡((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyR]sH     %   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(R|R'tlowerRKR(R^RLtprefixR£((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyRžXscCs(x!|jjƒD]}|jƒqWdS(s+Closes all adapters and as such the sessionN(R|tvaluesRH(R^R$((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyRHbscCso||j|ss(R(t __attrs__(R^((R^sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyt __getstate__rscCs1x*|jƒD]\}}t|||ƒq WdS(N(R'tsetattr(R^tstateR®tvalue((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyt __setstate__usN(RtRut__doc__R¯R~RRR‰R!RvRgR/R“R”R•R—R™R›R]RžRHR}R°R´(((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyRwúsD   3   ( S G  cCstƒS(s2Returns a :class:`Session` for context-management.(Rw(((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pytsessionzs(4RµRŒt collectionsRRRxRtcompatRRRRRRYRR R R tmodelsR R RRyRRtutilsRRRt exceptionsRRRRt structuresRR|RRRRRRt status_codesRR R-R2tobjectR3RwR¶(((sL/var/www/otrsdash.zarafa.com/venv/build/pip/pip/_vendor/requests/sessions.pyt s* (""( ! ¢ÿ