U
|
Þ=®d³^ ã @ s® d dl mZ d dlZd dlZd dlmZ d dlmZ ddlm Z ddlm
|
Z
|
ddlm Z dd lm Z dd
|
lm Z dd lmZ dd lmZ dd lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z dd lm Z dd l!m"Z" dd l#m$Z$ dd l#m%Z% d d!lm&Z& d d"l#m'Z' d d#l#m(Z( d d$l#m)Z) G d%d& d&Z*dS )'é )Ú annotationsN)Údatetime)Ú parse_qslé )ÚAccept)Ú Authorization)Ú CharsetAccept)ÚETags)ÚHeaders)Ú HeaderSet)ÚIfRange)Ú ImmutableList)ÚImmutableMultiDict)ÚLanguageAccept)Ú
|
MIMEAccept)Ú MultiDict)ÚRange)ÚRequestCacheControl)Úparse_accept_header)Úparse_cache_control_header)Ú
|
parse_date)Ú parse_etags)Úparse_if_range_header)Úparse_list_header)Úparse_options_header)Úparse_range_header)Úparse_set_header)Ú UserAgent)Úcached_property)Úheader_propertyé )Ú parse_cookie)Úget_content_length)Úget_current_url)Úget_hostc
|
@ s° e Zd ZU dZded< eddddZejdddd dZded
|
< eddd d Zejdddd d Zded< eddddZ e jdddddZ e
|
Z ded< e
|
Z ded< e Zded< eZded< dZded< ddd ddd d d dd d!d"Zddd#d$Zed%dd&d'Zed(dd)d*Zeddd+d,Zed-dd.d/Zeddd0d1Zeddd2d3Zeddd4d5Zeddd6d7Z eddd8d9Z ed:dd;d<Z e e d=d>d?d@Z!edAddBdCZ"e e dDdEd?d@Z#e e dFdGd?d@Z$e e dHdId?d@Z%e dJde&dKd?d@Z'e dLde(dMd?d@Z)dddNdOZ*edddPdQZ+edRddSdTZ,edUddVdWZ-edXddYdZZ.ed[dd\d]Z/ed^dd_d`Z0edaddbdcZ1eddddedfZ2edgddhdiZ3edgddjdkZ4edlddmdnZ5edlddodpZ6edqddrdsZ7edtddudvZ8edwddxdyZ9edzdd{d|Z:e e d}d~d?d@Z;e de<dd?dZ=e e ddd?d@Z>ed-ddd
Z?dS )ÚRequesta8 Represents the non-IO parts of a HTTP request, including the
|
method, URL info, and headers.
|
|
This class is not meant for general use. It should only be used when
|
implementing WSGI, ASGI, or another HTTP application spec. Werkzeug
|
provides a WSGI implementation at :cls:`werkzeug.wrappers.Request`.
|
|
:param method: The method the request was made with, such as
|
``GET``.
|
:param scheme: The URL scheme of the protocol the request used, such
|
as ``https`` or ``wss``.
|
:param server: The address of the server. ``(host, port)``,
|
``(path, None)`` for unix sockets, or ``None`` if not known.
|
:param root_path: The prefix that the application is mounted under.
|
This is prepended to generated URLs, but is not part of route
|
matching.
|
:param path: The path part of the URL after ``root_path``.
|
:param query_string: The part of the URL after the "?".
|
:param headers: The headers received with the request.
|
:param remote_addr: The address of the client sending the request.
|
|
.. versionadded:: 2.0
|
ÚstrÚ_charset)Úreturnc C s t jdtdd | jS )zÀThe charset used to decode body, form, and cookie data. Defaults to UTF-8.
|
|
.. deprecated:: 2.3
|
Will be removed in Werkzeug 3.0. Request data must always be UTF-8.
|
úThe 'charset' attribute is deprecated and will not be used in Werkzeug 2.4. Interpreting bytes as text in body, form, and cookie data will always use UTF-8.r ©Ú
|
stacklevel©ÚwarningsÚwarnÚDeprecationWarningr' ©Úself© r2 úNd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\werkzeug/sansio/request.pyÚcharsetC s ûzRequest.charsetÚNone)Úvaluer( c C s t jdtdd || _d S )Nr) r r* r, ©r1 r6 r2 r2 r3 r4 S s ûÚ_encoding_errorsc C s t jdtdd | jS )zHow errors when decoding bytes are handled. Defaults to "replace".
|
|
.. deprecated:: 2.3
|
Will be removed in Werkzeug 3.0.
|
úSThe 'encoding_errors' attribute is deprecated and will not be used in Werkzeug 3.0.r r* ©r- r. r/ r8 r0 r2 r2 r3 Úencoding_errors` s üzRequest.encoding_errorsc C s t jdtdd || _d S )Nr9 r r* r: r7 r2 r2 r3 r; o s üÚ _url_charsetc C s t jdtdd | jS )a0 The charset to use when decoding percent-encoded bytes in :attr:`args`.
|
Defaults to the value of :attr:`charset`, which defaults to UTF-8.
|
|
.. deprecated:: 2.3
|
Will be removed in Werkzeug 3.0. Percent-encoded bytes must always be UTF-8.
|
|
.. versionadded:: 0.6
|
ú{The 'url_charset' attribute is deprecated and will not be used in Werkzeug 3.0. Percent-encoded bytes must always be UTF-8.r r* ©r- r. r/ r< r0 r2 r2 r3 Ú url_charset{ s
|
üzRequest.url_charsetc C s t jdtdd || _d S )Nr= r r* r> r7 r2 r2 r3 r? s üztype[MultiDict]Úparameter_storage_classÚdict_storage_classz type[t.List]Úlist_storage_classztype[UserAgent]Úuser_agent_classNzlist[str] | NoneÚ trusted_hostsz tuple[str, int | None] | NoneÚbytesr
|
z
|
str | None) ÚmethodÚschemeÚserverÚ root_pathÚpathÚ query_stringÚheadersÚ remote_addrr( c C sÚ t t| jts*tjdtdd | j| _nd| _t t| jtsZtjdtdd | j| _ nd| _ t t| j
|
tstjdtdd | j
|
| _ n| j| _ | ¡ | _ || _|| _| d¡| _d| d¡ | _|| _|| _|| _d S ) Nr) r r* úutf-8r9 Úreplacer= ú/)Ú
|
isinstanceÚtyper4 Úpropertyr- r. r/ r' r; r8 r? r< ÚupperrF rG rH ÚrstriprI ÚlstriprJ rK rL rM ) r1 rF rG rH rI rJ rK rL rM r2 r2 r3 Ú__init__É s@ û
|
ü
|
ü
|
|
zRequest.__init__c
|
C sZ z
|
| j }W n. tk
|
r8 } zd| d}W 5 d }~X Y nX dt| j d|d| j dS )Nz(invalid URL: ú)ú<ú z [z]>)ÚurlÚ ExceptionrR Ú__name__rF )r1 r[ Úer2 r2 r3 Ú__repr__ s
|
|
zRequest.__repr__zMultiDict[str, str]c C s | t| j ¡ d| jdd¡S )aÒ The parsed URL parameters (the part in the URL after the question
|
mark).
|
|
By default an
|
:class:`~werkzeug.datastructures.ImmutableMultiDict`
|
is returned from this function. This can be changed by setting
|
:attr:`parameter_storage_class` to a different type. This might
|
be necessary if the order of the form data is important.
|
|
.. versionchanged:: 2.3
|
Invalid bytes remain percent encoded.
|
Tzwerkzeug.url_quote)Úkeep_blank_valuesÚencodingÚerrors)r@ r rK Údecoder< r0 r2 r2 r3 Úargs s üÿz Request.argsz list[str]c C s> d| j kr | t| j d ¡S | jdk r6| | jg¡S | ¡ S )z}If a forwarded header exists this is a list of all ip addresses
|
from the client ip to the last proxy server.
|
zX-Forwarded-ForN)rL rB r rM r0 r2 r2 r3 Ú access_route+ s
|
ÿ
|
zRequest.access_routec C s | j d| j ¡ S )z+Requested path, including the query string.ú?)rJ rK rc r0 r2 r2 r3 Ú full_path8 s zRequest.full_pathÚboolc C s
|
| j dkS )zX``True`` if the request was made with a secure protocol
|
(HTTPS or WSS).
|
> ÚhttpsÚwss)rG r0 r2 r2 r3 Ú is_secure= s zRequest.is_securec C s t | j| j| j| j| jS )zVThe full request URL with the scheme, host, root path, path,
|
and query string.)r# rG ÚhostrI rJ rK r0 r2 r2 r3 r[ D s ÿz Request.urlc C s t | j| j| j| jS )z.Like :attr:`url` but without the query string.)r# rG rl rI rJ r0 r2 r2 r3 Úbase_urlL s zRequest.base_urlc C s t | j| j| jS )zuThe request URL scheme, host, and root path. This is the root
|
that the application is accessed from.
|
)r# rG rl rI r0 r2 r2 r3 Úroot_urlQ s zRequest.root_urlc C s t | j| jS )z%The request URL scheme and host only.)r# rG rl r0 r2 r2 r3 Úhost_urlX s zRequest.host_urlc C s t | j| j d¡| j| jS )zThe host name the request was made to, including the port if
|
it's non-standard. Validated with :attr:`trusted_hosts`.
|
rl )r$ rG rL ÚgetrH rD r0 r2 r2 r3 rl ] s
|
ÿz Request.hostz ImmutableMultiDict[str, str]c C sL d | j d¡¡}| jdkr"| jnd}| jdkr6| jnd}t|||| jdS )zVA :class:`dict` with the contents of all cookies transmitted with
|
the request.ú;ÚCookierN NrO )r4 rb Úcls)ÚjoinrL Úgetlistr' r8 r! rA )r1 Zwsgi_combined_cookier4 rb r2 r2 r3 Úcookiesf s üzRequest.cookiesú Content-TypezçThe Content-Type entity-header field indicates the media
|
type of the entity-body sent to the recipient or, in the case of
|
the HEAD method, the media type that would have been sent had
|
the request been a GET.T)ÚdocÚ read_onlyz
|
int | Nonec C s t | j d¡| j d¡dS )zìThe Content-Length entity-header field indicates the size of the
|
entity-body in bytes or, in the case of the HEAD method, the size of
|
the entity-body that would have been sent had the request been a
|
GET.
|
zContent-LengthzTransfer-Encoding)Zhttp_content_lengthZhttp_transfer_encoding)r" rL rp r0 r2 r2 r3 Úcontent_length s
|
|
þzRequest.content_lengthzContent-Encodinga The Content-Encoding entity-header field is used as a
|
modifier to the media-type. When present, its value indicates
|
what additional content codings have been applied to the
|
entity-body, and thus what decoding mechanisms must be applied
|
in order to obtain the media-type referenced by the Content-Type
|
header field.
|
|
.. versionadded:: 0.9z Content-MD5a The Content-MD5 entity-header field, as defined in
|
RFC 1864, is an MD5 digest of the entity-body for the purpose of
|
providing an end-to-end message integrity check (MIC) of the
|
entity-body. (Note: a MIC is good for detecting accidental
|
modification of the entity-body in transit, but is not proof
|
against malicious attacks.)
|
|
.. versionadded:: 0.9ZRefererzúThe Referer[sic] request-header field allows the client
|
to specify, for the server's benefit, the address (URI) of the
|
resource from which the Request-URI was obtained (the
|
"referrer", although the header field is misspelled).ÚDatezÿThe Date general-header field represents the date and
|
time at which the message was originated, having the same
|
semantics as orig-date in RFC 822.
|
|
.. versionchanged:: 2.0
|
The datetime object is timezone-aware.
|
z Max-ForwardszÙThe Max-Forwards request-header field provides a
|
mechanism with the TRACE and OPTIONS methods to limit the number
|
of proxies or gateways that can forward the request to the next
|
inbound server.c C s" t | ds t| j dd¡| _d S )NÚ_parsed_content_typerw Ú )Úhasattrr rL rp r| r0 r2 r2 r3 Ú_parse_content_typeà s
|
ÿzRequest._parse_content_typec C s | ¡ | jd ¡ S )zñLike :attr:`content_type`, but without parameters (eg, without
|
charset, type etc.) and always lowercase. For example if the content
|
type is ``text/HTML; charset=utf-8`` the mimetype would be
|
``'text/html'``.
|
r )r r| Úlowerr0 r2 r2 r3 ÚmimetypeÉ s zRequest.mimetypezdict[str, str]c C s | ¡ | jd S )z¨The mimetype parameters as dict. For example if the content
|
type is ``text/html; charset=utf-8`` the params would be
|
``{'charset': 'utf-8'}``.
|
r )r r| r0 r2 r2 r3 Úmimetype_paramsÓ s zRequest.mimetype_paramsr c C s t | j dd¡S )aj The Pragma general-header field is used to include
|
implementation-specific directives that might apply to any recipient
|
along the request/response chain. All pragma directives specify
|
optional behavior from the viewpoint of the protocol; however, some
|
systems MAY require that behavior be consistent with the directives.
|
ZPragmar} )r rL rp r0 r2 r2 r3 ÚpragmaÜ s zRequest.pragmar c C s t | j d¡tS )zoList of mimetypes this client supports as
|
:class:`~werkzeug.datastructures.MIMEAccept` object.
|
r )r rL rp r r0 r2 r2 r3 Úaccept_mimetypesè s zRequest.accept_mimetypesr c C s t | j d¡tS )zqList of charsets this client supports as
|
:class:`~werkzeug.datastructures.CharsetAccept` object.
|
zAccept-Charset)r rL rp r r0 r2 r2 r3 Úaccept_charsetsï s zRequest.accept_charsetsr c C s t | j d¡S )z¶List of encodings this client accepts. Encodings in a HTTP term
|
are compression encodings such as gzip. For charsets have a look at
|
:attr:`accept_charset`.
|
zAccept-Encoding)r rL rp r0 r2 r2 r3 Úaccept_encodingsö s zRequest.accept_encodingsr c C s t | j d¡tS )a List of languages this client accepts as
|
:class:`~werkzeug.datastructures.LanguageAccept` object.
|
|
.. versionchanged 0.5
|
In previous versions this was a regular
|
:class:`~werkzeug.datastructures.Accept` object.
|
zAccept-Language)r rL rp r r0 r2 r2 r3 Úaccept_languagesþ s zRequest.accept_languagesr c C s | j d¡}t|dtS )zwA :class:`~werkzeug.datastructures.RequestCacheControl` object
|
for the incoming cache control headers.
|
z Cache-ControlN)rL rp r r )r1 Ú cache_controlr2 r2 r3 r s zRequest.cache_controlr c C s t | j d¡S )z~An object containing all the etags in the `If-Match` header.
|
|
:rtype: :class:`~werkzeug.datastructures.ETags`
|
zIf-Match©r rL rp r0 r2 r2 r3 Úif_match s zRequest.if_matchc C s t | j d¡S )zAn object containing all the etags in the `If-None-Match` header.
|
|
:rtype: :class:`~werkzeug.datastructures.ETags`
|
z If-None-Matchr r0 r2 r2 r3 Ú if_none_match s zRequest.if_none_matchzdatetime | Nonec C s t | j d¡S )zThe parsed `If-Modified-Since` header as a datetime object.
|
|
.. versionchanged:: 2.0
|
The datetime object is timezone-aware.
|
zIf-Modified-Since©r rL rp r0 r2 r2 r3 Úif_modified_since# s zRequest.if_modified_sincec C s t | j d¡S )zThe parsed `If-Unmodified-Since` header as a datetime object.
|
|
.. versionchanged:: 2.0
|
The datetime object is timezone-aware.
|
zIf-Unmodified-Sincer r0 r2 r2 r3 Úif_unmodified_since, s zRequest.if_unmodified_sincer c C s t | j d¡S )zThe parsed ``If-Range`` header.
|
|
.. versionchanged:: 2.0
|
``IfRange.date`` is timezone-aware.
|
|
.. versionadded:: 0.7
|
zIf-Range)r rL rp r0 r2 r2 r3 Úif_range5 s zRequest.if_rangez Range | Nonec C s t | j d¡S )z{The parsed `Range` header.
|
|
.. versionadded:: 0.7
|
|
:rtype: :class:`~werkzeug.datastructures.Range`
|
r )r rL rp r0 r2 r2 r3 Úrange@ s z Request.ranger c C s | | j dd¡¡S )a« The user agent. Use ``user_agent.string`` to get the header
|
value. Set :attr:`user_agent_class` to a subclass of
|
:class:`~werkzeug.user_agent.UserAgent` to provide parsing for
|
the other properties or other extended data.
|
|
.. versionchanged:: 2.1
|
The built-in parser was removed. Set ``user_agent_class`` to a ``UserAgent``
|
subclass to parse data from the string.
|
z
|
User-Agentr} )rC rL rp r0 r2 r2 r3 Ú
|
user_agentL s zRequest.user_agentzAuthorization | Nonec C s t | j d¡¡S )aG The ``Authorization`` header parsed into an :class:`.Authorization` object.
|
``None`` if the header is not present.
|
|
.. versionchanged:: 2.3
|
:class:`Authorization` is no longer a ``dict``. The ``token`` attribute
|
was added for auth schemes that use a token instead of parameters.
|
r )r Z from_headerrL rp r0 r2 r2 r3 Ú authorization[ s zRequest.authorizationZOriginzThe host that the request originated from. Set :attr:`~CORSResponseMixin.access_control_allow_origin` on the response to indicate which origins are allowed.z Access-Control-Request-HeaderszÖSent with a preflight request to indicate which headers will be sent with the cross origin request. Set :attr:`~CORSResponseMixin.access_control_allow_headers` on the response to indicate which headers are allowed.)Z load_funcrx ry z Access-Control-Request-MethodzÔSent with a preflight request to indicate which method will be used for the cross origin request. Set :attr:`~CORSResponseMixin.access_control_allow_methods` on the response to indicate which methods are allowed.c C s" | j }|dkp | d¡o | d¡S )zCheck if the mimetype indicates JSON data, either
|
:mimetype:`application/json` or :mimetype:`application/*+json`.
|
zapplication/jsonz application/z+json)r Ú
|
startswithÚendswith)r1 Úmtr2 r2 r3 Úis_json s
|
|
ýzRequest.is_json)@r] Ú
|
__module__Ú __qualname__Ú__doc__Ú__annotations__rS r4 Úsetterr; r? r r@ rA r rB r rC rD rW r_ r rd re rg rk r[ rm rn ro rl rv r r& Ú content_typerz Úcontent_encodingZ content_md5Zreferrerr ÚdateÚintZ max_forwardsr r r r r r
r r r r r r r r r r r Úoriginr Z access_control_request_headersZ access_control_request_methodr r2 r2 r2 r3 r% ( s
|
|
|
C ú ö ö úõ ø
|
ù
|
÷ ø r% )+Ú
|
__future__r ÚtypingÚtr- r Ú urllib.parser Zdatastructuresr r r r r
|
r r r r r r r r r Úhttpr r r r r r r r r r r Úutilsr r r! r" r# r$ r% r2 r2 r2 r3 Ú<module> sF
|
