�
��abc @ s+ d Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d d l m Z d d l
m Z m Z m
Z
m Z m Z d d l m Z m Z m Z m Z d d l m Z m Z m Z d d
l m Z m Z d d l m Z d d l m Z m Z d d
l! m" Z" m# Z# m$ Z$ m% Z% d d l& m' Z' d d l( m) Z) d d l m* Z* m+ Z+ m, Z, m- Z- m. Z. m/ Z/ m0 Z0 d d l1 m2 Z2 d d l m3 Z3 e j4 � d k r�y
e j5 Z6 Wn e7 k
r�e j8 Z6 n Xn e j Z6 e
d � Z9 e
d � Z: d e; f d � � YZ< d e< f d � � YZ= d � Z> d S( s�
requests.session
~~~~~~~~~~~~~~~~
This module provides a Session object to manage and persist settings across
requests (cookies, auth, proxies).
i����N( t Mapping( t timedeltai ( t _basic_auth_str( t cookielibt is_py3t OrderedDictt urljoint urlparse( t cookiejar_from_dictt extract_cookies_to_jart RequestsCookieJart
merge_cookies( t Requestt PreparedRequestt DEFAULT_REDIRECT_LIMIT( t
default_hookst
dispatch_hook( t to_native_string( t to_key_val_listt default_headers( t TooManyRedirectst
InvalidSchemat ChunkedEncodingErrort ContentDecodingError( t CaseInsensitiveDict( t HTTPAdapter( t requote_urit get_environ_proxiest get_netrc_autht should_bypass_proxiest get_auth_from_urlt rewind_bodyt
DEFAULT_PORTS( t codes( t REDIRECT_STATIt Windowsc C s� | d k r | S| d k r | St | t � o; t | t � sB | S| t | � � } | j t | � � g | j � D] \ } } | d k rt | ^ qt } x | D]
} | | =q� W| S( s� 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`
N( t Nonet
isinstanceR R t updatet items( t request_settingt session_settingt
dict_classt merged_settingt kt vt none_keyst key( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt
merge_setting2 s 1
c C sZ | d k s! | j d � g k r% | S| d k sF | j d � g k rJ | St | | | � S( s� Properly merges both requests and session hooks.
This is necessary because when request_hooks == {'response': []}, the
merge breaks Session hooks entirely.
t responseN( R$ t getR0 ( t
request_hookst
session_hooksR* ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt merge_hooksQ s
!!t SessionRedirectMixinc B sP e Z d � Z d � Z e d e d d e d � Z d � Z d � Z d � Z
RS( c C s? | j r; | j d } t r. | j d � } n t | d � Sd S( s7 Receives a Response. Returns a redirect URI or ``None``t locationt latin1t utf8N( t is_redirectt headersR t encodeR R$ ( t selft respR7 ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt get_redirect_targetb s
c C s� t | � } t | � } | j | j k r. t S| j d k rn | j d k rn | j d k rn | j d k rn t S| j | j k } | j | j k } t j | j d � d f } | r� | j | k r� | j | k r� t S| p� | S( sF Decide whether Authorization header should be removed when redirectingt httpiP t httpsi� N( iP N( i� N( R t hostnamet Truet schemet portR$ t FalseR R2 ( R= t old_urlt new_urlt
old_parsedt
new_parsedt changed_portt changed_schemet default_port( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt should_strip_authx s c k s� g }
| j | � } x�| r�| j � } |
j | � |
d | _ y | j Wn- t t t f k
r~ | j j d t
� n Xt | j � | j k r� t
d | j d | �� n | j � | j d � r� t | j � }
d t |
j � | f } n t | � } | j � } | j s3t | j t | � � } n t | � } t | � | _ | j | | � | j t j t j f k r�d } x! | D] } | j j | d � q�Wd | _ n | j } y | d
=Wn t! k
r�n Xt" | j# | | j � t$ | j# | j% � | j& | j# � | j' | | � } | j( | | � | j) d k oVd | k pVd | k } | rlt* | � n | } | r�| Vq | j+ | d | d | d
| d | d | d t
| �} t" | j% | | j � | j | � } | Vq Wd S( sB Receives a Response. Returns a generator of Responses or Requests.i t decode_contents Exceeded %s redirects.R1 s //s %s:%ss Content-Lengths Content-Types Transfer-Encodingt Cookiet streamt timeoutt verifyt certt proxiest allow_redirectsN( s Content-Lengths Content-Types Transfer-Encoding(, R? t copyt appendt historyt contentR R t RuntimeErrort rawt readRF t lent
max_redirectsR t closet
startswithR t urlR RD t geturlt netlocR R t rebuild_methodt status_codeR! t temporary_redirectt permanent_redirectR; t popR$ t bodyt KeyErrorR t _cookiesR t cookiest prepare_cookiest rebuild_proxiest rebuild_autht _body_positionR t send( R= R> t reqRQ RR RS RT RU t yield_requestst adapter_kwargst histRb t prepared_requestt parsed_rurlt parsedt purged_headerst headerR; t
rewindable( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt resolve_redirects� sr
c C s{ | j } | j } d | k r@ | j | j j | � r@ | d =n | j rU t | � n d } | d k rw | j | � n d S( s� 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.
t
AuthorizationN( R; Rb RN t requestt trust_envR R$ t prepare_auth( R= Rw R1 R; Rb t new_auth( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyRp � s $
c
C s5 | d k r | n i } | j } | j } t | � j } | j � } | j d � } t | d | �} | j r� | r� t | d | �} | j | | j d � � }
|
r� | j
| |
� q� n d | k r� | d =n y t | | � \ } } Wn t k
rd \ } } n X| r1| r1t
| | � | d >> import requests
>>> s = requests.Session()
>>> s.get('http://httpbin.org/get')
Or as a context manager::
>>> with requests.Session() as s:
>>> s.get('http://httpbin.org/get')
R; Rm t authRU t hookst paramsRS RT t prefetcht adaptersRQ R� R_ c C s� t � | _ d | _ i | _ t � | _ i | _ t | _ t
| _ d | _ t
| _ t
| _ t i � | _ t � | _ | j d t � � | j d t � � d S( Ns https://s http://( R R; R$ R� RU R R� R� RF RQ RC RS RT R R_ R� R Rm R R� t mountR ( R= ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt __init__j s c C s | S( N( ( R= ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt __enter__� s c G s | j � d S( N( R` ( R= t args( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt __exit__� s c C s* | j p i } t | t j � s0 t | � } n t t t � | j � | � } | j } | j r� | r� | j r� t | j
� } n t � } | j d | j
j � d | j
d | j d | j d | j d t | j | j d t �d t | j | j � d t | | j � d
| d t | j | j � �
| S( s� Constructs 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� Rb t filest datat jsonR; R* R� R� Rm R� ( Rm R% R t CookieJarR R R
R� R� R Rb R
t prepareR� t upperR� R� R� R0 R; R R� R5 R� ( R= R Rm t merged_cookiesR� t p( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt prepare_request� s*
c C s� t d | j � d | d | d | d | p- i d | d | p? i d | d | d
| �
} | j | � } | po i } | j | j | |
| | � } i | d 6|
d 6} | j | � | j | | � } | S(
s� 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, 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
R� Rb R; R� R� R� R� R� Rm R� RR RV ( R R� R� t merge_environment_settingsRb R& Rr ( R= R� Rb R� R� R; Rm R� R� RR RV RU R� RQ RS RT R� Rs t prept settingst send_kwargsR> ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyR � s* )
c K s# | j d t � | j d | | � S( s� 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
RV R� ( R� RC R ( R= Rb t kwargs( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyR2 s c K s# | j d t � | j d | | � S( s� 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
RV t OPTIONS( R� RC R ( R= Rb R� ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt options! s c K s# | j d t � | j d | | � S( s� 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
RV R� ( R� RF R ( R= Rb R� ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt head, s c K s | j d | d | d | | �S( s� 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
R� R� R� ( R ( R= Rb R� R� R� ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt post7 s
c K s | j d | d | | �S( sY 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
t PUTR� ( R ( R= Rb R� R� ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt putC s c K s | j d | d | | �S( s[ 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
t PATCHR� ( R ( R= Rb R� R� ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt patchN s c K s | j d | | � S( s� 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
t DELETE( R ( R= Rb R� ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt deleteY s c
K s | j d | j � | j d | j � | j d | j � | j d | j � t | t � rj t d � � n | j d t � } | j
d � } | j } | j d | j
� } t � } | j | | � } t � | } t d | � | _ t d | | | � } | j r1x- | j D] }
t | j |
j |
j � q Wn t | j | | j � | j | | | � } | r{g | D] }
|
^ qin g } | r�| j d
| � | j � } | | _ n | s�y( t | j | | d t | �� | _ Wq�t k
r�q�Xn | s| j n | S( sI Send a given PreparedRequest.
:rtype: requests.Response
RQ RS RT RU s# You can only send PreparedRequests.RV Rb t secondsR1 i Rt ( R� RQ RS RT RU R% R t
ValueErrorRi RC R2 R� t get_adapterRb t preferred_clockRr R t elapsedR RY R Rm R R\ R} t insertt nextt _nextt
StopIterationRZ (
R= R R� RV RQ R� t adaptert startt rR� R> t genRY ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyRr c sB
% (
c
C s | j r� | d k r$ | j d � n d } t | d | �} x* | j � D] \ } } | j | | � qI W| t k s� | d k r� t j j d � p� t j j d � } q� n t | | j
� } t | | j � } t | | j � } t | | j
� } i | d 6| d 6| d 6| d 6S( s^
Check the environment and merge it with some settings.
:rtype: dict
R� t REQUESTS_CA_BUNDLEt CURL_CA_BUNDLERS RU RQ RT N( R� R$ R2 R R' R� RC t ost environR0 RU RQ RS RT (
R= Rb RU RQ RS RT R� t env_proxiesR, R- ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyR� � s !c C sM x6 | j j � D]% \ } } | j � j | � r | Sq Wt d | � � d S( s~
Returns the appropriate connection adapter for the given URL.
:rtype: requests.adapters.BaseAdapter
s* No connection adapters were found for '%s'N( R� R' t lowerRa R ( R= Rb t prefixR� ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyR� � s c C s( x! | j j � D] } | j � q Wd S( s+ Closes all adapters and as such the sessionN( R� t valuesR` ( R= R- ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyR` � s c C so | | j | � s ( t dictt __attrs__( R= t state( ( R= sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt __getstate__� s c C s1 x* | j � D] \ } } t | | | � q
Wd S( N( R' t setattr( R= R� R� t value( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt __setstate__� s N( R� R� t __doc__R� R� R� R� R� R$ RC R R2 R� R� R� R� R� R� Rr R� R� R` R� R� R� ( ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyR� Q s2 7 ) D
I c C s t � S( sQ
Returns a :class:`Session` for context-management.
:rtype: Session
( R� ( ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt session� s (? R� R� t platformt timet collectionsR t datetimeR R� R t compatR R R R R Rm R R R
R t modelsR R
R R� R R t _internal_utilsR t utilsR R t
exceptionsR R R R t
structuresR R� R R R R R R R R t status_codesR! R" t systemt perf_counterR� t AttributeErrort clockR0 R5 t objectR6 R� R� ( ( ( sA /usr/lib/python2.7/site-packages/pip/_vendor/requests/sessions.pyt s< (" "4
�� �