3

`��]p�@s�
dZd
dl
Z
d
dlZd
dlZd
dlmZ
d
dlmZ
ddlm	Z	
ddl
mZmZm
Z
mZmZ
ddlmZmZmZmZ
dd	lmZmZmZ
dd
lmZmZ
ddlmZ
ddlmZm Z 
dd
l!m"Z"m#Z#m$Z$m%Z%
ddl&m'Z'
ddl(m)Z)
ddl*m+Z+
ddlm,Z,m-Z-m.Z.m/Z/m0Z0m1Z1
ddl2m3Z3
ddlm4Z4
dZ5ej6�dk�
rdy
ej7Z8Wne9k
�
r`


ej:Z8YnXnejZ8e
f
dd�
Z;e
f
dd�
Z<Gdd�de=�Z>Gdd�de>�Z?dd�Z@dS) z�
requests.session
~~~~~~~~~~~~~~~~

This module provides a Session object to manage and persist settings across
requests (cookies, auth, proxies).
�N)
�Mapping)
�	timedelta�
)
�_basic_auth_str)�	cookielib�is_py3�OrderedDict�urljoin�urlparse)�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)�TooManyRedirects�
InvalidSchema�ChunkedEncodingError�ContentDecodingError)
�RecentlyUsedContainer)
�CaseInsensitiveDict)
�HTTPAdapter)�requote_uri�get_environ_proxies�get_netrc_auth�should_bypass_proxies�get_auth_from_url�rewind_body)
�codes)
�REDIRECT_STATIi�ZWindowscCst|
d
kr|S|d
kr|
St|
t
�o*t|t
�s0|S|t|
�
�
}|jt|�
�

dd�|j�D�
}x|D]
}||=qbW|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|]\}
}|dkr|
�qS)
N�)�.0�
k�
vr&r&�/usr/lib/python3.6/sessions.py�
<listcomp>Msz!merge_setting.<locals>.<listcomp>)�
isinstancerr�update�items)Zrequest_settingZsession_setting�
dict_classZmerged_settingZ	none_keys�keyr&r&r*�
merge_setting5s









r1cCs@|
d
ks|
jd�
gkr|S|d
ks0|jd�
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)�getr1)Z
request_hooksZ
session_hooksr/r&r&r*�merge_hooksTs


r4c@s>eZ
dZd
d�Zdd�Zddd	�
Zd
d�Zdd
�Zdd�ZdS)�SessionRedirectMixincCs,|
jr(|
j
d
}tr|jd�
}t|d�SdS)z7Receives a Response. Returns a redirect URI or ``None``�location�latin1�utf8N)Zis_redirect�headersr�encoder)�self�respr6r&r&r*�get_redirect_targetes






z(SessionRedirectMixin.get_redirect_targetcCsdt|
�
}t|�
}|j
|j
kr d
S|jdkrL|jdkrL|jdkrL|jd	krLdS|j|jkpb|j|jkS)
zFDecide whether Authorization header should be removed when redirectingTZhttp�PNZhttps�
F)r>N)r?N)r
Zhostname�schemeZport)r;Zold_url�new_urlZ
old_parsedZ
new_parsedr&r&r*�should_strip_authts




z&SessionRedirectMixin.should_strip_authFNTcksDg}	|j|
�
}
�x.|
�r>|j
�}|	j|
�

|	d
d�|
_y
|
j
Wn(tttfk
rj


|
jj	dd�

YnXt
|
j�
|jkr�td|j|
d��
|
j
�
|
jd�
r�t|
j�
}dt|j�
|
f}
t|
�
}
|
j�}
|
js�t|
jt|
�
�}
nt|
�
}
t|
�
|_|
j�
r|j|jk�
r|j|j|j<|j||
�
|
jtjtjfk�
rbd}x|D]}|jj|d�
�
qDWd|_ |j}y
|d=Wnt!k
�
r�


YnXt"|j#||
j�
t$|j#|j%�
|j&|j#�

|j'||�}|j(||
�
|j)dk	�
o�d	|k�
p�d|k}|�
r�t*|�

|}|j+|f
|||||dd
�|��
}
t"|j%||
j�
|j|
�
}
|
V
qWdS)z6Receives a Response. Returns a generator of Responses.rNF)
Zdecode_contentzExceeded %s redirects.)
r2z//z%s:%s�Content-Length�Content-Type�Transfer-EncodingZCookie)�stream�timeout�verify�cert�proxies�allow_redirects)rCrDrE),r=�copy�append�history�contentrr�RuntimeError�raw�read�len�
max_redirectsr�close�
startswithr
�urlrr@ZgeturlZnetlocr	rZis_permanent_redirect�redirect_cache�rebuild_method�status_coder$Ztemporary_redirectZpermanent_redirectr9�popZbody�KeyErrorrZ_cookiesr�cookiesZprepare_cookies�rebuild_proxies�rebuild_authZ_body_positionr#�send)r;r<�reqrFrGrHrIrJZadapter_kwargsZhistrW�prepared_requestZparsed_rurlZparsedZpurged_headers�headerr9Z
rewindabler&r&r*�resolve_redirects�sr










































