Current File : //lib/python3.9/site-packages/pip/_vendor/requests/__pycache__/sessions.cpython-39.pyc
a

[��f�u�@s�dZddlZddlZddlZddlmZddlmZddlm	Z	ddl
mZmZm
Z
mZmZddlmZmZmZmZdd	lmZmZmZdd
lmZmZddlmZddlmZm 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/m0Z0ddl1m2Z2ddlm3Z3ej4dk�rTz
ej5Z6Wne7�yPej8Z6Yn0nejZ6efdd�Z9efdd�Z:Gdd�de;�Z<Gdd�de<�Z=dd�Z>dS)z�
requests.sessions
~~~~~~~~~~~~~~~~~

This module provides a Session object to manage and persist settings across
requests (cookies, auth, proxies).
�N)�	timedelta)�OrderedDict�)�_basic_auth_str)�	cookielib�is_py3�urljoin�urlparse�Mapping)�cookiejar_from_dict�extract_cookies_to_jar�RequestsCookieJar�
merge_cookies)�Request�PreparedRequest�DEFAULT_REDIRECT_LIMIT)�
default_hooks�
dispatch_hook)�to_native_string)�to_key_val_list�default_headers�
DEFAULT_PORTS)�TooManyRedirects�
InvalidSchema�ChunkedEncodingError�ContentDecodingError)�CaseInsensitiveDict)�HTTPAdapter)�requote_uri�get_environ_proxies�get_netrc_auth�should_bypass_proxies�get_auth_from_url�rewind_body)�codes)�REDIRECT_STATI�win32cCsp|dur|S|dur|St|t�r,t|t�s0|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|]\}}|dur|�qS�N�)�.0�k�vr(r(�A/usr/lib/python3.9/site-packages/pip/_vendor/requests/sessions.py�
<listcomp>J�z!merge_setting.<locals>.<listcomp>)�
isinstancer
r�update�items)Zrequest_settingZsession_setting�
dict_classZmerged_settingZ	none_keys�keyr(r(r,�
merge_setting2s��r4cCs@|dus|�d�gkr|S|dus0|�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)�getr4)Z
request_hooksZ
session_hooksr2r(r(r,�merge_hooksQs
r7c@s>eZdZdd�Zdd�Zddd	�Zd
d�Zdd
�Zdd�ZdS)�SessionRedirectMixincCs,|jr(|jd}tr|�d�}t|d�SdS)z7Receives a Response. Returns a redirect URI or ``None``�location�latin1�utf8N)Zis_redirect�headersr�encoder)�self�respr9r(r(r,�get_redirect_targetbs


z(SessionRedirectMixin.get_redirect_targetcCs�t|�}t|�}|j|jkr dS|jdkrL|jdvrL|jdkrL|jdvrLdS|j|jk}|j|jk}t�|jd�df}|s�|j|vr�|j|vr�dS|p�|S)zFDecide whether Authorization header should be removed when redirectingT�http)�PN�https)i�NFN)r	�hostname�scheme�portrr6)r>Zold_urlZnew_urlZ
old_parsedZ
new_parsedZchanged_portZchanged_schemeZdefault_portr(r(r,�should_strip_authws$���z&SessionRedirectMixin.should_strip_authFNTc	
ksFg}
|�|�}t|j�j}|�rB|��}
|
�|�|
dd�|_z
|jWn&tt	t
fyp|jjdd�Yn0t
|j�|jkr�td�|j�|d��|��|�d�r�t|j�}d�t|j�|g�}t|�}|jd	kr�|r�|j|d
�}n|jr�|j}|��}|j�st|jt|��}nt|�}t|�|
_|�|
|�|jtjtjfv�rnd}|D]}|
j �!|d��qRd|
_"|
j }|�!dd�t#|
j$||j�t%|
j$|j&�|
�'|
j$�|�(|
|�}|�)|
|�|
j*du�o�d
|v�p�d|v}|�r�t+|
�|
}|�r|Vq|j,|f|||||dd�|	��}t#|j&|
|j�|�|�}|VqdS)zBReceives a Response. Returns a generator of Responses or Requests.rNF)Zdecode_contentzExceeded {} redirects.)r5z//�:�)�fragment)�Content-LengthzContent-Type�Transfer-EncodingZCookierKrL)�stream�timeout�verify�cert�proxies�allow_redirects)-r@r	�urlrJ�copy�append�history�contentrr�RuntimeError�raw�read�len�
max_redirectsr�format�close�
startswith�joinrrE�_replace�geturl�netlocrr�rebuild_method�status_coder$Ztemporary_redirectZpermanent_redirectr<�pop�bodyrZ_cookiesr�cookiesZprepare_cookies�rebuild_proxies�rebuild_authZ_body_positionr#�send)r>r?�reqrMrNrOrPrQ�yield_requestsZadapter_kwargsZhistrSZprevious_fragment�prepared_requestZparsed_rurl�parsedZpurged_headers�headerr<Z
rewindabler(r(r,�resolve_redirects�s~





����
z&SessionRedirectMixin.resolve_redirectscCsR|j}|j}d|vr*|�|jj|�r*|d=|jr8t|�nd}|durN|�|�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.
        Z
