o

;��gw�@sj
dZd
dl
Z
d
dlZd
dlZd
dlmZ
d
dlmZ
ddlm	Z	
ddl
mZ
ddlm
Z

dd	lmZmZmZmZ
dd
lmZmZmZmZ
ddlmZmZmZmZ
ddlmZmZ
dd
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/m0Z0m1Z1m2Z2m3Z3
ej4dkr�ej5Z6nejZ6ef
dd�
Z7ef
dd�
Z8Gdd�d�Z9Gdd�de9�Z:dd�Z;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|
d
ur|S|d
ur|
St|
t
�rt|t
�s|S|t|
�
�
}|�t|�
�

dd�|��D�
}|D]}||=q0|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`
    Nc
Ssg|]
\}
}|dur|
�qS�
N�)�.0�
k�
vr(r(�</usr/local/lib/python3.10/dist-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@|
d
us|
�d�
gkr
|S|d
us|�d�
gkr|
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@sJeZ
dZd
d�Zdd�Z						ddd	�
Zd
d�Zdd
�Zdd�ZdS)�SessionRedirectMixincCs(|
jr|
j
d
}|�d�
}t|d�SdS)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_targetcCs�t|
�
}t|�
}|j
|j
krd
S|jdkr&|jdvr&|jdkr&|jdvr&dS|j|jk}|j|jk}t�|jd�df}|sI|j|vrI|j|vrIdS|pL|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_auths$











�


z&SessionRedirectMixin.should_strip_authFNTc	
ksB�g}
|�|
�
}t
|j�
j}|�
r|��}
|
�|
�

|
d
d�|
_z|
j
Wntt	t
fy9


|
jjdd�

Yn
wt
|
j�
|jkrMtd|j�d�|
d��
|
��
|�d�
ret
|
j�
}d	�t|j�
|g�
}t
|�
}|jd
krw|rw|j|d�
}n|jr}|j}|��}|js�t|
jt|�
�}nt|�
}t|�
|
_|�|
|
�
|
jtjtjfv
r�d}|D]	}|
j� |d�
q�d|
_!|
j}|� d
d�
t"|
j#||
j�
t$|
j#|j%�
|
�&|
j#�

|�'|
|�}|�(|
|
�
|
j)du
o�d|vp�d|v}|r�t*|
�

|
}|r�|V
n |j+|f
|||||dd�|	�
�
}
t"|j%|
|
j�
|�|
�
}|
V
|sdSdS)zBReceives a Response. Returns a generator of Responses or Requests.rNF)
�decode_contentz	Exceeded z redirects.)
r8z//�
:�)
�fragment)�Content-LengthzContent-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_redirects�s��









�

�












�








�


�




��

�z&SessionRedirectMixin.resolve_redirectscCsV|
j}|
j
}d
|vr|�|jj
|�r|d
=|jrt|�
n
d}|du
r)|
�|�

dSdS)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)rDr�r8rBrb�new_authr(r(r,r|
s

�

�z!SessionRedirectMixin.rebuild_authcCs�|
j}t
|
j�
j}t|
||j�}d
|vr|d
=z
t||�
\}}Wn
ty.


d\}}Yn
w|�d�
s?|r?|r?t	||�|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�NNrI)
rBrrbrKr"r�r�KeyErrorrmr)rDr�r`rBrK�new_proxies�username�passwordr(r(r,r{.
s





�
z$SessionRedirectMixin.rebuild_proxiescCsX|
j}|j
tjkr|d
krd}|j
tjkr|d
krd}|j
tjkr'|dkr'd}||
_dS)z�When 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)rDr�r8r�r(r(r,rrM
s



z#SessionRedirectMixin.rebuild_method)FNTNNF)	�__name__�
__module__�__qualname__rFrTr�r|r{rrr(r(r(r,r=js
$





�{r=c@s�eZ
dZd
Zgd�
Zdd�Zdd�Zdd�Zd	d
�Z														d+d
d�
Z	dd�Z
dd�Zdd�Zd,dd�
Z
d-dd�
Zd-dd�
Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�ZdS).�Sessiona�
A 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\r�rkc

Csrt�|_
d|_i|_t�|_i|_d
|_d|_d|_	t
|_d|_t
i�
|_t�|_|�dt��
|�dt��
dS)NFTzhttps://zhttp://)rrBr�r`rr�r�r\r^r_rrkr�r
ryrr��mountr�
rDr(r(r,�__init__�
s



zSession.__init__c


Cs|Sr'r(r�r(r(r,�	__enter__�
s
zSession.__enter__c
Gs|��
dSr')
rl)rD�argsr(r(r,�__exit__�
s
zSession.__exit__c
Cs�|
jpi}t
|tj�st|�
}ttt�|j�|�}|
j}|jr)|s)|js)t	|
j
�
}t�}|j|
j
��|
j
|
j|
j|
jt|
j|jtd
�t|
j|j�t||j�|t|
j|j�d�

|S)a�
Constructs 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)
r�rb�files�data�jsonrBr�r�ryr�)ryr.r	�	CookieJarr
rrr�r�r rbr�preparer��upperr�r�r�r7rBrr�r<r�)rDr�ry�merged_cookiesr��
pr(r(r,�prepare_request�
s2



�











�



�zSession.prepare_requestNTcCsxt|
�
�||||p
i||pi|||d
�
}|�|�
}|pi}|�|j||
||�}|	|
d�}|�|�

|j|f
i|�
�
}|S)a�	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 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
        )
r�rbrBr�r�r�r�r�ryr�)r]ra)rr�r��merge_environment_settingsrbr/r~)rDr�rbr�r�rBryr�r�r]rar`r�r\r^r_r�r�prep�settings�send_kwargsrEr(r(r,r��
s.?









�

�
�

zSession.requestcK� |�d
d�
|j
d|
fi|�
�
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,r9Q�
zSession.getcKr�)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,�options\r�zSession.optionscKr�)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
        raFr�r�r�r(r(r,�headgr�zSession.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,�postrszSession.postcK�|jd
|
fd|i
|�
�
S)au
Sends 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�
zSession.putcKr�)aw
Sends 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,�patch�r�z
Session.patchcKs|jd
|
fi|�
�
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,�delete�szSession.deletec
Ks�
|�d
|j
�
|�d|j�
|�d|j�
d|v
r#t|
|j|j�|d<t|
t�r,t	d�
�
|�
dd�}|�d
�
}|
j}|j
|
jd�
}t�}|j|
f
i|�
�
}t�|}	t|	d	�
|_td
||fi|�
�
}|jrt|jD]}
t|j|
j|
j�
qht|j|
|j�
|r�|j||
fi|�
�
}dd�|D�
}ng}|r�|�d
|�
|�
�}||_|s�zt|j||
fddi
|�
�
�
|_Wn	ty�


Yn
w|s�|j
|S)zISend a given PreparedRequest.

        :rtype: requests.Response
        r\r^r_r`z#You can only send PreparedRequests.raT)
rb)
�secondsr8c
Ssg|]}
|
�qSr(r()r)rEr(r(r,r-�sz Session.send.<locals>.<listcomp>r
r�)r�r\r^r_r"r`r�r.r�
ValueErrorrvr9r��get_adapterrb�preferred_clockr~r�elapsedrrerryr�rhr��insert�next�_next�
StopIterationrf)
rDr�r�rar\r��adapter�start�
rr�rE�genrer(r(r,r~�sN


















�
�
zSession.sendc
Cs�|jr9|d
u
r|�
d�
n
d
}t|
|d�}|��D]
\}}	|�||	�
q|dus+|d
ur9tj�
d�
p8tj�
d�
p8|}t||j�}t||j	�}t||j
�}t||j�}||||d�S)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_)r�r9rr0r��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|
Sqtd
|
���
�
)z~
        Returns the appropriate connection adapter for the given URL.

        :rtype: requests.adapters.BaseAdapter
        z&No connection adapters were found for )r�r0�lowerrmr)rDrb�prefixr�r(r(r,r�
s


�zSession.get_adapterc
Cs|j�
�D]}
|
��
qd
S)z+Closes all adapters and as such the sessionN)r��valuesrl)rDr+r(r(r,rls

�z
Session.closecs>||j�<�f
d
d�|jD�
}|D]}|j�
|�
|j|<qdS)zwRegisters a connection adapter to a prefix.

        Adapters are sorted in descending order by prefix length.
        c
s g|]}
t|
�
t��
kr|
�qSr()
rj)r)r*�
r�r(r,r-%s z!Session.mount.<locals>.<listcomp>N)r�rv)rDr�r��keys_to_mover6r(r�r,r�s



�z
Session.mountc
s�f
d
d��jD�
}
|
S)Nc
si|]	}
|
t�|
d��qSr')
�getattr)r)�attrr�r(r,�
<dictcomp>+sz(Session.__getstate__.<locals>.<dictcomp>)
�	__attrs__)rD�stater(r�r,�__getstate__*s

zSession.__getstate__cCs"|
��D]
\}}t
|||�
qdSr')r0�setattr)rDr�r��valuer(r(r,�__setstate__.s

�zSession.__setstate__)NNNNNNNTNNNNNNr�r')r�r�r��__doc__r�r�r�r�r�r�r9r�r�r�r�r�r�r~r�r�rlr�r�r�r(r(r(r,r�d
sH
=/













�]



M
r�c
Cst�S)
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
    )
r�r(r(r(r,�session3sr�)<r�r��sys�time�collectionsr�datetimer�_internal_utilsrr�rr�r�compatrr	r
rryrr
rr�
exceptionsrrrrr�rr�modelsrrrr�status_codesr�
structuresr�utilsrrrrr r!r"r#r$r%�platform�perf_counterr�r7r<r=r�r�r(r(r(r,�<module>
s:








0


{R