z&SessionRedirectMixin.resolve_redirectscCsR|
j}|
j
}d
|kr*|j|jj
|�r*|d
=|jr8t|�
nd}|dk	rN|
j|�

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)r9rWrB�request�	trust_envr Zprepare_auth)r;rbr2r9rWZnew_authr&r&r*r_�s



z!SessionRedirectMixin.rebuild_authc
Cs�|d
k	r|ni}|
j}|
j
}t|�
j}|j�}|jd�
}t||d�}|jr~|r~t||d�}	|	j||	jd�
�}
|
r~|j	||
�
d|kr�|d=yt
||�
\}}Wntk
r�


d\}}YnX|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)
rg�allzProxy-Authorization)NN)
r9rWr
r@rLr3r!rfr�
setdefaultr"r\r)
r;rbrJr9rWr@Znew_proxiesrgZbypass_proxyZenviron_proxies�proxyZusernameZpasswordr&r&r*r^
s*














z$SessionRedirectMixin.rebuild_proxiescCsX|
j}|j
tjkr|d
krd}|j
tjkr6|d
kr6d}|j
tjkrN|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)�methodrZr$Z	see_other�foundZmoved)r;rbr2rnr&r&r*rY,
s


z#SessionRedirectMixin.rebuild_method)FNTNN)	�__name__�
__module__�__qualname__r=rBrdr_r^rYr&r&r&r*r5cs

j)r5c@s�eZ
dZd
Zdddddddd	d
ddd
dg
Zdd�Zdd�Zdd�Zdd�Zd7dd�
Z	dd�Z
dd�Zdd �Zd8d!d"�
Z
d9d#d$�
Zd:d%d&�
Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Zd3d4�Zd5d6�ZdS);�Sessiona~
A Requests session.

    Provides cookie persistence, connection-pooling, and configuration.

    Basic Usage::

      >>> import requests
      >>> s = requests.Session()
      >>> s.get('http://httpbin.org/get')
      <Response [200]>

    Or as a context manager::

      >>> with requests.Session() as s:
      >>>     s.get('http://httpbin.org/get')
      <Response [200]>
    r9r]�authrJ�hooks�paramsrHrIZprefetch�adaptersrFrfrTc

Cs|t�|_
d|_i|_t�|_i|_d
|_d|_d|_	t
|_d|_t
i�
|_t�|_|jdt��
|jdt��
tt�
|_dS)NFTzhttps://zhttp://)rr9rtrJrrurvrFrHrIrrTrfrr]rrw�mountrr�REDIRECT_CACHE_SIZErX)
r;r&r&r*�__init__\
s


zSession.__init__c


Cs|S)
Nr&)
r;r&r&r*�	__enter__�
s
zSession.__enter__c

Gs|j�
dS)
N)
rU)r;�argsr&r&r*�__exit__�
s
zSession.__exit__c
Cs�|
jpi}t
|tj�st|�
}ttt�|j�|�}|
j}|jrV|rV|jrVt	|
j
�
}t�}|j|
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
        )
r/)
rnrW�files�data�jsonr9rvrtr]ru)r]r,rZ	CookieJarrrr
rtrfr rWrZpreparern�upperr~rr�r1r9rrvr4ru)r;rer]Zmerged_cookiesrt�
pr&r&r*�prepare_request�
s*


















zSession.prepare_requestNTcCstt|
j
�||||pi||pi|||d
�
}|j|�
}|p8i}|j|j||
||�}|	|
d�}|j|�

|j|f
|�
}|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, 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``.
        :param cert: (optional) if String, path to ssl client cert file (.pem).
            If Tuple, ('cert', 'key') pair.
        :rtype: requests.Response
        )
