ZhQrdZddlZddlZddlZddlmZddlmZddlm Z ddl m Z m Z m Z mZmZddlmZmZmZmZdd lmZmZmZdd lmZmZdd lmZdd lmZm Z m!Z!dd l"m#Z#m$Z$m%Z%m&Z&ddl'm(Z(ddl)m*Z*ddlm+Z+m,Z,m-Z-m.Z.m/Z/m0Z0ddl1m2Z2ddlm3Z3ejhdk(r ejjZ6n ejZ6efdZ9efdZ:Gdde;Z<Gdde<Z=dZ>y#e7$rejpZ6Y7wxYw)z requests.session ~~~~~~~~~~~~~~~~ This module provides a Session object to manage and persist settings across requests (cookies, auth, proxies). N) timedelta) OrderedDict)_basic_auth_str) cookielibis_py3urljoinurlparseMapping)cookiejar_from_dictextract_cookies_to_jarRequestsCookieJar merge_cookies)RequestPreparedRequestDEFAULT_REDIRECT_LIMIT) default_hooks dispatch_hook)to_native_string)to_key_val_listdefault_headers DEFAULT_PORTS)TooManyRedirects InvalidSchemaChunkedEncodingErrorContentDecodingError)CaseInsensitiveDict) HTTPAdapter) requote_uriget_environ_proxiesget_netrc_authshould_bypass_proxiesget_auth_from_url rewind_body)codes)REDIRECT_STATIwin32c||S||St|trt|ts|S|t|}|jt||j Dcgc] \}}| | }}}|D]}||=|Scc}}w)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` ) isinstancer rupdateitems)request_settingsession_setting dict_classmerged_settingkv none_keyskeys `/mounts/lovelace/software/anaconda3/envs/py312/lib/python3.12/site-packages/requests/sessions.py merge_settingr52s   0  0 @AN//:;"0!5!5!7Ev119EIE  3    Fs ) B4Bc|||jdgk(r|S||jdgk(r|St|||S)zProperly merges both requests and session hooks. This is necessary because when request_hooks == {'response': []}, the merge breaks Session hooks entirely. response)getr5) request_hooks session_hooksr.s r4 merge_hooksr;QsO  1 1* = C 1 1* = C  z BBc6eZdZdZdZ ddZdZdZdZy) SessionRedirectMixinc|jr2|jd}tr|jd}t |dSy)z7Receives a Response. Returns a redirect URI or ``None``locationlatin1utf8N) is_redirectheadersrencoder)selfrespr@s r4get_redirect_targetz(SessionRedirectMixin.get_redirect_targetbs>   ||J/H#??84#Hf5 5r<ct|}t|}|j|jk7ry|jdk(r,|jdvr|jdk(r|jdvry|j|jk7}|j|jk7}t j |jddf}|s|j|vr|j|vry|xs|S)zFDecide whether Authorization header should be removed when redirectingThttp)PNhttps)iNFN)r hostnameschemeportrr8)rFold_urlnew_url old_parsed new_parsed changed_portchanged_scheme default_ports r4should_strip_authz&SessionRedirectMixin.should_strip_authwsg& g&   *"5"5 5    'JOOz,I%%0Z__ 5S"*//9 #**j.?.??%))**;*;TBDI :??l#BOO|3-~-r<Nc +Kg} |j|} t|jj} | r|j } | j || dd|_ |jt|j |jk\r&tdj!|j||j#| j%dr;t|j}dj't)|j*| g} t| }|jd k(r| r|j-| }n|jr |j} |j/} |j0s t3|jt5| } n t5| } t)| | _|j7| ||j8t:j<t:j>fvr,d }|D]}| j@jC|d d| _"| j@}|jCd dtG| jH||jtK| jH|jL| jO| jH|jQ| |}|jS| || jTduxr d |vxsd|v}|r tW| | }|r|nP|jX|f|||||dd| }tG|jL| |j|j|} || ryy#tttf$r |jjdYwxYww)zBReceives a Response. Returns a generator of Responses or Requests.rNF)decode_contentzExceeded {} redirects.)r7z//:)fragment)Content-Lengthz Content-TypeTransfer-EncodingCookier]r^)streamtimeoutverifycertproxiesallow_redirects)-rHr urlr\copyappendhistorycontentrr RuntimeErrorrawreadlen max_redirectsrformatclose startswithjoinrrN_replacegeturlnetlocr rrebuild_method status_coder%temporary_redirectpermanent_redirectrDpopbodyr _cookiesrcookiesprepare_cookiesrebuild_proxies rebuild_auth_body_positionr$send)rFrGreqr`rarbrcrdyield_requestsadapter_kwargshistrfprevious_fragmentprepared_request parsed_rurlparsedpurged_headersheaderrD rewindables r4resolve_redirectsz&SessionRedirectMixin.resolve_redirectss*&&t,$SWW-66"xxz  KK 8DL 4 4<< D$6$66&'?'F'FtGYGY'Zeijj JJL~~d#&txx0 hh 01C1C DcJKc]F"$):2CD$*OO!--/C ==dhh C(89!#&#3C#8     0$ 7(@(@%BZBZ'[[!X,?F$,,00>?(, %&..G KK$ ' ##3#<# M 4 U 3 4s1A!M7$ M0K M7>M70M40M73M44M7c|j}|j}d|vr)|j|jj|r|d=|jr t |nd}||j |yy)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)rDrfrWrequest trust_envr! prepare_auth)rFrr7rDrfnew_auths r4rz!SessionRedirectMixin.rebuild_authsu #**"" g %$*@*@AQAQAUAUWZ*[(+/..>#&d    ) )( 3 r<c||ni}|j}|j}t|j}|j }|j d}t ||}|jrD|sBt||} | j || j d} | r|j|| d|vr|d= t||\} } | r| rt| | |d<|S#t$rd\} } Y%wxYw)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 no_proxyrallzProxy-AuthorizationNN) rDrfr rNrgr8r"rr setdefaultr#KeyErrorr) rFrrdrDrfrN new_proxiesr bypass_proxyenviron_proxiesproxyusernamepasswords r4rz$SessionRedirectMixin.rebuild_proxiess%0'b"**""#%%lln ;;z*,S8D >>,1#IO#''0C0CE0JKE&&vu5 G +-. ,!2;v3F!G Hh -r>`s-*.2BFOTl\4&'R)r<r>ceZdZdZgdZdZdZdZdZ ddZ d Z d Z d Z dd Z dd ZddZdZdZdZdZdZdZdZdZy)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') ) rDr~authrdhooksparamsrbrcadaptersr`rroc^t|_d|_i|_t |_i|_d|_d|_d|_ t|_ d|_ ti|_t|_|j#dt%|j#dt%y)NFTzhttps://zhttp://)rrDrrdrrrr`rbrcrrorr r~rrmountrrFs r4__init__zSession.__init__js '(   #_     4 +2. $   :{}- 9km,r<c|SNrrs r4 __enter__zSession.__enter__s r<c$|jyr)rq)rFargss r4__exit__zSession.__exit__s  r<c|jxsi}t|tjs t |}t t t |j|}|j}|jr#|s!|jst|j}t}|j|jj|j|j|j |j"t%|j&|j&t(t%|j*|j*t%||j|t-|j.|j. |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 )r.) rrffilesdatajsonrDrrr~r)r~r)r CookieJarr rrrrr!rfrpreparerupperrrrr5rDrrr;r)rFrr~merged_cookiesrps r4prepare_requestzSession.prepare_requests //'R'9#6#67)'2G' +-t|| >$tyy!'++.D   >>'') --!'//4<`, 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 long 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 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``. :param cert: (optional) if String, path to ssl client cert file (.pem). If Tuple, ('cert', 'key') pair. :rtype: requests.Response ) rrfrDrrrrrr~r)rare)rrrmerge_environment_settingsrfr*r)rFrrfrrrDr~rrrarerdrr`rbrcrrprepsettings send_kwargsrGs r4rzSession.requestsR<<>t>v>>r<c *|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 DELETErrs r4deletezSession.delete\st||Hc4V44r<c N|jd|j|jd|j|jd|j|jd|jt |t r td|jdd}|jd}|j}|j|j}t}|j|fi|}t|z } t| |_t#d ||fi|}|j$r<|j$D]-} t'|j(| j*| j,/t'|j(||j,|j.||fi|} |r| D cgc]} | c} ng} | r)| j1d || j}| |_|s% t3|j.||fd di||_|s |j8|Scc} w#t6$rY wxYw) zISend a given PreparedRequest. :rtype: requests.Response r`rbrcrdz#You can only send PreparedRequests.reT)rf)secondsr7rr)rr`rbrcrdr)r ValueErrorr{r8r get_adapterrfpreferred_clockrrelapsedrrir r~rrlrinsertnext_next StopIterationrj) rFrrrer`radapterstartrrrGgenris r4rz Session.sendfs (DKK0(DKK0&$)),)T\\2 gw 'BC C!**%6=H% ""w{{"3 ! GLL +F +"#e+g.  *eQ 9& 9 99  M&t||T\\488L M t||Waee<%d$$Q:6:->292Ew{{:.4H-cHEK%++- )A""1a( ) ~**..)=>;**..)9: 6vt{{3vt{{3T499- W r<c|jjD]6\}}|jj|js4|cSt dj |)z~ Returns the appropriate connection adapter for the given URL. :rtype: requests.adapters.BaseAdapter z*No connection adapters were found for {!r})rr+lowerrrrrp)rFrfprefixrs r4rzSession.get_adapters^ "&!4!4!6  VWyy{%%flln5  HOOPSTUUr<cb|jjD]}|jy)z+Closes all adapters and as such the sessionN)rvaluesrq)rFr1s r4rqz Session.closes'%%' A GGI r<c||j|<|jDcgc]}t|t|ks|}}|D]*}|jj||j|<,ycc}w)zwRegisters a connection adapter to a prefix. Adapters are sorted in descending order by prefix length. N)rrnr{)rFrrr0 keys_to_mover3s r4rz Session.mountsj !( f#'==IaCFS[4HI I 8C!%!2!23!7DMM#  8Js A1A1c Z|jDcic]}|t||d}}|Scc}wr) __attrs__getattr)rFattrstates r4 __getstate__zSession.__getstate__s2=A^^LTwtT400LL Ms(cN|jD]\}}t|||yr)r+setattr)rFrrvalues r4 __setstate__zSession.__setstate__s' ;;= 'KD% D$ & 'r<)NNNNNNNTNNNNNNrr)rrr__doc__rrrrrrr8rrrrrrrrrrqrrrrr<r4rrQs$I 5-n&RGKCGBFEN 2 6 3 I = ?5GR: V 8'r<rctS)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 )rrr<r4sessionr s  9r<)?r rsystimedatetimer collectionsrrrcompatrrr r r r~r r rrmodelsrrrrrr_internal_utilsrutilsrrr exceptionsrrrr structuresrrrrr r!r"r#r$ status_codesr%r&platform perf_counterrAttributeErrorclockr5r;objectr>rr rr<r4rs #!AASSDD/-BBQQ,!  #<<7%++iiO@K>:E Cn)6n)b_'"_'D O %**%s! CC21C2