fume-manage-python.git

U  
¡ý°däuã@sldZddlZddlZddlZddlmZddlmZddlm    Z    ddl
mZddlm Z dd    lmZmZmZmZdd
lmZmZmZmZddlmZmZmZmZddlmZmZdd l m!Z!m"Z"m#Z#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3ej4dkr$ej5Z6nejZ6efddZ7efddZ8GdddZ9Gddde9Z:ddZ;dS)z
requests.sessions
~~~~~~~~~~~~~~~~~
 
This module provides a Session object to manage and persist settings across
requests (cookies, auth, proxies).
éN)ÚOrderedDict)Ú    timedeltaé)Úto_native_string)ÚHTTPAdapter)Ú_basic_auth_str)ÚMappingÚ    cookielibÚurljoinÚurlparse)ÚRequestsCookieJarÚcookiejar_from_dictÚextract_cookies_to_jarÚ merge_cookies)ÚChunkedEncodingErrorÚContentDecodingErrorÚ InvalidSchemaÚTooManyRedirects)Ú default_hooksÚ dispatch_hook)ÚDEFAULT_REDIRECT_LIMITÚREDIRECT_STATIÚPreparedRequestÚRequest)Úcodes)ÚCaseInsensitiveDict)
Ú DEFAULT_PORTSÚdefault_headersÚget_auth_from_urlÚget_environ_proxiesÚget_netrc_authÚrequote_uriÚresolve_proxiesÚrewind_bodyÚshould_bypass_proxiesÚto_key_val_listÚwin32cCsp|dkr|S|dkr|St|tr,t|ts0|S|t|}| t|¡dd| ¡D}|D]
}||=q`|S)zè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`
    NcSsg|]\}}|dkr|qS©N©)Ú.0ÚkÚvr(r(úHd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\requests/sessions.pyÚ
<listcomp>Tsz!merge_setting.<locals>.<listcomp>)Ú
isinstancerr%ÚupdateÚitems)Úrequest_settingÚsession_settingÚ
dict_classÚmerged_settingÚ    none_keysÚkeyr(r(r,Ú merge_setting=sÿÿr7cCs@|dks| d¡gkr|S|dks0| d¡gkr4|St|||S)z©Properly merges both requests and session hooks.
 
    This is necessary because when request_hooks == {'response': []}, the
    merge breaks Session hooks entirely.
    NÚresponse)Úgetr7)Ú request_hooksÚ session_hooksr3r(r(r,Úmerge_hooks[s
r<c@s>eZdZddZddZddd    Zd
dZdd ZddZdS)ÚSessionRedirectMixincCs(|jr$|jd}| d¡}t|dSdS)z7Receives a Response. Returns a redirect URI or ``None``ÚlocationÚlatin1Úutf8N)Úis_redirectÚheadersÚencoder)ÚselfÚrespr>r(r(r,Úget_redirect_targetks
 
 
 
z(SessionRedirectMixin.get_redirect_targetcCst|}t|}|j|jkr dS|jdkrL|jdkrL|jdkrL|jdkrLdS|j|jk}|j|jk}t |jd¡df}|s|j|kr|j|krdS|p|S)zFDecide whether Authorization header should be removed when redirectingTÚhttp)éPNÚhttps)i»NFN)rÚhostnameÚschemeÚportrr9)rDÚold_urlÚnew_urlÚ
old_parsedÚ
new_parsedÚchanged_portÚchanged_schemeÚdefault_portr(r(r,Úshould_strip_auths0ÿþýüÿþýz&SessionRedirectMixin.should_strip_authFNTc    
ksJg}
| |¡}t|jj}|rF| ¡} |
 |¡|
