mirror of
https://github.com/microsoft/PowerToys.git
synced 2026-04-10 05:06:36 +02:00
178 lines
19 KiB
Plaintext
178 lines
19 KiB
Plaintext
|
<03>
|
|||
|
|
G<12>Sc @ s<> d 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 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* d d l+ m, Z, d d l m- Z- e d <00> Z. e d <00> Z/ d e0 f d <00> <00> YZ1 d e1 f d <00> <00> YZ2 d <00> Z3 d S( s<>
|
|||
|
|
requests.session
|
|||
|
|
~~~~~~~~~~~~~~~~
|
|||
|
|
|
|||
|
|
This module provides a Session object to manage and persist settings across
|
|||
|
|
requests (cookies, auth, proxies).
|
|||
|
|
|
|||
|
|
i<EFBFBD><EFBFBD><EFBFBD><EFBFBD>N( t Mapping( t datetimei ( t _basic_auth_str( t cookielibt OrderedDictt urljoint urlparset builtin_str( t cookiejar_from_dictt extract_cookies_to_jart RequestsCookieJart
merge_cookies( t Requestt PreparedRequestt DEFAULT_REDIRECT_LIMIT( t
default_hookst
dispatch_hook( t to_key_val_listt default_headerst to_native_string( t TooManyRedirectst
InvalidSchemat ChunkedEncodingErrort ContentDecodingError( t CaseInsensitiveDict( t HTTPAdapter( t requote_urit get_environ_proxiest get_netrc_autht should_bypass_proxiest get_auth_from_url( t codes( t REDIRECT_STATIc C s<> | d k r | S| d k r | St | t <00> o; t | t <00> sB | S| t | <00> <00> } | j t | <00> <00> x0 | j <00> D]" \ } } | d k rt | | =qt qt Wt d <00> | j <00> D<> <00> } | 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`
|
|||
|
|
c s s- | ]# \ } } | d k r | | f Vq d S( N( t None( t .0t kt v( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pys <genexpr>C s N( R! t
|
|||
|
|
isinstanceR R t updatet itemst dict( t request_settingt session_settingt
|
|||
|
|
dict_classt merged_settingR# R$ ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt
merge_setting' s c C sZ | d k s! | j d <00> g k r% | S| d k sF | j d <00> g k rJ | St | | | <00> 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 getR- ( t
request_hookst
session_hooksR+ ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt merge_hooksH s
|
|||
|
|
!!t SessionRedirectMixinc B s2 e Z e d e d d d <00> Z d <00> Z d <00> Z RS( c c s<> d } x<>| j r<>| j <00> } y | j Wn- t t t f k
|
|||
|
|
rX | j j d t <00> n X| | j k r~ t
|
|||
|
|
d | j <16> <00> n | j <00> | j d }
|
|||
|
|
| j
} |
|
|||
|
|
j d <00> r<> t | j <00> } d | j |
|
|||
|
|
f }
|
|||
|
|
n t |
|
|||
|
|
<00> }
|
j <00> }
|
|||
|
|
t |
|
|||
|
|
<00> j st | j t |
|
|||
|
|
<00> <00> }
|
|||
|
|
n t |
|
|||
|
|
<00> }
|
|||
|
|
t |
|
|||
|
|
<00> | _ | j t j k rV| d k rVd } n | j t j k r}| d k r}d } n | j t j k r<>| d k r<>d } n | | _
| j t j t j f k r<>d
|
|||
|
|
| j k r<>| j d
|
|||
|
|
=n d | _ n | j } y | d =Wn t k
|
|||
|
|
rn Xt! | j" | | j <00> | j" j# | j$ <00> | j% | j" <00> | j& | | <00> } | j' | | <00> | } | j( | d | d
| d | d | d | d t <00>} t! | j$ | | j <00> | d 7} | Vq Wd S( s6 Receives a Response. Returns a generator of Responses.i t decode_contents Exceeded %s redirects.t locations //s %s:%st HEADt GETt POSTs Content-Lengtht Cookiet streamt timeoutt verifyt certt proxiest allow_redirectsi N() t is_redirectt copyt contentR R t RuntimeErrort rawt readt Falset
max_redirectsR t closet headerst methodt
|
|||
|
|
startswithR t urlt schemet geturlt netlocR R R t status_codeR t see_othert foundt movedt temporaryt resumeR! t bodyt KeyErrorR t _cookiesR& t cookiest prepare_cookiest rebuild_proxiest rebuild_autht send( t selft respt reqR: R; R< R= R> t it prepared_requestRL RJ t parsed_rurlt parsedRI ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt resolve_redirectsY sn
|
|||
|
|
|
|||
|
|
c C s<> | j } | j } d | k r[ t | j j <00> } t | <00> } | j | j k r[ | d =q[ n | j rp t | <00> n d } | d k r<> | j | <00> 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( RI RL R t requestt hostnamet trust_envR R! t prepare_auth( R^ Rb R. RI RL t original_parsedt redirect_parsedt new_auth( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyR\ <00> s
c C s | j } | j } t | <00> j } | d k r9 | j <00> n i } | j r<> t | <00> r<> t | <00> } | j | <00> } | r<> | j
|
|||
|
|
| | | <19> q<> n d | k r<> | d =n y t | | <19> \ } }
|
|||
|
|
Wn t k
|
|||
|
|
r<> d \ } }
|
|||
|
|
n X| r|
|
|||
|
|
rt
| |
|
|||
|
|
<00> | d <n | S( s<>
|
|||
|
|
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.
|
|||
|
|
s Proxy-AuthorizationN( NN( RI RL R RM R! RA Ri R R R/ t
|
|||
|
|
setdefaultR RW R ( R^ Rb R> RI RL RM t new_proxiest environ_proxiest proxyt usernamet password( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyR[ <00> s$
|
|||
|
|
N( t __name__t
|
|||
|
|
__module__RF R! t TrueRe R\ R[ ( ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyR3 X s a t Sessionc B s e Z d Z d d d d d d d d d d
|
|||
|
|
d d d
d g Z d <00> Z d <00> Z d <00> Z d <00> Z d! d! d! d! d! d! d! e d! d! d! d! d! d <00>
Z
|
|||
|
|
d <00> Z d <00> Z d <00> Z
d! d <00> Z d! d <00> Z d! d <00> Z d <00> Z d <00> Z d <00> Z d <00> Z d <00> Z d <00> Z d <00> Z RS(" s<> A Requests session.
|
|||
|
|
|
|||
|
|
Provides cookie persistence, connection-pooling, and configuration.
|
|||
|
|
|
|||
|
|
Basic Usage::
|
|||
|
|
|
|||
|
|
>>> import requests
|
|||
|
|
>>> s = requests.Session()
|
|||
|
|
>>> s.get('http://httpbin.org/get')
|
|||
|
|
200
|
|||
|
|
RI RY t authR; R> t hookst paramsR< R= t prefetcht adaptersR: Ri RG c C s<> t <00> | _ d | _ i | _ t <00> | _ i | _ t | _ t
|
|||
|
|
| _ d | _ t
| _ t
|
|||
|
|
| _ t i <00> | _ t <00> | _ | j d t <00> <00> | j d t <00> <00> d S( Ns https://s http://( R RI R! Rx R> R Ry Rz RF R: Rv R< R= R RG Ri R RY R R| t mountR ( R^ ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt __init__ s c C s | S( N( ( R^ ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt __enter__? s c G s | j <00> d S( N( RH ( R^ t args( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt __exit__B s c C s! | j p i } t | t j <00> s0 t | <00> } n t t t <00> | j <00> | <00> } | j } | j r<> | r<> | j r<> t | j
|
|||
|
|
<00> } n t <00> } | j d | j
j <00> d | j
|
|||
|
|
d | j d | j d t | j | j d t <00>d t | j | j <00> d t | | j <00> d | d
|
|||
|
|
t | j | j <00> <00> | S( sb 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.
|
|||
|
|
RJ RL t filest dataRI R+ Rz Rx RY Ry ( RY R% R t CookieJarR R R
|
|||
|
|
Rx Ri R RL R
t prepareRJ t upperR<72> R<> R- RI R Rz R2 Ry ( R^ Rg RY t merged_cookiesRx t p( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt prepare_requestE s( c C s<> t | <00> } t d | j <00> d | d | d | d | p9 i d | pE i d | d | d | <00> } | j | <00> } | pu i } | j rt | <00> p<> i } x* | j <00> D] \ } } | j | | <00> q<> W| r<> | t k r<> t j
|
|||
|
|
j d
|
|||
|
|
<00> } n | r| t k rt j
|
|||
|
|
j d <00> } qn t | | j
<00> } t |
| j <00> }
t | | j <00> } t | | j <00> } i |
d 6| d
6| d 6| d 6| d 6|
|
|||
|
|
d 6} | j | | <00> } | S( s4 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 or bytes 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) Float describing the timeout of the
|
|||
|
|
request in seconds.
|
|||
|
|
:param allow_redirects: (optional) Boolean. Set to True by default.
|
|||
|
|
:param proxies: (optional) Dictionary mapping protocol to the URL of
|
|||
|
|
the proxy.
|
|||
|
|
:param stream: (optional) whether to immediately download the response
|
|||
|
|
content. Defaults to ``False``.
|
|||
|
|
:param verify: (optional) if ``True``, the SSL cert will be verified.
|
|||
|
|
A CA_BUNDLE path can also be provided.
|
|||
|
|
:param cert: (optional) if String, path to ssl client cert file (.pem).
|
|||
|
|
If Tuple, ('cert', 'key') pair.
|
|||
|
|
RJ RL RI R<> R<> Rz Rx RY Ry t REQUESTS_CA_BUNDLEt CURL_CA_BUNDLER: R; R< R= R> R? ( R R R<> R<> Ri R R' Rn RF t ost environR/ R- R> R: R< R= R] ( R^ RJ RL Rz R<> RI RY R<> Rx R; R? R> Ry R: R< R= R` t prept env_proxiesR# R$ t send_kwargsR_ ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyRg l sD ,
|
|||
|
|
c K s# | j d t <00> | j d | | <00> 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.
|
|||
|
|
R? R7 ( Rn Rv Rg ( R^ RL t kwargs( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyR/ <00> s c K s# | j d t <00> | j d | | <00> 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.
|
|||
|
|
R? t OPTIONS( Rn Rv Rg ( R^ RL R<> ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt options<6E> s c K s# | j d t <00> | j d | | <00> 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.
|
|||
|
|
R? R6 ( Rn RF Rg ( R^ RL R<> ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt head<61> s c K s | j d | d | | <00>S( s8 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 \*\*kwargs: Optional arguments that ``request`` takes.
|
|||
|
|
R8 R<> ( Rg ( R^ RL R<> R<> ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt post<73> s c K s | j d | d | | <00>S( s7 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.
|
|||
|
|
t PUTR<54> ( Rg ( R^ RL R<> R<> ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt put<75> s c K s | j d | d | | <00>S( s9 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.
|
|||
|
|
t PATCHR<48> ( Rg ( R^ RL R<> R<> ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt patch<63> s c K s | j d | | <00> 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.
|
|||
|
|
t DELETE( Rg ( R^ RL R<> ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt delete s c
K s | j d | j <00> | j d | j <00> | j d | j <00> | j d | j <00> t | t <00> sj t d <00> <00> n | j d t <00> } | j
|
|||
|
|
d <00> } | j
|
|||
|
|
d <00> } | j
|
|||
|
|
d <00> } | j
|
|||
|
|
d <00> } | j
|
|||
|
|
d <00> } | j } | j d | j
<00> }
|
|||
|
|
t j <00> } |
|
|||
|
|
j | | <00> } t j <00> | | _ t d | | | <00> } | j rdx- | j D] }
t | j |
j |
j <00> q>Wn t | j | | j <00> | j | | d | d | d | d | d | <00>} | r<>g | D] }
|
^ q<>n g } | r<>| j d
|
|||
|
|
| <00> | j <00> } | | _ n | s
| j n | S( s Send a given PreparedRequest.R: R< R= R> s# You can only send PreparedRequests.R? R; RL R. i ( Rn R: R< R= R> R% R
t
|
|||
|
|
ValueErrort popRv R/ Ry t get_adapterRL R t utcnowR] t elapsedR t historyR RY Rg RD Re t insertRB ( R^ Rg R<> R? R: R; R< R= R> Ry t adaptert startt rR_ t genR<6E> ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyR] sH %
|
|||
|
|
c C sM x6 | j j <00> D]% \ } } | j <00> j | <00> r | Sq Wt d | <16> <00> d S( s> Returns the appropriate connnection adapter for the given URL.s* No connection adapters were found for '%s'N( R| R' t lowerRK R ( R^ RL t prefixR<78> ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyR<79> X s c C s( x! | j j <00> D] } | j <00> q Wd S( s+ Closes all adapters and as such the sessionN( R| t valuesRH ( R^ R$ ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyRH b s c C so | | j | <g | j D]$ } t | <00> t | <00> k r | ^ q } x' | D] } | j j | <00> | j | <qH Wd S( sk Registers a connection adapter to a prefix.
|
|||
|
|
|
|||
|
|
Adapters are sorted in descending order by key length.N( R| t lenR<6E> ( R^ R<> R<> R# t keys_to_movet key( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyR} g s
4
c s t <00> f d <00> <00> j D<> <00> S( Nc 3 s' | ] } | t <00> | d <00> f Vq d S( N( t getattrR! ( R" t attr( R^ ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pys <genexpr>s s ( R( t __attrs__( R^ ( ( R^ sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt __getstate__r s c C s1 x* | j <00> D] \ } } t | | | <00> q
Wd S( N( R' t setattr( R^ t stateR<65> t value( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt __setstate__u s N( Rt Ru t __doc__R<5F> R~ R R<> R<> R! Rv Rg R/ R<> R<> R<> R<> R<> R<> R] R<> RH R} R<> R<> ( ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyRw <00> sD 3 ( S
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
G
|
|||
|
|
c C s t <00> S( s2 Returns a :class:`Session` for context-management.( Rw ( ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt sessionz s (4 R<> R<> t collectionsR R Rx R t compatR R R R R RY R R R
|
|||
|
|
R t modelsR R
R Ry R R t utilsR R R t
|
|||
|
|
exceptionsR R R R t
|
|||
|
|
structuresR R| R R R R R R t status_codesR R R- R2 t objectR3 Rw R<> ( ( ( sS c:\users\lifqian\appdata\local\temp\pip_build_lifqian\requests\requests\sessions.pyt <module>
|
|||
|
|
s* (" "( ! <16><16> <00>
|