/usr/lib/python2.7/site-packages/requests
Edit: /usr/lib/python2.7/site-packages/requests/sessions.pyc (22479B)
/ec @ 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 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 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/ d d l0 m1 Z1 d d l m2 Z2 e j3 d k ry
e j4 Z5 Wn e6 k
re j7 Z5 n Xn e j Z5 e d Z8 e d Z9 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 timedeltai ( t _basic_auth_str( t cookielibt is_py3t OrderedDictt urljoint urlparset Mapping( 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_headerst
DEFAULT_PORTS( 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_body( t codes( t REDIRECT_STATIt win32c 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( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt
merge_setting1 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* ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt merge_hooksP 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 ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt get_redirect_targeta 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( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt should_strip_authv s c k s9 g }
| j | } t | j j } x | r4| 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 d k r?| r?| j d | } n | j rT| j } n | j } | j st | j t | } n t | } t | |
_ | j |
| | j t j t j f k r d } x! | D] } |
j j | d qWd |
_" n |
j } y | d =Wn t# k
r'n Xt$ |
j% | | j t& |
j% | j' |
j( |
j% | j) |
| } | j* |
| |
j+ d k od | k pd | k } | rt, |
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:%st t fragments Content-Lengths Content-Types Transfer-Encodingt Cookiet streamt timeoutt verifyt certt proxiest allow_redirectsN( s Content-Lengths Content-Types Transfer-Encoding(. R? R t urlRQ t copyt appendt historyt contentR R t RuntimeErrort rawt readRF t lent
max_redirectsR t closet
startswithR RD t _replacet 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 reqRS RT RU RV RW t yield_requestst adapter_kwargst histRY t previous_fragmentt prepared_requestt parsed_rurlt parsedt purged_headerst headerR; t
rewindable( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt resolve_redirects s|
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; RY RN t requestt trust_envR R$ t prepare_auth( R= R{ R1 R; RY t new_auth( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyRs s $
c
C sE | 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| j
d rA| rA| rAt | | | d
>> import requests
>>> s = requests.Session()
>>> s.get('https://httpbin.org/get')
Or as a context manager::
>>> with requests.Session() as s:
>>> s.get('https://httpbin.org/get')
R; Rp t authRW t hookst paramsRU RV t prefetcht adaptersRS R Rb 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 RW R R R RF RS RC RU RV R Rb R R Rp R R t mountR ( R= ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt __init__o s c C s | S( N( ( R= ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt __enter__ s c G s | j d S( N( Rc ( R= t args( ( s5 /usr/lib/python2.7/site-packages/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 RY t filest datat jsonR; R* R R Rp R ( Rp R% R t CookieJarR R R
R R R RY R
t prepareR t upperR R R R0 R; R R R5 R ( R= R Rp t merged_cookiesR t p( ( s5 /usr/lib/python2.7/site-packages/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, 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) ` 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 RY R; R R R R R Rp R RT RX ( R R R t merge_environment_settingsRY R& Ru ( R= R RY R R R; Rp R R RT RX RW R RS RU RV R Rv t prept settingst send_kwargsR> ( ( s5 /usr/lib/python2.7/site-packages/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
RX R ( R RC R ( R= RY t kwargs( ( s5 /usr/lib/python2.7/site-packages/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
RX t OPTIONS( R RC R ( R= RY R ( ( s5 /usr/lib/python2.7/site-packages/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
RX R ( R RF R ( R= RY R ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt head1 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, 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 ( R= RY R R R ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt post< s c K s | j d | d | | S( su 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
t PUTR ( R ( R= RY R R ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt putI s
c K s | j d | d | | S( sw 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
t PATCHR ( R ( R= RY R R ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt patchU 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= RY R ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt deletea 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
RS RU RV RW s# You can only send PreparedRequests.RX RY t secondsR1 i Rw ( R RS RU RV RW R% R t
ValueErrorRl RC R2 R t get_adapterRY t preferred_clockRu R t elapsedR R\ R Rp R R_ R t insertt nextt _nextt
StopIterationR] (
R= R R RX RS R t adaptert startt rR R> t genR\ ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyRu k 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_BUNDLERU RW RS RV N( R R$ R2 R R' R RC t ost environR0 RW RS RU RV (
R= RY RW RS RU RV R t env_proxiesR, R- ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyR s !c C sS x< | j j D]+ \ } } | j 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 lowerRd R ( R= RY t prefixR ( ( s5 /usr/lib/python2.7/site-packages/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 valuesRc ( R= R- ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyRc s c C so | | j | s ( t __attrs__( R= t state( ( R= s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt __getstate__ s c C s1 x* | j D] \ } } t | | | q
Wd S( N( R' t setattr( R= R R t value( ( s5 /usr/lib/python2.7/site-packages/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 Ru R R Rc R R R ( ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyR V s2 7 ) D
I c C s t S( sZ
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 ( ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt session s (> R R t syst timet datetimeR R R t compatR R R R R R Rp R R R
R t modelsR R
R R R R t _internal_utilsR t utilsR R R t
exceptionsR R R R t
structuresR R R R R R R R R t status_codesR! R" t platformt perf_counterR t AttributeErrort clockR0 R5 t objectR6 R R ( ( ( s5 /usr/lib/python2.7/site-packages/requests/sessions.pyt s: ." ".