dd|_z
|jWn(tt    t
fk
rr|jjddYnXt |j|jkrtd|jd|d| ¡| d¡rÊt|j}d     t|j|g¡}t|}|jd
krî|rî|j|d}n|jrú|j}| ¡}|jst|jt|}nt|}t|| _| | |¡|jtjtjfkrrd}|D]}| j  |d¡qVd| _!| j}|  d d¡t"| j#||jt$| j#|j%|  &| j#¡| '| |¡}| (| |¡| j)dk    oâd|kpâd|k}|ròt*| | }|r|Vq|j+|f|||||dd|    }t"|j%| |j| |¡}|VqdS)zBReceives a Response. Returns a generator of Responses or Requests.rNF)Údecode_contentz    Exceeded z redirects.)r8z//ú:Ú)Úfragment)úContent-LengthzContent-TypeúTransfer-EncodingÚCookierYrZ)ÚstreamÚtimeoutÚverifyÚcertÚproxiesÚallow_redirects),rFrÚurlrXÚcopyÚappendÚhistoryÚcontentrrÚRuntimeErrorÚrawÚreadÚlenÚ max_redirectsrÚcloseÚ
startswithÚjoinrrKÚ_replaceÚgeturlÚnetlocr
r!Úrebuild_methodÚstatus_coderÚtemporary_redirectÚpermanent_redirectrBÚpopÚbodyrÚ_cookiesrÚcookiesÚprepare_cookiesÚrebuild_proxiesÚrebuild_authÚ_body_positionr#Úsend)rDrEÚreqr\r]r^r_r`Úyield_requestsÚadapter_kwargsÚhistrbÚprevious_fragmentÚprepared_requestÚparsed_rurlÚparsedÚpurged_headersÚheaderrBÚ
rewindabler(r(r,Úresolve_redirectss
 
 
ÿ
 
 
þÿÿùø
z&SessionRedirectMixin.resolve_redirectscCsR|j}|j}d|kr*| |jj|¡r*|d=|jr8t|nd}|dk    rN| |¡dS)zé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.
        Ú AuthorizationN)rBrbrTÚrequestÚ    trust_envr Úprepare_auth)rDrr8rBrbÚnew_authr(r(r,r|sÿz!SessionRedirectMixin.rebuild_authcCsz|j}t|jj}t|||j}d|kr.|d=zt||\}}Wntk
r^d\}}YnX|rv|rvt|||d<|S)a°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.
 
        :rtype: dict
        zProxy-Authorization)NN)    rBrrbrKr"rrÚKeyErrorr)rDrr`rBrKÚnew_proxiesÚusernameÚpasswordr(r(r,r{/sz$SessionRedirectMixin.rebuild_proxiescCsX|j}|jtjkr|dkrd}|jtjkr6|dkr6d}|jtjkrN|dkrNd}||_dS)zWhen being redirected we may want to change the method of the request
        based on certain specs or browser behavior.
        ÚHEADÚGETÚPOSTN)ÚmethodrsrÚ    see_otherÚfoundÚmoved)rDrr8rr(r(r,rrLsz#SessionRedirectMixin.rebuild_method)FNTNNF)    Ú__name__Ú
__module__Ú__qualname__rFrTrr|r{rrr(r(r(r,r=js$÷
|r=c@sÌeZdZdZdddddddd    d
ddd gZddZddZddZddZd6ddZ    ddZ
ddZddZd7d d!Z d8d"d#Zd9d$d%Zd&d'Zd(d)Zd*d+Zd,d-Zd.d/Zd0d1Zd2d3Zd4d5ZdS):ÚSessionaA Requests session.
 
    Provides cookie persistence, connection-pooling, and configuration.
 
    Basic Usage::
 
      >>> import requests
      >>> s = requests.Session()
      >>> s.get('https://httpbin.org/get')
      <Response [200]>
 
    Or as a context manager::
 
      >>> with requests.Session() as s:
      ...     s.get('https://httpbin.org/get')
      <Response [200]>
    rBryÚauthr`ÚhooksÚparamsr^r_Úadaptersr\rrkcCsrt|_d|_i|_t|_i|_d|_d|_d|_    t
|_d|_t i|_t|_| dt¡| dt¡dS)NFTzhttps://zhttp://)rrBrr`rr r¡r\r^r_rrkrr ryrr¢Úmountr©rDr(r(r,Ú__init__s
 
zSession.__init__cCs|Sr'r(r¤r(r(r,Ú    __enter__ÃszSession.__enter__cGs| ¡dSr')rl)rDÚargsr(r(r,Ú__exit__ÆszSession.__exit__c Cs²|jpi}t|tjst|}ttt|j|}|j}|jrR|sR|jsRt    |j
}t}|j|j  ¡|j
|j|j|jt|j|jtdt|j|jt||j|t|j|jd
|S)aConstructs 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.
        :rtype: requests.PreparedRequest
        )r3)