AuthorizationN)r<rSrG�request�	trust_envr Zprepare_auth)r>rnr5r<rSZnew_authr(r(r,rj�sz!SessionRedirectMixin.rebuild_authc
Cs�|dur|ni}|j}|j}t|�j}|��}|�d�}t||d�}|jr||s|t||d�}	|	�||	�d��}
|
r||�	||
�d|vr�|d=zt
||�\}}Wnty�d\}}Yn0|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
        N�no_proxy�rt�allzProxy-Authorization)NN)
r<rSr	rErTr6r!rsr�
setdefaultr"�KeyErrorr)
r>rnrQr<rSrEZnew_proxiesrtZbypass_proxyZenviron_proxies�proxy�username�passwordr(r(r,ris*


z$SessionRedirectMixin.rebuild_proxiescCsX|j}|jtjkr|dkrd}|jtjkr6|dkr6d}|jtjkrN|dkrNd}||_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)�methodrer$Z	see_other�foundZmoved)r>rnr5rr(r(r,rd:sz#SessionRedirectMixin.rebuild_method)FNTNNF)	�__name__�
__module__�__qualname__r@rGrqrjrirdr(r(r(r,r8`s�
n)r8c@s�eZdZdZgd�Zdd�Zdd�Zdd�Zd	d
�Zd+d
d�Z	dd�Z
dd�Zdd�Zd,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]>
    )r<rh�authrQ�hooks�paramsrOrP�adaptersrMrsr\cCsrt�|_d|_i|_t�|_i|_d|_d|_d|_	t
|_d|_t
i�|_t�|_|�dt��|�dt��dS)NFTzhttps://zhttp://)rr<r�rQrr�r�rMrOrPrr\rsrrhrr��mountr�r>r(r(r,�__init__js

zSession.__init__cCs|Sr'r(r�r(r(r,�	__enter__�szSession.__enter__cGs|��dSr')r^)r>�argsr(r(r,�__exit__�szSession.__exit__c
Cs�|jpi}t|tj�st|�}ttt�|j�|�}|j}|jrR|sR|jsRt	|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
        )r2)
rrS�files�data�jsonr<r�r�rhr�)rhr/rZ	CookieJarrrr
r�rsr rSrZpreparer�upperr�r�r�r4r<rr�r7r�)r>rrrhZmerged_cookiesr��pr(r(r,�prepare_request�s.

�

�zSession.prepare_requestNTcCsxt|��||||pi||pi|||d�
}|�|�}|p8i}|�|j||
||�}|	|
d�}|�|�|j|fi|��}|S)ax	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
        )
rrSr<r�r�r�r�r�rhr�)rNrR)rr�r��merge_environment_settingsrSr0rk)r>rrSr�r�r<rhr�r�rNrRrQr�rMrOrPr�rlZprepZsettingsZsend_kwargsr?r(r(r,rr�s..�
��
zSession.requestcKs |�dd�|jd|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
        rRTr}�rwrr�r>rS�kwargsr(r(r,r6"szSession.getcKs |�dd�|jd|fi|��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
        rRTZOPTIONSr�r�r(r(r,�options-szSession.optionscKs |�dd�|jd|fi|��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
        rRFr|r�r�r(r(r,�head8szSession.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��rr)r>rSr�r�r�r(r(r,�postCszSession.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
        ZPUTr�r��r>rSr�r�r(r(r,�putPs
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
        ZPATCHr�r�r�r(r(r,�patch\s
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
        ZDELETEr�r�r(r(r,�deletehszSession.deletec
Ks�|�d|j�|�d|j�|�d|j�|�d|�||j��t|t�rRtd��|�	dd�}|�
d�}|j}|j|j
d�}t�}|j|fi|��}t�|}	t|	d	�|_td
||fi|��}|jr�|jD]}
t|j|
j|
j�q�t|j||j�|�r|j||fi|��}dd�|D�}ng}|�r@|�d
|�|�	�}||_|�s~z"t|j||fddi|���|_Wnt�y|Yn0|�s�|j|S)zISend a given PreparedRequest.

        :rtype: requests.Response
        rMrOrPrQz#You can only send PreparedRequests.rRT)rS)Zsecondsr5cSsg|]}|�qSr(r()r)r?r(r(r,r-�r.z Session.send.<locals>.<listcomp>rrm)rwrMrOrPrirQr/r�
ValueErrorrfr6r��get_adapterrS�preferred_clockrkr�elapsedrrVrrhrrrYrq�insert�nextZ_next�
StopIterationrW)
r>rrr�rRrMr��adapter�start�rr�r?�genrVr(r(r,rkrsF



"zSession.sendc
Cs�|jrn|dur|�d�nd}t||d�}|��D]\}}	|�||	�q0|dusV|durntj�d�pltj�d�}t||j�}t||j	�}t||j
�}t||j�}||||d�S)z^
        Check the environment and merge it with some settings.

        :rtype: dict
        NrtruTZREQUESTS_CA_BUNDLEZCURL_CA_BUNDLE)rOrQrMrP)rsr6rr1rw�os�environr4rQrMrOrP)
r>rSrQrMrOrPrtZenv_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 {!r}N)r�r1�lowerr_rr])r>rS�prefixr�r(r(r,r��s
zSession.get_adaptercCs|j��D]}|��q
dS)z+Closes all adapters and as such the sessionN)r��valuesr^)r>r+r(r(r,r^�sz
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|�t��kr|�qSr()r[)r)r*�r�r(r,r-�r.z!Session.mount.<locals>.<listcomp>N)r�rf)r>r�r�Zkeys_to_mover3r(r�r,r��s
z
Session.mountcs�fdd��jD�}|S)Ncsi|]}|t�|d��qSr')�getattr)r)�attrr�r(r,�
<dictcomp>�r.z(Session.__getstate__.<locals>.<dictcomp>)�	__attrs__)r>�stater(r�r,�__getstate__�szSession.__getstate__cCs"|��D]\}}t|||�qdSr')r1�setattr)r>r�r��valuer(r(r,�__setstate__�szSession.__setstate__)NNNNNNNTNNNNNN)NN)N)N)r�r�r��__doc__r�r�r�r�r�rrr6r�r�r�r�r�r�rkr�r�r^r�r�r�r(r(r(r,r�Qs0>)�
L



Kr�cCst�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,�sessionsr�)?r�r��sys�timeZdatetimer�collectionsrr�r�compatrrrr	r
rhrrr
rZmodelsrrrr�rrZ_internal_utilsrZutilsrrr�
exceptionsrrrrZ
structuresrr�rrrr r!r"r#Zstatus_codesr$r%�platform�perf_counterr��AttributeErrorZclockr4r7�objectr8r�r�r(r(r(r,�<module>sB 
r3