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 ry
e j5 Z6 Wn e7 k
re 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).
iN( 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 rd } x! | D] } | j j | d qWd | _ n | j } y | d
=Wn t! k
rn 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 | sy( t | j | | d t | | _ Wqt k
rqXn | 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