rrbÚfilesÚdataÚjsonrBr¡rryr )ryr.r    Ú    CookieJarr rrrrr rbrÚpreparerÚupperr©rªr«r7rBrr¡r<r )rDrryÚmerged_cookiesrÚpr(r(r,Úprepare_requestÉs8
 
ÿ
ÿ
ôzSession.prepare_requestNTcCstt| ¡||||pi||pi|||d
}| |¡}|p8i}| |j|| ||¡}|    |
d}| |¡|j|f|}|S)aw    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, list of tuples, 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 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 :ref:`(connect timeout,
            read timeout) <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 or protocol and
            hostname to the URL of the proxy.
        :param stream: (optional) whether to immediately download the response
            content. Defaults to ``False``.
        :param verify: (optional) Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use. Defaults to ``True``. When set to
            ``False``, requests will accept any TLS certificate presented by
            the server, and will ignore hostname mismatches and/or expired
            certificates, which will make your application vulnerable to
            man-in-the-middle (MitM) attacks. Setting verify to ``False``
            may be useful during local development or testing.
        :param cert: (optional) if String, path to ssl client cert file (.pem).
            If Tuple, ('cert', 'key') pair.
        :rtype: requests.Response
        )
rrbrBr©rªr«r¡rryr )r]ra)rr®r±Úmerge_environment_settingsrbr/r~)rDrrbr¡rªrBryr©rr]rar`r r\r^r_r«rÚprepÚsettingsÚsend_kwargsrEr(r(r,rôs6=ö
ÿþ
zSession.requestcKs| dd¡|jd|f|S)zåSends a GET request. Returns :class:`Response` object.
 
        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        raTr©Ú
setdefaultr©rDrbÚkwargsr(r(r,r9OszSession.getcKs| dd¡|jd|f|S)zéSends a OPTIONS request. Returns :class:`Response` object.
 
        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        raTÚOPTIONSr¶r¸r(r(r,ÚoptionsZszSession.optionscKs| dd¡|jd|f|S)zæSends a HEAD request. Returns :class:`Response` object.
 
        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        raFrr¶r¸r(r(r,ÚheadeszSession.headcKs|jd|f||d|S)aÈSends a POST request. Returns :class:`Response` object.
 
        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, 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.
        :rtype: requests.Response
        r)rªr«©r)rDrbrªr«r¹r(r(r,ÚpostpszSession.postcKs|jd|fd|i|S)auSends a PUT request. Returns :class:`Response` object.
 
        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        ÚPUTrªr½©rDrbrªr¹r(r(r,Úput}s
zSession.putcKs|jd|fd|i|S)awSends a PATCH request. Returns :class:`Response` object.
 
        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        ÚPATCHrªr½rÀr(r(r,Úpatchs
z Session.patchcKs|jd|f|S)zèSends a DELETE request. Returns :class:`Response` object.
 
        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        ÚDELETEr½r¸r(r(r,ÚdeleteszSession.deletec Ks| d|j¡| d|j¡| d|j¡d|krFt||j|j|d<t|trXt    d| 
dd¡}| d¡}|j}|j |jd}t}|j|f|}t|}    t|    d    |_td
||f|}|jrà|jD]}
t|j|
j|
jqÈt|j||j|r|j||f|}dd|D}ng}|r:| d |¡| 
¡}||_|szz"t|j||fddi||_Wntk
rxYnX|s|j|S)zISend a given PreparedRequest.
 
        :rtype: requests.Response
        r\r^r_r`z#You can only send PreparedRequests.raT)rb)Úsecondsr8cSsg|]}|qSr(r()r)rEr(r(r,r-Ósz Session.send.<locals>.<listcomp>rr)r·r\r^r_r"r`rr.rÚ