rnrWr9r~rr�rvrtr]ru)rGrK)rr�r��merge_environment_settingsrWr-r`)r;rnrWrvrr9r]r~rtrGrKrJrurFrHrIr�raZprepZsettingsZsend_kwargsr<r&r&r*re�
s(4














zSession.requestcKs|jd
d�
|j
d|
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
        rKTrl)rire)r;rW�kwargsr&r&r*r3s
zSession.getcKs|jd
d�
|j
d|
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
        rKTZOPTIONS)rire)r;rWr�r&r&r*�options!s
zSession.optionscKs|jd
d�
|j
d|
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
        rKFrk)rire)r;rWr�r&r&r*�head,s
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, 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
        rm)rr�)
re)r;rWrr�r�r&r&r*�post7s
zSession.postcKs|jd
|
fd|i
|��
S)aY
Sends a PUT request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, 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)
re)r;rWrr�r&r&r*�putCs	zSession.putcKs|jd
|
fd|i
|��
S)a[
Sends a PATCH request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, 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)
re)r;rWrr�r&r&r*�patchNs	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
        ZDELETE)
re)r;rWr�r&r&r*�deleteYszSession.deletecKs�
|jd
|j
�
|jd|j�
|jd|j�
|jd|j�
t|
t�rJtd�
�
|jdd�}|j	d
�
}|
j
}|r�t�}x:|
j|j
kr�|j|
j�

|j
j	|
j�
}||kr�P||
_qrW|j|
jd�
}t�}	|j|
f
|�
}
t�|	}t|d	�
|
_td
||
f|�
}
|
j�
r x"|
jD]}t|j|j|j�
�
qWt|j|
|
j�
|j|
|
f|�
}
|�
rTdd�|
D�
ng}|�
rx|jd
|
�
|j�}
||
_|�
s�|
j
|
S)zR
        Send a given PreparedRequest.

        :rtype: requests.Response
        rFrHrIrJz#You can only send PreparedRequests.rKT)
rW)
Zsecondsr2c
Ssg|]}
|
�qSr&r&)r'r<r&r&r*r+�sz Session.send.<locals>.<listcomp>r
)rirFrHrIrJr,r�
ValueErrorr[r3ru�setrWrX�add�get_adapter�preferred_clockr`r�elapsedrrNrr]rerQrd�insertrO)r;rer�rKrFruZchecked_urlsrA�adapter�start�
rr�r<�genrNr&r&r*r`csH




















zSession.sendc
Cs�|jrr|d
k	r|j
d�
nd
}t|
|d�}x |j�D]\}}	|j||	�
q2W|dksZ|d
krrtjj
d�
pptjj
d�
}t||j�}t||j	�}t||j
�}t||j�}||||d�S)z^
        Check the environment and merge it with some settings.

        :rtype: dict
        Nrg)
rgTZREQUESTS_CA_BUNDLEZCURL_CA_BUNDLE)rHrJrFrI)rfr3rr.ri�os�environr1rJrFrHrI)
r;rWrJrFrHrIrgZenv_proxiesr(r)r&r&r*r��s








z"Session.merge_environment_settingscCs:x(|jj
�D]\}}|
j�j|�
r|SqWtd
|
�
�
dS)z~
        Returns the appropriate connection adapter for the given URL.

        :rtype: requests.adapters.BaseAdapter
        z*No connection adapters were found for '%s'N)rwr.�lowerrVr)r;rW�prefixr�r&r&r*r��s
zSession.get_adapterc
Cs x|jj
�D]}
|
j�
qWd
S)z+Closes all adapters and as such the sessionN)rw�valuesrU)r;r)r&r&r*rU�s
z
Session.closecsB||j�<�f
d
d�|jD�
}x|D]}|jj
|�
|j|<q$WdS)ztRegisters a connection adapter to a prefix.

        Adapters are sorted in descending order by key length.
        c
s g|]}
t|
�
t��
kr|
�qSr&)
rS)r'r()
r�r&r*r+�sz!Session.mount.<locals>.<listcomp>N)rwr[)r;r�r�Zkeys_to_mover0r&)
r�r*rx�s



z
Session.mountc
s*t�f
d
d��j
D�
�
}
t�j�
|
d<|
S)Nc
3s|]}
|
t�|
d�fV
qdS)
N)
�getattr)r'�attr)
r;r&r*�	<genexpr>�sz'Session.__getstate__.<locals>.<genexpr>rX)�dict�	__attrs__rX)r;�stater&)
r;r*�__getstate__�s


zSession.__getstate__cCs\|
jd
i�}x |
j
�D]\}}t|||�
qWtt�
|_x|j
�D]\}}||j|<qBWdS)NrX)r[r.�setattrrryrX)r;r�rXr��valueZredirectZtor&r&r*�__setstate__�s





zSession.__setstate__)NNNNNNNTNNNNNN)NN)
N)
N)rprqrr�__doc__r�rzr{r}r�rer3r�r�r�r�r�r�r`r�r�rUrxr�r�r&r&r&r*rsC
sH


:)













D



Mrsc
Cst�S)
zQ
    Returns a :class:`Session` for context-management.

    :rtype: Session
    )
rsr&r&r&r*�session�sr�)Ar�r��platformZtime�collectionsrZdatetimerrtr�compatrrrr	r
r]rrr
rZmodelsrrrrurrZ_internal_utilsrZutilsrr�
exceptionsrrrrZpackages.urllib3._collectionsrZ
structuresrrwrrrr r!r"r#Zstatus_codesr$r%ry�systemZperf_counterr��AttributeErrorZclockr1r4�objectr5rsr�r&r&r&r*�<module>	sF











 




a: