]ʻt d dl mZ d dlZd dlZd dlmZ ddlmZ ddl m
Z
ddl m Z m
Z
ddlmZ d gZej ej ej eej eef f ej eej eef f f Z G d
d ZdS ) ) annotationsN) urlencode )
_TYPE_BODY)HTTPHeaderDict) _TYPE_FIELDSencode_multipart_formdata)BaseHTTPResponseRequestMethodsc h e Zd ZdZh dZd d!dZ d"d#dZ d$d%d Z d&d'd Z d"d(d Z dS ))r a
Convenience mixin for classes who implement a :meth:`urlopen` method, such
as :class:`urllib3.HTTPConnectionPool` and
:class:`urllib3.PoolManager`.
Provides behavior for making common types of HTTP request methods and
decides which type of request field encoding to use.
Specifically,
:meth:`.request_encode_url` is for sending requests whose fields are
encoded in the URL (such as GET, HEAD, DELETE).
:meth:`.request_encode_body` is for sending requests whose fields are
encoded in the *body* of the request using multipart or www-form-urlencoded
(such as for POST, PUT, PATCH).
:meth:`.request` is for making any kind of request, it will look up the
appropriate encoding format and use one of the above two methods to make
the request.
Initializer parameters:
:param headers:
Headers to include with all requests, unless other headers are given
explicitly.
> GETHEADDELETEOPTIONSNheaders typing.Mapping[str, str] | NonereturnNonec |pi | _ d S N)r )selfr s j/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/urllib3/_request_methods.py__init__zRequestMethods.__init__3 s }" Tmethodstrurlbody_TYPE_BODY | Noneencode_multipartboolmultipart_boundary
str | Nonekw
typing.Anyr
c t d )NzMClasses extending RequestMethods must implement their own ``urlopen`` method.)NotImplementedError)r r r r r r r" r$ s r urlopenzRequestMethods.urlopen6 s "
,
r fields_TYPE_FIELDS | Nonejsontyping.Any | None
urlopen_kwc | }||t d |x|| j }dt t
j | vrd|d< t j |dd
d }|||d
< || j v r | j ||f||d |S | j
||f||d |S ) a
Make a request using :meth:`urlopen` with the appropriate encoding of
``fields`` based on the ``method`` used.
This is a convenience method that requires the least amount of manual
effort. It can be used in most situations, while still having the
option to drop down to more specific methods when necessary, such as
:meth:`request_encode_url`, :meth:`request_encode_body`,
or even the lowest level :meth:`urlopen`.
NzUrequest got values for both 'body' and 'json' parameters which are mutually exclusivez content-typezapplication/json Content-Type),:F)
separators ensure_asciizutf-8r )r) r )upper TypeErrorr copymapr lowerkeys_jsondumpsencode_encode_url_methodsrequest_encode_urlrequest_encode_body)r r r r r) r r+ r- s r requestzRequestMethods.requestE s1 ( 0g
,++--"c#)W\\^^&D&DDD*<';t
OOOVV D !%Jv T- - -*4*
,4+$*G ?I
r _TYPE_ENCODE_URL_FIELDS | Nonec || j }d|i}| | |r|dt | z z
} | j ||fi |S )z
Make a request using :meth:`urlopen` with the ``fields`` encoded in
the url. This is useful for request methods like GET, HEAD, DELETE, etc.
Nr ?)r updater r( )r r r r) r r- extra_kws r r> z!RequestMethods.request_encode_urlz sg ?lG+4g*>
### + 36*** *Ct|FC448444r c : || j }dt | i}|r\d|v rt d |rt || \ } }
nt | d}
} | |d< |d d|
| | | j ||fi |S )a
Make a request using :meth:`urlopen` with the ``fields`` encoded in
the body. This is useful for request methods like POST, PUT, PATCH, etc.
When ``encode_multipart=True`` (default), then
:func:`urllib3.encode_multipart_formdata` is used to encode
the payload with the appropriate content type. Otherwise
:func:`urllib.parse.urlencode` is used with the
'application/x-www-form-urlencoded' content type.
Multipart encoding must be used when posting files, and it's reasonably
safe to use it in other times too. However, it may break request
signing, such as with OAuth.
Supports an optional ``fields`` parameter of key/value strings AND
key/filetuple. A filetuple is a (filename, data, MIME type) tuple where
the MIME type is optional. For example::
fields = {
'foo': 'bar',
'fakefile': ('foofile.txt', 'contents of foofile'),
'realfile': ('barfile.txt', open('realfile').read()),
'typedfile': ('bazfile.bin', open('bazfile').read(),
'image/jpeg'),
'nonamefile': 'contents of nonamefile field',
}
When uploading a file, providing a filename (the first parameter of the
tuple) is optional but recommended to best mimic behavior of browsers.
Note that if ``headers`` are supplied, the 'Content-Type' header will
be overwritten because it depends on the dynamic random boundary string
which is used to compose the body of the request. The random boundary
string can be explicitly set with the ``multipart_boundary`` parameter.
Nr r zFrequest got values for both 'fields' and 'body', can only specify one.)boundaryz!application/x-www-form-urlencodedr/ )r r r5 r r
setdefaultrD r( ) r r r r) r r r" r- rE r content_types r r? z"RequestMethods.request_encode_body s Z ?lG+4nW6M6M*N I## \
%>%7& & &"ll
f%%7 #
$HV Y * *>< H H H
###t|FC448444r r )r r r r )NNTN)r r r r r r r r r r! r" r# r$ r% r r
)NNNN)r r r r r r r) r* r r r+ r, r- r% r r
)NN) r r r r r) rA r r r- r r r
)r r r r r) r* r r r r! r" r# r- r r r
)
__name__
__module__ __qualname____doc__r= r r( r@ r> r? r r r r s 8 ?>>% % % % % #'37!%)-
& #'&*37"&3 3 3 3 3r 2637 5 5 5 5 56 '+37!%)-H5 H5 H5 H5 H5 H5 H5r )
__future__r r+ r: typing urllib.parser _base_connectionr _collectionsr filepostr r responser
__all__UnionSequenceTupler bytesMapping_TYPE_ENCODE_URL_FIELDSr rN r r r] s " " " " " "
" " " " " " ( ( ( ( ( ( ( ( ( ( ( ( = = = = = = = = & & & & & &
,
OFLfl3:&>!>?@
N3 S%Z0013 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5r