ValueErrorrvr9r Úget_adapterrbÚpreferred_clockr~rÚelapsedrrerryrrhrÚinsertÚnextÚ_nextÚ StopIterationrf) rDrr¹rar\r ÚadapterÚstartÚrrÊrEÚgenrer(r(r,r~sL
 
 
 
ÿ
zSession.sendc
Cs°|jrr|dk    r| d¡nd}t||d}| ¡D]\}}    | ||    ¡q0|dksV|dkrrtj d¡pptj d¡pp|}t||j}t||j    }t||j
}t||j}||||dS)z^
        Check the environment and merge it with some settings.
 
        :rtype: dict
        NÚno_proxy)rÓTÚREQUESTS_CA_BUNDLEÚCURL_CA_BUNDLE)r`r\r^r_)rr9rr0r·ÚosÚenvironr7r`r\r^r_)
rDrbr`r\r^r_rÓÚenv_proxiesr*r+r(r(r,r²ís 
ÿýz"Session.merge_environment_settingscCs@|j ¡D]"\}}| ¡ | ¡¡r
|Sq
td|dS)z~
        Returns the appropriate connection adapter for the given URL.
 
        :rtype: requests.adapters.BaseAdapter
        z&No connection adapters were found for N)r¢r0Úlowerrmr)rDrbÚprefixrÏr(r(r,rÈs
zSession.get_adaptercCs|j ¡D]}| ¡q
dS)z+Closes all adapters and as such the sessionN)r¢Úvaluesrl)rDr+r(r(r,rlsz Session.closecs>||j<fdd|jD}|D]}|j |¡|j|<q"dS)zwRegisters a connection adapter to a prefix.
 
        Adapters are sorted in descending order by prefix length.
        cs g|]}t|tkr|qSr()rj)r)r*©rÚr(r,r-%sz!Session.mount.<locals>.<listcomp>N)r¢rv)rDrÚrÏÚkeys_to_mover6r(rÜr,r£s
z Session.mountcsfddjD}|S)Ncsi|]}|t|dqSr')Úgetattr)r)Úattrr¤r(r,Ú
<dictcomp>+sz(Session.__getstate__.<locals>.<dictcomp>)Ú    __attrs__)rDÚstater(r¤r,Ú__getstate__*szSession.__getstate__cCs"| ¡D]\}}t|||qdSr')r0Úsetattr)rDrârßÚvaluer(r(r,Ú__setstate__.szSession.__setstate__)NNNNNNNTNNNNNN)NN)N)N)rrrÚ__doc__rár¥r¦r¨r±rr9r»r¼r¾rÁrÃrÅr~r²rÈrlr£rãrær(r(r(r,rcs^ô>/ï
[
 
 
 
NrcCstS)aZ
    Returns a :class:`Session` for context-management.
 
    .. deprecated:: 1.0.0
 
        This method has been deprecated since version 1.0.0 and is only kept for
        backwards compatibility. New code should use :class:`~requests.sessions.Session`
        to create a session. This may be removed at a future date.
 
    :rtype: Session
    )rr(r(r(r,Úsession3srè)<rçrÖÚsysÚtimeÚcollectionsrÚdatetimerÚ_internal_utilsrr¢rrrÚcompatrr    r
rryrr rrÚ
exceptionsrrrrr rrÚmodelsrrrrÚstatus_codesrÚ
structuresrÚutilsrrrrr r!r"r#r$r%ÚplatformÚperf_counterrÉr7r<r=rrèr(r(r(r,Ú<module>s80zS