a Bi'w@sldZddlZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z dd lmZmZmZmZdd lmZmZmZmZdd lmZmZmZmZdd lmZmZdd 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 cookieliburljoinurlparse)RequestsCookieJarcookiejar_from_dictextract_cookies_to_jar merge_cookies)ChunkedEncodingErrorContentDecodingError InvalidSchemaTooManyRedirects) default_hooks dispatch_hook)DEFAULT_REDIRECT_LIMITREDIRECT_STATIPreparedRequestRequest)codes)CaseInsensitiveDict) DEFAULT_PORTSdefault_headersget_auth_from_urlget_environ_proxiesget_netrc_auth requote_uriresolve_proxies rewind_bodyshould_bypass_proxiesto_key_val_listwin32cCsp|dur |S|dur|St|tr,t|ts0|S|t|}|t|dd|D}|D] }||=q`|S)zDetermines 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|]\}}|dur|qSN).0kvr(r(N/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/requests/sessions.py Tz!merge_setting..) isinstancerr%updateitems)request_settingsession_setting dict_classmerged_setting none_keyskeyr(r(r, merge_setting=s r8cCs@|dus|dgkr|S|dus0|dgkr4|St|||S)zProperly merges both requests and session hooks. This is necessary because when request_hooks == {'response': []}, the merge breaks Session hooks entirely. Nresponse)getr8) request_hooks session_hooksr4r(r(r, merge_hooks[s r=c@s>eZdZddZddZddd Zd d Zd d ZddZdS)SessionRedirectMixincCs(|jr$|jd}|d}t|dSdS)z7Receives a Response. Returns a redirect URI or ``None``locationlatin1utf8N) is_redirectheadersencoder)selfrespr?r(r(r,get_redirect_targetks    z(SessionRedirectMixin.get_redirect_targetcCst|}t|}|j|jkr dS|jdkrL|jdvrL|jdkrL|jdvrLdS|j|jk}|j|jk}t|jddf}|s|j|vr|j|vrdS|p|S)zFDecide whether Authorization header should be removed when redirectingThttp)PNhttps)iNFN)r hostnameschemeportrr:)rEold_urlnew_url old_parsed new_parsed changed_portchanged_scheme default_portr(r(r,should_strip_auths0   z&SessionRedirectMixin.should_strip_authFNTc  ksHg} ||} t|jj} | rD|} | || dd|_z |jWn&tt t fyp|j j ddYn0t |j|jkrtd|jd|d|| drt|j}d t|j| g} t| }|jd kr| r|j| d }n |jr|j} |} |jst|jt| } nt| } t| | _|| ||jtjtjfvrpd }|D]}| j |dqTd| _!| j}| d dt"| j#||j t$| j#|j%| &| j#|'| |}|(| || j)duod|vpd|v}|rt*| | }|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.)r9z//:)fragment)Content-Lengthz Content-TypeTransfer-EncodingCookierZr[)streamtimeoutverifycertproxiesallow_redirects),rGr urlrYcopyappendhistorycontentrr RuntimeErrorrawreadlen max_redirectsrclose startswithjoinrrL_replacegeturlnetlocr r!rebuild_method status_codertemporary_redirectpermanent_redirectrCpopbodyr_cookiesrcookiesprepare_cookiesrebuild_proxies rebuild_auth_body_positionr#send)rErFreqr]r^r_r`rayield_requestsadapter_kwargshistrcprevious_fragmentprepared_request parsed_rurlparsedpurged_headersheaderrC rewindabler(r(r,resolve_redirectss               z&SessionRedirectMixin.resolve_redirectscCsR|j}|j}d|vr*||jj|r*|d=|jr8t|nd}|durN||dS)zWhen 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)rCrcrUrequest trust_envr prepare_auth)rErr9rCrcnew_authr(r(r,r}s z!SessionRedirectMixin.rebuild_authcCs|j}t|jj}t|||j}d|vr.|d=zt||\}}Wnty\d\}}Yn0|ds~|r~|r~t |||d<|S)aThis 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)NNrJ) rCr rcrLr"rrKeyErrorrnr)rErrarCrL new_proxiesusernamepasswordr(r(r,r|.s   z$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. HEADGETPOSTN)methodrtr see_otherfoundmoved)rErr9rr(r(r,rsMsz#SessionRedirectMixin.rebuild_method)FNTNNF) __name__ __module__ __qualname__rGrUrr}r|rsr(r(r(r,r>js$ {r>c@seZdZdZgdZddZddZddZd d Zd+d dZ ddZ ddZ ddZ d,ddZ d-ddZd.ddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd S)/SessionaA Requests session. Provides cookie persistence, connection-pooling, and configuration. Basic Usage:: >>> import requests >>> s = requests.Session() >>> s.get('https://httpbin.org/get') Or as a context manager:: >>> with requests.Session() as s: ... s.get('https://httpbin.org/get') ) rCrzauthrahooksparamsr_r`adaptersr]rrlcCsrt|_d|_i|_t|_i|_d|_d|_d|_ t |_ d|_ t i|_t|_|dt|dtdS)NFTzhttps://zhttp://)rrCrrarrrr]r_r`rrlrr rzrrmountrrEr(r(r,__init__s  zSession.__init__cCs|Sr'r(rr(r(r, __enter__szSession.__enter__cGs |dSr')rm)rEargsr(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 ` 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. :rtype: requests.PreparedRequest )r4) rrcfilesdatajsonrCrrrzr)rzr/r CookieJarr rr rrr rcrpreparerupperrrrr8rCrrr=r)rErrzmerged_cookiesrpr(r(r,prepare_requests2       zSession.prepare_requestNTc Csxt|||||pi||pi||| d }||}| p8i} ||j| | ||}| | d}|||j|fi|}|S)a 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, 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 many seconds to wait for the server to send data before giving up, as a float, or a :ref:`(connect timeout, read timeout) ` 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 hooks: (optional) Dictionary mapping hook name to one event or list of events, event must be callable. :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 ) rrcrCrrrrrrzr)r^rb)rrrmerge_environment_settingsrcr0r)rErrcrrrCrzrrr^rbrarr]r_r`rrprepsettings send_kwargsrFr(r(r,rs.?   zSession.requestcKs |dd|jd|fi|S)zSends 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 rbTr setdefaultrrErckwargsr(r(r,r:Qs z Session.getcKs |dd|jd|fi|S)zSends 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 rbTOPTIONSrrr(r(r,options\s zSession.optionscKs |dd|jd|fi|S)zSends 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 rbFrrrr(r(r,headgs z Session.headcKs|jd|f||d|S)aSends 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)rrr)rErcrrrr(r(r,postrs z Session.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 PUTrrrErcrrr(r(r,puts z Session.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 PATCHrrrr(r(r,patchs z Session.patchcKs|jd|fi|S)zSends 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 DELETErrr(r(r,deleteszSession.deletec Ks|d|j|d|j|d|jd|vrFt||j|j|d<t|trXt d| dd}| d}|j }|j |jd}t}|j|fi|}t|} t| d |_td ||fi|}|jr|jD]} t|j| j| jqt|j||j|r"|j||fi|} d d | D} ng} | rF| d || }| |_|sz"t|j||fddi||_WntyYn0|s|j|S)zISend a given PreparedRequest. :rtype: requests.Response r]r_r`raz#You can only send PreparedRequests.rbT)rc)secondsr9cSsg|]}|qSr(r()r)rFr(r(r,r-r.z Session.send..rr)rr]r_r`r"rarr/r ValueErrorrwr:r get_adapterrcpreferred_clockrrelapsedrrfrrzrririnsertnext_next StopIterationrg) rErrrbr]radapterstartrrrFgenrfr(r(r,rsL        z Session.sendc Cs|jrr|dur|dnd}t||d}|D]\}} ||| q0|dusV|durrtjdpptjdpp|}t||j}t||j }t||j }t||j }||||dS)z^ Check the environment and merge it with some settings. :rtype: dict Nno_proxy)rTREQUESTS_CA_BUNDLECURL_CA_BUNDLE)rar]r_r`) rr:rr1rosenvironr8rar]r_r`) rErcrar]r_r`r env_proxiesr*r+r(r(r,rs        z"Session.merge_environment_settingscCs@|jD]"\}}||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)rr1lowerrnr)rErcprefixrr(r(r,r s zSession.get_adaptercCs|jD] }|q dS)z+Closes all adapters and as such the sessionN)rvaluesrm)rEr+r(r(r,rmsz 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()rk)r)r*rr(r,r-%r.z!Session.mount..N)rrw)rErr keys_to_mover7r(rr,rs z Session.mountcsfddjD}|S)Ncsi|]}|t|dqSr')getattr)r)attrrr(r, +r.z(Session.__getstate__..) __attrs__)rEstater(rr, __getstate__*szSession.__getstate__cCs"|D]\}}t|||qdSr')r1setattr)rErrvaluer(r(r, __setstate__.szSession.__setstate__)NNNNNNNTNNNNNN)NN)N)N)rrr__doc__rrrrrrr:rrrrrrrrrrmrrrr(r(r(r,rdsF=/ ]    M  rcCstS)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,session3s r)rrr(r(r(r,s8       0   {R