R`i؉ d d Z ddlZddlZddlmZ ddlmZmZm Z m
Z
m Z ddl m
Z
ddlmZ ddlmZ dd lmZmZ dd
lmZ dd lmZmZmZmZm Z m Z m Z dd lm Z dd
lm!Z!m"Z"m#Z# ddl$m%Z%m&Z&m'Z' ddl(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z. ddl(mZ/ ddl(m0Z0 ddl(m Z1 ddl(m2Z2 ddl3m4Z4 ddl5m6Z6 ddl7m8Z8 ddl9m:Z:m;Z;mZ>m?Z?m@Z@mAZAmBZBmCZC e6j e6j e6j e6j e6j fZIdZJdZKdZL G d d ZM G d d ZN G d d eN ZO G d! d"eMeN ZP G d# d$ ZQy)%z`
requests.models
~~~~~~~~~~~~~~~
This module contains the primary objects that power Requests.
N)UnsupportedOperation) DecodeErrorLocationParseError
ProtocolErrorReadTimeoutErrorSSLError) RequestField)encode_multipart_formdata) parse_url )to_native_stringunicode_is_ascii)
HTTPBasicAuth)CallableJSONDecodeErrorMapping
basestring builtin_strchardet cookielib)json) urlencodeurlsplit
urlunparse)_copy_cookie_jarcookiejar_from_dictget_cookie_header)ChunkedEncodingErrorConnectionErrorContentDecodingError HTTPErrorInvalidJSONError
InvalidURL)r )
MissingSchema)r )StreamConsumedError)
default_hooks)codes)CaseInsensitiveDict)
check_header_validityget_auth_from_urlguess_filenameguess_json_utf iter_slicesparse_header_links requote_uri stream_decode_response_unicode super_lento_key_val_list i ( i c < e Zd Zed Zed Zed Zy)RequestEncodingMixinc g }t | j }|j }|sd}|j | |j }|r"|j d |j | dj | S )zBuild the path URL to use./? )r urlpathappendqueryjoin)selfr: pr; r= s /builddir/build/BUILDROOT/alt-python312-pip-23.3.1-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/pip/_vendor/requests/models.pypath_urlz RequestEncodingMixin.path_urlU se TXX vvD
4 JJsO JJu wws| c t | t t f r| S t | d r| S t | d rg }t | D ] \ }}t |t
s t |d s|g}|D ]Z }||j
t |t r|j d n|t |t r|j d n|f \ t |d S | S )zEncode parameters in a piece of data.
Will successfully encode parameters when passed as a dict or a list of
2-tuples. Order is retained if data is a list of 2-tuples but arbitrary
if parameters are supplied as a dict.
read__iter__utf-8T)doseq)
isinstancestrbyteshasattrr2 r r< encoder )dataresultkvsvs rA _encode_paramsz#RequestEncodingMixin._encode_paramsj s dS%L )K
T6
"K
T:
&F(.2 b*-WR5L BA}
5?35G 1Q5?35G 1Q / V40 0KrC c | s t d t |t r t d g }t |xs i }t | xs i } |D ] \ }}t |t s t |d s|g}|D ]u }|t |t
s t
| }|j t |t
r|j d n|t |t r|j d n|f w | D ] \ }}d}d} t |t t f r1t | dk( r|\ }
} n.t | dk( r|\ }
} }n|\ }
} }} nt | xs |}
|} t | t t
t f r| } n"t | d r| j } n| | } t! || |
| }
|
j# |
|j |
t% | \ }}||fS ) a Build the body for a multipart/form-data request.
Will successfully encode files when passed as a dict or a list of
tuples. Order is retained if data is a list of tuples but arbitrary
if parameters are supplied as a dict.
The tuples may be 2-tuples (filename, fileobj), 3-tuples (filename, fileobj, contentype)
or 4-tuples (filename, fileobj, contentype, custom_headers).
zFiles must be provided.zData must not be a string.rF NrG rE )namerN filenameheaders) content_type)
ValueErrorrI r r2 rL rK rJ r< decoderM tuplelistlenr+ bytearrayrE r make_multipartr
)filesrN
new_fieldsfieldsfieldvalrR rP ftfhfnfpfdatarfbodyrZ s rA
_encode_filesz"RequestEncodingMixin._encode_files s 67 7
j
) 9: :
, , JE3#z*'#z2Je=%a/ F %% *% 7 "LL 1!&1;As1CAHHW -
!$ FQBB!eT]+q6Q; FBVq[!"JBB%&NBB#A&+!"sE9 56V$ 152rJB 2 . b !5 8 7z Bl\!!rC N)__name__
__module__ __qualname__propertyrB staticmethodrS rn rC rA r5 r5 T s>
( : B" B"rC r5 c e Zd Zd Zd Zy)RequestHooksMixinc || j vrt d| d t |t r | j | j | yt |d r&| j | j
d |D yy)zProperly register a hook.z.Unsupported event specified, with event name ""rF c 3 B K | ] }t |t s| y wN)rI r ).0hs rA z2RequestHooksMixin.register_hook.. s $P1
1h8OQs N)hooksr[ rI r r< rL extendr? eventhooks rA
register_hookz RequestHooksMixin.register_hook ss
" MeWTU VW W dH % JJu $ $T *
T:
& JJu $ $$P$P P 'rC c ` | j | j | y# t $ r Y yw xY w)ziDeregister a previously registered hook.
Returns True if the hook existed, False if not.
TF)r~ remover[ r s rA deregister_hookz!RequestHooksMixin.deregister_hook s3
JJu $ $T * s ! --N)ro rp rq r r rt rC rA rv rv s
Q rC rv c 8 e Zd ZdZ ddZd Zd Zy)Requesta{ A user-created :class:`Request ` object.
Used to prepare a :class:`PreparedRequest `, which is sent to the server.
:param method: HTTP method to use.
:param url: URL to send.
:param headers: dictionary of headers to send.
:param files: dictionary of {filename: fileobject} files to multipart upload.
:param data: the body to attach to the request. If a dictionary or
list of tuples ``[(key, value)]`` is provided, form-encoding will
take place.
:param json: json for the body to attach to the request (if files or data is not specified).
:param params: URL parameters to append to the URL. If a dictionary or
list of tuples ``[(key, value)]`` is provided, form-encoding will
take place.
:param auth: Auth handler or (user, pass) tuple.
:param cookies: dictionary or CookieJar of cookies to attach to this request.
:param hooks: dictionary of callback hooks, for internal usage.
Usage::
>>> import requests
>>> req = requests.Request('GET', 'https://httpbin.org/get')
>>> req.prepare()
Nc D |g n|}|g n|}|i n|}|i n|}| i n| } t | _ t | j D ] \ } } | j | | || _ || _ || _ || _ || _ |
| _
|| _ || _ || _
y )N)r r )r& r~ r^ itemsr methodr: rY rb rN r paramsauthcookies)
r? r r: rY rb rN r r r r~ r rP rR s
rA __init__zRequest.__init__ s \rtm "W ~6m"_
5;;=)FQ QQ / *
rC c " d| j dS )Nz
r r? s rA __repr__zRequest.__repr__% s DKK=++rC c t }|j | j | j | j | j
| j | j | j | j | j | j
|S )zXConstructs a :class:`PreparedRequest ` for transmission and returns it.)
r r: rY rb rN r r r r r~ ) PreparedRequestpreparer r: rY rb rN r r r r r~ r? r@ s rA r zRequest.prepare( sh ;;LL**;;LL**
rC
NNNNNNNNNN)ro rp rq __doc__r r r rt rC rA r r s7 :
! F,rC r c e Zd ZdZd Z ddZd Zd Zd Ze d Z
d Z d
Z dd Z
d Zdd
Zd Zd Zy)r a) The fully mutable :class:`PreparedRequest ` object,
containing the exact bytes that will be sent to the server.
Instances are generated from a :class:`Request ` object, and
should not be instantiated manually; doing so may produce undesirable
effects.
Usage::
>>> import requests
>>> req = requests.Request('GET', 'https://httpbin.org/get')
>>> r = req.prepare()
>>> r
>>> s = requests.Session()
>>> s.send(r)
c v d | _ d | _ d | _ d | _ d | _ t | _ d | _ y rz )r r: rY _cookiesrm r& r~ _body_positionr s rA r zPreparedRequest.__init__O s8
"_
"rC Nc | j | | j || | j | | j | | j |||
| j || | j
| y)z6Prepares the entire request with the given parameters.N)prepare_method prepare_urlprepare_headersprepare_cookies prepare_body prepare_auth
prepare_hooks) r? r r: rY rb rN r r r r~ r s rA r zPreparedRequest.prepare` sp
F# f% W% W% $t, $$
5!rC c " d| j dS )Nz?DK #rC c ddl m} |j | d j d } | S # |j $ r t
w xY w)Nr )idnaT)uts46rG ) pip._vendorr rM r\ IDNAError UnicodeError)hostr s rA _get_idna_encoded_hostz&PreparedRequest._get_idna_encoded_host sI $ ;;t4;077@D ~~ s ", Ac
2 t |t r|j d }n t | }|j }d|v r'|j j
d s|| _ y t | \ }}}}}}} |st d|d| d |st d|d t | s | j | }n |j
d
r t d |xs d } | r| d z
} | |z
} |r| d| z
} |sd
}t |t t f r t! | }| j# | } | r |r| d| }n| }t% t' || |d|| g }|| _ y# t $ r}
t |
j d}
~
ww xY w# t $ r t d w xY w)z Prepares the given HTTP URL.utf8:httpNz Invalid URL z0: No scheme supplied. Perhaps you meant https://r8 z: No host suppliedzURL has an invalid label.)*.r9 @r7 &)rI rK r\ rJ lstriplower
startswithr: r r r# argsr$ r r r r
rS r/ r )
r? r: r schemer r portr; r= fragmentenetloc
enc_paramss
rA r zPreparedRequest.prepare_url s c5 !**V$Cc(C jjl
#:ciik 4 4V <DH &>Gn ;FD$dE8 sg &--0E4
|C72D EF F %
>2248 __Z
( 89 9 cMF$ $j F D fsEl +%f-F((0
':,/"*ffdD%%RST_ " & aff% % &&
> !<==
>s$ *E .F E>'E99E>Fc t | _ |r>|j D ]* }t | |\ }}|| j t | < , yy)z Prepares the given HTTP headers.N)r( rY r r) r
)r? rY headerrW values rA r z PreparedRequest.prepare_headers sK +, !--/%f- $ e7< -d 34 * rC c
d}d}|s=|;d} t j |d }t |t
s|j
d }t t |d t |t t t t f g }|rw t | }|}t# |dd |j% | _ |r t- d |r t/ | | j0 d
< || _ yd | j0 d < || _ y|r| j3 || \ }}n4|r2| j5 | }t |t s t |d
rd}nd}| j7 | |r d| j0 vr|| j0 d< || _ y# t $ r}t || d}~ww xY w# t t t f$ r d}Y &w xY w# t( $ r t+ | _ Y w xY w)z"Prepares the given HTTP body data.Nzapplication/jsonF) allow_nan)requestrG rF tellz1Streamed bodies and files are mutually exclusive.Content-LengthchunkedzTransfer-EncodingrE z!application/x-www-form-urlencodedz content-typez Content-Type) complexjsondumpsr[ r" rI rK rM allrL r r^ r] r r1 TypeErrorAttributeErrorr getattrr r OSErrorobjectNotImplementedErrorr rY rn rS prepare_content_lengthrm ) r? rN rb r rm rZ ve is_streamlengths rA r z PreparedRequest.prepare_body s ( .L
9"((? dE*{{7+j) tj$w%GHH
"4 DtVT*63*.))+D' )G 1 01& ! '+'9'9%'F$| ..t4D!$
3wtV7L'+ 'J ' ' - t||!C/; ^, w
9&r488
9 ~/CD
3 +1(D'3s; E7 = F F2 7 F
F
FF/.F/2G
Gc |'t | }|rt | | j d< yy| j dvr,| j j d d| j d< yyy)z>Prepare Content-Length header based on request method and bodyNr )GETHEAD0)r1 r rY r get)r? rm r s rA r z&PreparedRequest.prepare_content_length= sn t_F 2=V1D -.
KK . !12: .1DLL) * ;
/rC c 2 |$t | j }t | r|nd}|rot |t rt | dk( rt
| } || }| j j |j | j | j yy)z"Prepares the given HTTP auth data.NrU ) r* r: anyrI r] r_ r __dict__updater rm )r? r r: url_authrs rA r z PreparedRequest.prepare_authM s <(2H "8}8$D $&3t9>$d+ T
A
MM ,
' ' 2 rC c t |t j r|| _ nt | | _ t | j | }||| j d< yy)a Prepares the given HTTP cookie data.
This function eventually generates a ``Cookie`` header from the
given cookies using cookielib. Due to cookielib's design, the header
will not be regenerated if it already exists, meaning this function
can only be called once for the life of the
:class:`PreparedRequest ` object. Any subsequent calls
to ``prepare_cookies`` will have no actual effect, unless the "Cookie"
header is removed beforehand.
NCookie)rI r CookieJarr r r rY )r? r
cookie_headers rA r z PreparedRequest.prepare_cookiesc sP gy 2 2 3 #DM / 8DM)$-->
$%2DLL " %rC c H |xs g }|D ] }| j ||| y)zPrepares the given hooks.N)r )r? r~ r s rA r z PreparedRequest.prepare_hooksw s+
E ueEl 3 rC r rz )r9 )ro rp rq r r r r r r rs r r r r r r r r rt rC rA r r : s| (#&
"84 @ HT =L\1 3,3(4rC r c e Zd ZdZg dZd Zd Zd Zd Zd Z d Z
d Z d
Z d Z
ed Zed
Zed Zed Zed ZddZeddfdZed Zed Zd Zed Zd Zd Z y) ResponsezhThe :class:`Response ` object, which contains a
server's response to an HTTP request.
)
_content status_coderY r: historyencodingreasonr elapsedr c d| _ d| _ d | _ d | _ t | _ d | _ d | _ d | _ g | _ d | _
t i | _ t j d | _ d | _ y )NFr )r _content_consumed_nextr r( rY rawr: r r r r r datetime timedeltar r r s rA r zResponse.__init__ s
!&
+,
+2. ))!, rC c | S rz rt r s rA __enter__zResponse.__enter__ s rC c $ | j y rz )close)r? r s rA __exit__zResponse.__exit__ s
rC c | j s | j | j D ci c] }|t | |d c}S c c}w rz )r content __attrs__r )r? attrs rA __getstate__zResponse.__getstate__ s> %% LL<@NNKNDgdD$//NKKKs ?c |j D ] \ }}t | || t | dd t | dd y )Nr Tr )r setattr)r? staterW r s rA __setstate__zResponse.__setstate__ s= ;;=KD% D$ & ) )40eT"rC c " d| j dS )Nz .>..PPrC c z d| j v xr, | j t j t j fv S )z@True if this Response one of the permanent versions of redirect.r )rY r r' moved_permanentlypermanent_redirectr s rA is_permanent_redirectz Response.is_permanent_redirect s? T\\)
d.>.> # # $ $C
/
rC c | j S )zTReturns a PreparedRequest for the next request in a redirect chain, if there is one.)r r s rA nextz
Response.next s zzrC c F t j | j d S )zOThe apparent encoding, provided by the charset_normalizer or chardet libraries.r )r detectr r s rA apparent_encodingzResponse.apparent_encoding s ~~dll+J77rC Fc @ fd} j r$t j t r
t (t t
st
dt d t j } | } j r|n|}|r t | }|S )a Iterates over the response data. When stream=True is set on the
request, this avoids reading the content at once into memory for
large responses. The chunk size is the number of bytes it should
read into memory. This is not necessarily the length of each item
returned as decoding can take place.
chunk_size must be of type int or None. A value of None will
function differently depending on the value of `stream`.
stream=True will read data as it arrives in whatever size the
chunks are received. If stream=False, data is returned as
a single chunk.
If decode_unicode is True, content will be decoded using the best
available encoding based on the response.
c 3 K t j d r. j j d E d { d_ y j j }|s d_ y | +7 8# t $ r} t | d } ~ wt
$ r} t
| d } ~ wt $ r} t | d } ~ wt $ r} t | d } ~ ww xY ww)NstreamT)decode_content)
rL r r% r r r r r r r RequestsSSLErrorrE r )r chunk
chunk_sizer? s rA generatez'Response.iter_content..generate, s txx* . #xxz$ OOO" &*D "
HHMM* 5E &*D " K P$ 2.q11" 2.q11' -)!,, .*1--.s\ C A6 A4A6 4C4A6 6 C? B
C B!! C- B88 C CCCz+chunk_size must be an int, it is instead a r )
r rI r boolr% intr typer- r0 )r? r) decode_unicoder*
reused_chunks
stream_chunkschunkss `` rA r zResponse.iter_content s " *. ! !j &E%' '
#Jz3,G=d:>N=OqQ
$DMM:>
"&"8"8 m 3FDAF
rC Nc # K d}| j || D ]a }|||z }|r|j | }n|j }|r&|d r!|r |d d |d k( r|j }nd}|E d{ c || yy7 w)zIterates over the response data, one line at a time. When
stream=True is set on the request, this avoids reading the
content at once into memory for large responses.
.. note:: This method is not reentrant safe.
N)r) r. )r split
splitlinespop)r? r) r. delimiterpendingr( liness rA
iter_lineszResponse.iter_linesU s &&!. '
E " % I. ((*rur2 %)1K ))+ #
& M
s A3B5B6Bc | j du rg| j r t d | j dk( s | j d| _ n-dj | j
t xs d| _ d| _ | j S )z"Content of the response, in bytes.Fz2The content for this response was already consumedr NrC T)r r RuntimeErrorr r r> r CONTENT_CHUNK_SIZEr s rA r zResponse.contentw sy ==E !%%"#WXX 1$(8 $
#):):;M)N O VSV
!% }} rC c d}| j }| j sy| j | j } t | j |d }|S # t t
f$ r t | j d }Y |S w xY w)a Content of the response, in unicode.
If Response.encoding is None, encoding will be guessed using
``charset_normalizer`` or ``chardet``.
The encoding of the response content is determined based solely on HTTP
headers, following RFC 2616 to the letter. If you can take advantage of
non-HTTP knowledge to make a better guess at the encoding, you should
set ``r.encoding`` appropriately before accessing this property.
Nr9 replace)errors)r r r" rJ LookupErrorr )r? r r s rA textz
Response.text s~ ==|| == --H :$,,CG Y' : $,,y9G :s A &A98A9c 6 | j sk| j r_t | j dkD rGt | j }|0 t j
| j j
| fi |S t j
| j fi |S # t $ r Y ,t $ r0}t |j |j |j d}~ww xY w# t $ r0}t |j |j |j d}~ww xY w)zReturns the json-encoded content of a response, if any.
:param \*\*kwargs: Optional arguments that ``json.loads`` takes.
:raises requests.exceptions.JSONDecodeError: If the response body does not
contain valid json.
rV N)r r r_ r, r loadsr\ UnicodeDecodeErrorr RequestsJSONDecodeErrormsgdocposrB )r? kwargsr r s rA r z
Response.json s }} #dll2Ca2G
&dll3H# G&,,T\\-@-@-JUfUU ? $$TYY9&9 9 *
& G1!%%FFG
? *!%%> > ?s6 .B 9 C C $C ,+CC D(+DDc | j j d }i }|r;t | }|D ]+ }|j d xs |j d }|||< - |S )z8Returns the parsed header links of the response, if any.linkrelr: )rY r r. )r? r resolved_linkslinksrL keys rA rO zResponse.links s` !!&) &v.E hhuo8% &*s# rC c d}t | j t r | j j d }n | j }d| j
cxk rdk r"n n | j
d| d| j }n6d| j
cxk rdk r!n n | j
d | d| j }|r
t ||
y # t $ r | j j d }Y w xY w) z+Raises :class:`HTTPError`, if one occurred.r9 rG z
iso-8859-1i i z Client Error: z
for url: iX z Server Error: )responseN)rI r rK r\ rE r r: r! )r? http_error_msgr s rA r zResponse.raise_for_status s dkk5 )
: ++G4 [[F $"" (S (##$OF8:dhhZP
D$$
*s
*##$OF8:dhhZP
NT: : &
: ++L9
:s C $C*)C*c | j s| j j t | j dd }| | yy)zReleases the connection back to the pool. Once this method has been
called the underlying ``raw`` object must not be accessed again.
*Note: Should not normally need to be called explicitly.*
release_connN)r r r r )r? rU s rA r zResponse.close s= %% HHNN txx > # N $rC )r F) ro rp rq r r r r r r r r r
r rF rr r r r r r" r ITER_CHUNK_SIZEr: r rB r rO r r rt rC rA r r s I- ^L#2& Q Q
8 88v )$ D $ # #J ?B ;: rC r )Rr r encodings.idna encodingsior pip._vendor.urllib3.exceptionsr r r r r pip._vendor.urllib3.fieldsr pip._vendor.urllib3.filepostr
pip._vendor.urllib3.utilr _internal_utilsr
r r r compatr r r r r r r r r r r r r r r r
exceptionsr r r r! r" r# rF r$ r' r% r~ r& status_codesr'
structuresr( utilsr) r* r+ r, r- r. r/ r0 r1 r2 movedfoundothertemporary_redirectr r DEFAULT_REDIRECT_LIMITr= rV r5 rv r r r rt rC rA ri s
# 4 B . ? ( 3 3 M M C % 4 + +
KK KK KK w" w"t 0Q QhD4*,= D4N
I IrC