codekingpro/portable-devtools
114k
1�
2 ��j�� � � � S SK Jr S SKrS SKrS SKrS SKrS SKJ r S SKJr S SKJ3r4 S SKJ r S SKJ r S SK
Jr S S KJr S S5K6Jr S S K7Jr S S KJr S S
KJr SSKJr SSKJr \R2 ( a S SKJr \ " S5 r \R< " S5 r \ " / SQ5 r \ " / SQ5 r!0 SS_SS_SS_S S _S S _S S!_S"S#_S$S%_S&S'_S(S)_S*S+_S,S-_S.S/_S0S1_S2S3_S4S5_S6S7_0 S8S9_S:S;_S<S=_S>S?_S@SA_SBSC_SDSE_SFSG_SHSI_SJSK_SLSM_SNSO_SPSQ_SRSS_STSU_SVSW_SXSY_E0 SZS[_S\S]_S^S__S`Sa_SbSc_SdSe_SfSg_ShSi_SjSk_SlSm_SnSo_SpSq_SrSs_StSu_SvSw_SxSy_SzS{_ES|S}S~SS�S�S�S�S�S�S�S�S�S�.
Er" " S� S�\5 r# " S� S�\5 r$S�S�S� jjr%\R< " S�\RL 5 r'S�S� jr(S�S� jr)S�S� jr*S�S� jr+S�S� jr,S�S� jr-\R< " S�\R\ S�9r/\R< " S�\R\ S�9r0\R< " S�\R\ \Rb - 5 r2\R< " S�\R\ 5 r3S�S� jr4\R< " S�\R\ 5 r5\Rl " S�S�S�9r7\Rp S�S� j5 r9\Rp S�S� j5 r9 S� S�S� jjr9\Rl " S�S�S�9r:\Rp S� S�S� jj5 r;\Rp S� S�S� jj5 r; S� S�S� jjr;\Rl " S�S�S�9r<\Rp S� S�S� jj5 r=\Rp S� S�S� jj5 r= S� S�S� jjr= S� S�S� jjr>S�S� jr? S� S�S� jjr@ S� S�S� jjrAS�S�S� jjrB\Rp S�S� j5 rC\Rp S�S� j5 rC S�S� jrCS�S� jrDS�S� jrES�S� jrF S� S�S� jjrGS�S�S� jjrHS�S�S� jjrI S� S�S� jjrJ S� S�S� jjrKS�S� jrLS�S� jrMS�S� jrN S� S�S� jjrO\R< " S�\RL 5 rP\R< " S�\RL 5 rQS�S�S�.rR\RR� S� / \T" S�5 QS�Q\T" S�S�5 Q 5 5 S� S�S� jjrU S�S� jrVSS�KWJXrY SS�KZJ[r\ g)�� )� annotationsN��date)�datetime)�time)� timedelta)�timezone)�Enum)�sha1)�mktime)� struct_time)�quote)�unquote� )�8_dt_as_utc)�9_plain_int)�WSGIEnvironmentzM!#$%&'*+-.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ^_`abcdefghijklmnopqrstuvwxyz|~z&([Ww]/)?(?:"(.*?)"|(.*?))(?:\s*,\s*|$))10�allowzcontent-encodingzcontent-languagezcontent-length�content-locationz content-md5z
content-rangez content-type�expiresz
last-modified)�11connectionz12keep-alivezproxy-authenticatezproxy-authorization�te�trailerztransfer-encoding�upgrade�d �Continue�e zSwitching Protocols�f �13Processing�g z Early Hints�� �OK�� �Created�� �Accepted�� z Non Authoritative Information�� z14No Content�� z
Reset Content�� zPartial Content�� z Multi Status�� zAlready Reported�� zIM Usedi, zMultiple Choicesi- zMoved Permanentlyi. �Foundi/ z See Otheri0 z Not Modifiedi1 z Use Proxyi2 z Switch Proxyi3 zTemporary Redirecti4 zPermanent Redirecti� z Bad Requesti� � Unauthorizedi� zPayment Requiredi� � Forbiddeni� z Not Foundi� zMethod Not Allowedi� zNot Acceptablei� z Proxy Authentication Requiredi� zRequest Timeouti� �Conflicti� �Gonei� zLength Requiredi� zPrecondition Failedi� zRequest Entity Too Largei� zRequest URI Too Longi� zUnsupported Media Typei� z Requested Range Not Satisfiablei� zExpectation Failedi� z I'm a teapoti� zMisdirected Requesti� zUnprocessable Entityi� �Lockedi� zFailed Dependencyi� z Too Earlyi� zUpgrade Requiredi� zPrecondition Requiredi� zToo Many Requestsi� z Request Header Fields Too Largez15Retry Withz Unavailable For Legal ReasonszInternal Server ErrorzNot Implementedz Bad GatewayzService UnavailablezGateway TimeoutzHTTP Version Not SupportedzVariant Also NegotiateszInsufficient Storagez
Loop Detectedz Not Extendedz Network Authentication Failed)
i� i� i� i� i� i� i� i� i� i� i� i� i� c � � \ rS rSrSrSrSrSrg)�COEP�{ z Cross Origin Embedder Policies� unsafe-nonez require-corp� N)�__name__�16__module__� __qualname__�__firstlineno__�__doc__� UNSAFE_NONE� REQUIRE_CORP�__static_attributes__r8 � �SD:\code\apps\devtools\python\user_packages\Python313\site-packages\werkzeug/http.pyr5 r5 { s � �(� �K�!�LrA r5 c �$ � \ rS rSrSrSrSrSrSrg)�COOP� z Cross Origin Opener Policiesr7 zsame-origin-allow-popupsz same-originr8 N) r9 r: r; r< r= r> �SAME_ORIGIN_ALLOW_POPUPS� SAME_ORIGINr@ r8 rA rB rD rD � s � �&� �K� 9� � �KrA rD c �� � [ U 5 nU( d gU( a [ nUR U5 ( a U$ UR SS5 R SS5 nSU S3$ )a� Add double quotes around a header value. If the header contains only ASCII token17characters, it will be returned unchanged. If the header contains ``"`` or ``\``18characters, they will be escaped with an additional ``\`` character.19 20This is the reverse of :func:`unquote_header_value`.21 22:param value: The value to quote. Will be converted to a string.23:param allow_token: Disable to quote the value even if it only has token characters.24 25.. versionchanged:: 3.026 Passing bytes is not supported.27 28.. versionchanged:: 3.029 The ``extra_chars`` parameter is removed.30 31.. versionchanged:: 2.332 The value is quoted if it is the empty string.33 34.. versionadded:: 0.535z""�\�\\�"�\")�str� _token_chars�36issuperset�replace)�value� allow_token� value_str� token_charss rB �quote_header_valuerU � s` � �* �E�37�I� ���"� � � !� !�)� ,� ,� � ��!�!�$��/�7�7��U�C�I�
�y�k�� �rA z\\(.)c � � [ U 5 S:� a0 U S U S s=:X a S:X a O U $ [ R SU SS 5 $ U $ )a, Remove double quotes and backslash escapes from a header value.38 39This is the reverse of :func:`quote_header_value`.40 41:param value: The header value to unquote.42 43.. versionchanged:: 3.244 Removes escape preceding any character.45 46.. versionchanged:: 3.047 The ``is_filename`` parameter is removed.48� r �����rK z\g<1>r )�len� _unslash_re�sub�rQ s rB �unquote_header_valuer] � sH � � �5�z�Q��5��8�u�R�y�7�C�7� �L� ���x��q���5�5� �LrA c � � / nU b UR U 5 UR 5 HJ u p4Uc M49 US S:X a UR U SU 35 M+ UR U S[ U5 35 ML SR U5 $ )a� Produce a header value and ``key=value`` parameters separated by semicolons50``;``. For example, the ``Content-Type`` header.51 52.. code-block:: python53 54 dump_options_header("text/html", {"charset": "UTF-8"})55 'text/html; charset=UTF-8'56 57This is the reverse of :func:`parse_options_header`.58 59If a value contains non-token characters, it will be quoted.60 61If a value is ``None``, the parameter is skipped.62 63In some keys for some headers, a UTF-8 value can be encoded using a special64``key*=UTF-8''value`` form, where ``value`` is percent encoded. This function will65not produce that format automatically, but if a given key ends with an asterisk66``*``, the value is assumed to have that form and will not be quoted further.67 68:param header: The primary header value.69:param options: Parameters to encode as ``key=value`` pairs.70 71.. versionchanged:: 2.372 Keys with ``None`` values are skipped rather than treated as a bare key.73 74.. versionchanged:: 2.2.375 If a key ends with ``*``, its value will not be quoted.76rX �*�=�; )�append�itemsrU �join)�header�options�segments�keyrQ s rB �dump_options_headerri � s� � �: �H�
������ � �m�m�o�77�� �=� � �r�7�c�>� �O�O�s�e�1�U�G� ,� -� �O�O�s�e�1�%7��%>�$?� @� A� &� �9�9�X� � rA c �r � [ U [ 5 ( ar / nU R 5 H[ u p#Uc UR U5 M US S:X a UR U SU 35 M< UR U S[ U5 35 M] OU Vs/ s H n[ U5 PM nnSR U5 $ s snf )a� Produce a header value from a list of items or ``key=value`` pairs, separated by78commas ``,``.79 80This is the reverse of :func:`parse_list_header`, :func:`parse_dict_header`, and81:func:`parse_set_header`.82 83If a value contains non-token characters, it will be quoted.84 85If a value is ``None``, the key is output alone.86 87In some keys for some headers, a UTF-8 value can be encoded using a special88``key*=UTF-8''value`` form, where ``value`` is percent encoded. This function will89not produce that format automatically, but if a given key ends with an asterisk90``*``, the value is assumed to have that form and will not be quoted further.91 92.. code-block:: python93 94 dump_header(["foo", "bar baz"])95 'foo, "bar baz"'96 97 dump_header({"foo": "bar baz"})98 'foo="bar baz"'99 100:param iterable: The items to create a header from.101 102.. versionchanged:: 3.0103 The ``allow_token`` parameter is removed.104 105.. versionchanged:: 2.2.3106 If a key ends with ``*``, its value will not be quoted.107rX r_ r` z, )�108isinstance�dictrc rb rU rd )�iterablerc rh rQ �xs rB � dump_headerro � s� � �@ �(�D�!�!���"�.�.�*�J�C��}�� � �S�!��R��C� �� � ��u�A�e�W� -�.�� � ��u�A�&8��&?�%@� A�B�
+� 19�9��1�#�A�&���9� �9�9�U� ��� :s � B4�ds.ContentSecurityPolicyc �N � SR S U R 5 5 5 $ )z�Dump a Content Security Policy header.109 110These are structured into policies such as "default-src 'self';111script-src 'self'".112 113.. versionadded:: 1.0.0114 Support for Content Security Policy headers was added.115 116ra c 3 �4 # � U H u pU S U 3v � M g7f)� Nr8 )�.0rh rQ s rB � <genexpr>�"dump_csp_header.<locals>.<genexpr>, s � � �G��*�#��u�A�e�W�%��s �)rd rc �re s rB �dump_csp_headerrx " s � � �9�9�G�� � ��G� G�GrA c �` � / nSnSnSnU HW nU( a SnX%-
nM U( a US:X a SnOUS:X a SnX%-
nM0 US:X a UR U5 SnMK US:X a SnX%-
nMY U( a / $ UR U5 S U 5 Vs/ s H o"( d M [ U5 PM sn$ s snf )a� Parse a header value that consists of a list of comma separated items according117to `RFC 9110 <https://httpwg.org/specs/rfc9110.html#abnf.extension>`__.118 119Surrounding quotes are removed from items, but internal quotes are left for120future parsing. Empty values are discarded.121 122.. code-block:: python123 124 parse_list_header('token, "quoted value"')125 ['token', 'quoted value']126 127This is the reverse of :func:`dump_header`.128 129:param value: The header value to parse.130 131.. versionchanged:: 3.2132 Quotes and escapes are kept if only part of an item is quoted. Empty133 values are omitted. An empty list is returned if the value contains an134 unclosed quoted string.135� FrI TrK �,c 3 �@ # � U H oR 5 v � M g 7f�N)�strip)rt �items rB ru �$parse_list_header.<locals>.<genexpr>h s � � �/O���136�137� � ��s � )rb r] )rQ rc r �escaper �chars rB �parse_list_headerr� / s� � �*
�E�
�D�
�F� �E��� ��F� �L�D� � ��t�|� ����� �� �L�D� � �3�;� �L�L�� ��D� � �3�;��E� � ��/ �2
�� � �L�L���/O��/O� �/O�t�SW�"� �T�"�/O� � �� s � 138B+�B+c � � 0 n[ U 5 H� nUR S5 u p4n UR 5 nU( d M0 U( d SX' M= U R 5 n SnUS S:X aR USS n[ R U 5 nU( a" UR 5 u pPUR
5 nUS; a [ XS9n [ U 5 X' M� U$ )a� Parse a list header using :func:`parse_list_header`, then parse each item as a139``key=value`` pair.140 141.. code-block:: python142 143 parse_dict_header('a=b, c="d, e", f')144 {"a": "b", "c": "d, e", "f": None}145 146This is the reverse of :func:`dump_header`.147 148If a key does not have a value, it is ``None``.149 150This handles charsets for values as described in151`RFC 2231 <https://www.rfc-editor.org/rfc/rfc2231#section-3>`__. Only ASCII, UTF-8,152and ISO-8859-1 charsets are accepted, otherwise the value remains quoted.153 154:param value: The header value to parse.155 156.. versionchanged:: 3.2157 An empty dict is returned if the value contains an unclosed quoted158 string.159 160.. versionchanged:: 3.0161 Passing bytes is not supported.162 163.. versionchanged:: 3.0164 The ``cls`` argument is removed.165 166.. versionchanged:: 2.3167 Added support for ``key*=charset''value`` encoded items.168 169.. versionchanged:: 0.9170 The ``cls`` argument was added.171r` NrX r_ > �ascii�utf-8�us-ascii�172iso-8859-1��encoding) r� � partitionr~ �_charset_value_re�match�groups�lowerr r] )rQ �resultr rh � has_valuer� r� s rB �parse_dict_headerr� l s� � �F %'�F�!�%�(�� $���s� 3� ����i�i�k��� �� �F�K� �� � �
�� #�� �r�7�c�>� �c�r�(�C�%�+�+�E�2�E��"'�,�,�.���#�>�>�+��173 �G�G� ��9��*�5�1�� �C )�F �MrA z([\w!#$%&'*+\-.^`|~]+)=)�flagsz[\w!#$%&'*+\-.^`|~]+z�174 ([\w!#$%&*+\-.^`|~]*)' # charset part, could be empty175 [\w!#$%&*+\-.^`|~]*' # don't care about language part, usually empty176 ([\w!#$%&'*+\-.^`|~]+) # one or more token chars with percent encoding177 z\*(\d+)$c �� � U c S0 4$ U R S5 u pnU R 5 n UR 5 nU ( a U( d U 0 4$ / n [ R U5 =nb� UR S5 R 5 nX$R
5 S n[ R U5 =nb! UR XTR 5 45 O`USS S:X aW Sn[ U5 nXg: aE X&US- S; a US-
nO-X& S:X a UR XRSUS- 45 X&S- S nO US-
nXg: a ME UR S5 =nS:X a OX(S- S R 5 nGM 0 n Sn178Sn U GH u p\US S :X a] USS n[ R U 5 n
U
( a" U
R 5 u p�U179R 5 n180U181( d U n182U183S184; a U185n [ X�S 9n U S U S s=:X a S:X a8 O O5U SS R S
S5 R SS5 R SS5 n [ R# U5 n
U
( a- USU
R% 5 nU R' US5 U - X�' GM X�U' GM X 4$ )a Parse a header that consists of a value with ``key=value`` parameters separated186by semicolons ``;``. For example, the ``Content-Type`` header.187 188.. code-block:: python189 190 parse_options_header("text/html; charset=UTF-8")191 ('text/html', {'charset': 'UTF-8'})192 193 parse_options_header("")194 ("", {})195 196This is the reverse of :func:`dump_options_header`.197 198This parses valid parameter parts as described in199`RFC 9110 <https://httpwg.org/specs/rfc9110.html#parameter>`__. Invalid parts are200skipped.201 202This handles continuations and charsets as described in203`RFC 2231 <https://www.rfc-editor.org/rfc/rfc2231#section-3>`__, although not as204strictly as the RFC. Only ASCII, UTF-8, and ISO-8859-1 charsets are accepted,205otherwise the value remains quoted.206 207Clients may not be consistent in how they handle a quote character within a quoted208value. The `HTML Standard <https://html.spec.whatwg.org/#multipart-form-data>`__209replaces it with ``%22`` in multipart form data.210`RFC 9110 <https://httpwg.org/specs/rfc9110.html#quoted.strings>`__ uses backslash211escapes in HTTP headers. Both are decoded to the ``"`` character.212 213Clients may not be consistent in how they handle non-ASCII characters. HTML214documents must declare ``<meta charset=UTF-8>``, otherwise browsers may replace with215HTML character references, which can be decoded using :func:`html.unescape`.216 217:param value: The header value to parse.218:return: ``(value, options)``, where ``options`` is a dict219 220.. versionchanged:: 2.3221 Invalid parts, such as keys with no value, quoted keys, and incorrectly quoted222 values, are discarded instead of treating as ``None``.223 224.. versionchanged:: 2.3225 Only ASCII, UTF-8, and ISO-8859-1 are accepted for charset values.226 227.. versionchanged:: 2.3228 Escaped quotes in quoted values, like ``%22`` and ``\"``, are handled.229 230.. versionchanged:: 2.2231 Option names are always converted to lowercase.232 233.. versionchanged:: 2.2234 The ``multiple`` parameter was removed.235 236.. versionchanged:: 0.15237 :rfc:`2231` parameter continuations are handled.238 239.. versionadded:: 0.5240Nrz �;r rK rW > rL rJ rX r_ > r� r� r� r� r� r rJ rI rL z%22)r� r~ �_parameter_key_rer� �groupr� �end�_parameter_token_value_rerb rY �find�lstripr� r� r rP �_continuation_re�search�start�get)rQ �_�rest�parts�m�pk�pos�lengthr� rf r� �continued_encoding�pvr� s rB �parse_options_headerr� � s� � �r
�}��2�v�
��_�_�S�)�N�E�d� �K�K�M�E� �:�:�<�D� ���b�y�� $&�E�241�"�(�(��.� .�A� ;������!�!�#�B����� �?�D� /�4�4�T�:�:��G�� � �b�'�'�)�_�-� �b�q��S� ��� �T����l��#��'�*�o�=��q��� ��c�)� � � �b�y��q��/�%:�;� #�!�G�I��� � �q��� �l� �9�9�S�>� !�C�b� (� ��!�G�I��%�%�'��? �B !�G� �H�%)�� ���
�b�6�S�=��C�R��B�%�+�+�B�/�E�� $�|�|�~� ��#�>�>�+�� �-��242 �G�G�243 &.�"� �R�3�� �a�5�B�r�F� !�c� !��A�b��!�!�&�$�/�7�7��s�C�K�K�E�SV�W�B� �'�'��+�� ��O�e�k�k�m�$�B�!�+�+�b�"�-��2�G�K� �B�K�Q �T �>�rA z
-?\d+(\.\d+)?� _TAnyAccept� ds.Accept)�boundc � � g r} r8 r\ s rB �parse_accept_headerr� f s � �9<rA c � � g r} r8 )rQ �clss rB r� r� j s � �SVrA c �� � Uc0 [ R " [ [ [ R244 5 nU ( d U" S5 $ / n[
U 5 H� n[ U5 u p4SU; aQ UR S5 R 5 n[ R U5 c MM [ U5 nUS: d US:� a Mf OSnU( a [ X45 nUR X645 M� U" U5 $ )aC Parse an ``Accept`` header according to245`RFC 9110 <https://httpwg.org/specs/rfc9110.html#field.accept>`__.246 247Returns an :class:`.Accept` instance, which can sort and inspect items based on248their quality parameter. When parsing ``Accept-Charset``, ``Accept-Encoding``, or249``Accept-Language``, pass the appropriate :class:`.Accept` subclass.250 251:param value: The header value to parse.252:param cls: The :class:`.Accept` class to wrap the result in.253:return: An instance of ``cls``.254 255.. versionchanged:: 2.3256 Parse according to RFC 9110. Items with invalid ``q`` values are skipped.257N�qr r )�t�cast�typer� �ds�Acceptr� r� �popr~ � _q_value_re� fullmatch�floatri rb )rQ r� r� r rf �q_strr� s rB r� r� n s� � �" �{��f�f�T�+�&�� � �2�� ��4�y��
�F�!�%�(��,�T�2�
�� �'�>��K�K��$�*�*�,�E��$�$�U�+�3���e� �A��1�u��A��� � �A� �&�t�5�D��
�
�t�i� �/ )�2 �v�;�rA �_TAnyCCz ds.cache_control._CacheControlc � � g r} r8 �rQ � on_updates rB �parse_cache_control_headerr� � s � � !rA c � � g r} r8 �rQ r� r� s rB r� r� � s � �258 rA c � � Uc% [ R " S[ R 5 nU ( d U" SU5 $ U" [ U 5 U5 $ )a� Parse a cache control header. The RFC differs between response and259request cache control, this method does not. It's your responsibility260to not use the wrong control statements.261 262.. versionadded:: 0.5263 The `cls` was added. If not specified an immutable264 :class:`~werkzeug.datastructures.RequestCacheControl` is returned.265 266:param value: a cache control header to be parsed.267:param on_update: an optional callable that is called every time a value268 on the :class:`~werkzeug.datastructures.CacheControl`269 object is changed.270:param cls: the class for the returned object. By default271 :class:`~werkzeug.datastructures.RequestCacheControl` is used.272:return: a `cls` object.273�
type[_TAnyCC]r8 )r� r� r� �RequestCacheControlr� r� s rB r� r� � sB � �* �{��f�f�_�b�&<�&<�=�� ��2�y�!�!� � ��'�� 3�3rA �_TAnyCSPc � � g r} r8 r� s rB �parse_csp_headerr� � s � � #rA c � � g r} r8 r� s rB r� r� � s � �274 rA c � � Uc% [ R " S[ R 5 nU c U" SU5 $ / nU R S5 Hl nUR 5 nSU; d M UR 5 R SS5 u pPUR
UR 5 U R 5 45 Mn U" X15 $ )a� Parse a Content Security Policy header.275 276.. versionadded:: 1.0.0277 Support for Content Security Policy headers was added.278 279:param value: a csp header to be parsed.280:param on_update: an optional callable that is called every time a value281 on the object is changed.282:param cls: the class for the returned object. By default283 :class:`~werkzeug.datastructures.ContentSecurityPolicy` is used.284:return: a `cls` object.285�type[_TAnyCSP]r8 r� rs r )r� r� r� �ContentSecurityPolicy�splitr~ rb )rQ r� r� rc �policy� directives rB r� r� � s� � �" �{��f�f�%�r�'?�'?�@�� �}��2�y�!�!� �E��+�+�c�"��� � � �� �&�=� %�|�|�~� 3� 3�C�� ;� �I� �L�L�)�/�/�+�U�[�[�]�;� <�
#� �u� � rA c �~ � U ( d [ R " SU5 $ [ R " [ U 5 U5 $ )a� Parse a set-like header and return a286:class:`~werkzeug.datastructures.HeaderSet` object:287 288>>> hs = parse_set_header('token, "quoted value"')289 290The return value is an object that treats the items case-insensitively291and keeps the order of the items:292 293>>> 'TOKEN' in hs294True295>>> hs.index('quoted value')2961297>>> hs298HeaderSet(['token', 'quoted value'])299 300To create a header from the :class:`HeaderSet` again, use the301:func:`dump_header` function.302 303:param value: a set header to be parsed.304:param on_update: an optional callable that is called every time a305 value on the :class:`~werkzeug.datastructures.HeaderSet`306 object is changed.307:return: a :class:`~werkzeug.datastructures.HeaderSet`308N)r� � HeaderSetr� r� s rB �parse_set_headerr� s/ � �8 ��|�|�D�)�,�,�
�<�<�)�%�0�)� <�<rA c �� � U ( d [ R " 5 $ [ U 5 nUb [ R " US9$ [ R " [ U 5 S 5 $ )z�Parses an if-range header which can be an etag or a date. Returns309a :class:`~werkzeug.datastructures.IfRange` object.310 311.. versionchanged:: 2.0312 If the value represents a datetime, it is timezone-aware.313 314.. versionadded:: 0.7315r r )r� �IfRange�316parse_date� unquote_etag)rQ r s rB �parse_if_range_headerr� * sK � � ��z�z�|�� �e� �D� ���z�z�t�$�$�
�:�:�l�5�)�!�,� -�-rA c �� � U ( a SU ; a g/ nSnU R SS5 u pEUR 5 R 5 nUR S5 H� nUR 5 nSU; a gUR S5 ( a US: a g [ U5 nSnSnOzSU; at UR SS5 u p�U R 5 n U317R 5 n318 [ U 5 nXs: d US: a gU319( a [ U3205 S- nXx:� a gOSnUb UOSnUR
WW45 M� [ R " XB5 $ ! [321 a gf = f! [322 a gf = f! [323 a gf = f)z�Parses a range header into a :class:`~werkzeug.datastructures.Range`324object. If the header is missing or malformed `None` is returned.325`ranges` is a list of ``(start, stop)`` tuples where the ranges are326non-inclusive.327 328.. versionadded:: 0.7329r` Nr r r{ �-rX ) r� r~ r� �330startswithr �331ValueErrorrb r� �Range) rQ �make_inclusive�ranges�last_end�units�rngr �beginr� � begin_str�end_strs rB �parse_range_headerr� < s� � � �C�u�$��
�F��H����S�!�$�J�E� �K�K�M� � � !�E�� � �#����z�z�|�� �d�?�� �?�?�3� � ��!�|��
�"�4�(�� �C��H�
�D�[�!%���C��!3� �I�!���)�I� �m�m�o�G�
�"�9�-�� � �8�a�<��� �$�W�-��1�C� �<� � � �� !�o�s�2�H��
�
�u�c�l�#�I �L �8�8�E� "�"��; �
��
�� �
��
�� "� � � �s6 � E� E�;E)�332E�E�333E&�%E&�)334E7�6E7c �< � U c g U =( d SR 5 R SS5 u p#SU; a gUR SS5 u pEUS:X a SnO [ U5 nUS:X a* [ SSU5 ( d g[335 R " USSXaS9$ SU; a gUR SS5 u px [ U5 n [ U5 S- n336[ X�U5 ( a [337 R " X)X�US9$ g! [ a gf = f! [ a gf = f! [ a gf = f)az Parses a range header into a338:class:`~werkzeug.datastructures.ContentRange` object or `None` if339parsing is not possible.340 341.. versionadded:: 0.7342 343:param value: a content range header to be parsed.344:param on_update: an optional callable that is called every time a value345 on the :class:`~werkzeug.datastructures.ContentRange`346 object is changed.347Nrz r �/r_ )r� r� )r~ r� r� r �is_byte_range_validr� � ContentRange) rQ r� r� �rangedefr� �348length_strr� � start_str�stop_strr� �stops rB �parse_content_range_headerr� w s8 � �
�}��� �;�B�-�-�/�5�5�d�A�>��� �(��� �n�n�S�!�,�O�C��S���� � �349�+�F� �c�z�"�4��v�6�6�����u�d�D�&�N�N� �C� �� �)�)�C��+��I���9�%���(�#�a�'�� �5��/�/����u�T�Y�O�O� ��A � ���� � �� �� � ���s5 �+C. � C> �-D �.350C;�:C;�>351D �352D �353D�Dc �L � SU ; a [ S5 eSU S3n U( a SU 3n U $ )z]Quote an etag.354 355:param etag: the etag to quote.356:param weak: set to `True` to tag it "weak".357rK z invalid etag�W/)r� ��etag�weaks rB �358quote_etagr� � s6 � � �d�{�� �(�(�
�t�f�A�;�D� ��D�6�{�� �KrA c � � g r} r8 �r� s rB r� r� � s � �14rA c � � g r} r8 r� s rB r� r� � s � �36rA c � � U ( d gU R 5 n SnU R S5 ( a SnU SS n U SS U SS s=:X a S :X a359 O X4$ U SS n X4$ )360z�Unquote a single etag:361 362>>> unquote_etag('W/"bar"')363('bar', True)364>>> unquote_etag('"bar"')365('bar', False)366 367:param etag: the etag identifier to unquote.368:return: a ``(etag, weak)`` tuple.369�NNF)r� zw/TrW Nr rX rK )r~ r� r� s rB r� r� � so � � �� �:�:�<�D� �D� ���|�$�$����A�B�x�� �B�Q�x�4���9�#��#� �:�� �A�b�z�� �:�rA c � � U ( d [ R " 5 $ / n/ n[ U 5 nSnXC: a� [ R X5 nUc OwUR 5 u pgnUS:X a [ R " SS9$ U( a UnU( a UR
U5 OUR
U5 UR 5 nXC: a M� [ R " X5 $ )zyParse an etag header.370 371:param value: the tag header to parse372:return: an :class:`~werkzeug.datastructures.ETags` object.373r r_ T)�star_tag)r� �ETagsrY �_etag_rer� r� rb r� ) rQ �strongr� r� r� r� �is_weak�quoted�raws rB � parse_etagsr � s� � � ��x�x�z��
�F�
�D�374
�e�*�C�375 �C�376
�)����u�*�� �=� � $�|�|�~� ��� �#�:��8�8�T�*� *�
��C� � �K�K�� � �M�M�#� ��i�i�k�� �)� �8�8�F� !�!rA c �4 � [ U 5 R 5 $ )zwGenerate an etag for some data.377 378.. versionchanged:: 2.0379 Use SHA-1. MD5 may not be available in some environments.380)r � hexdigest)�datas rB �
generate_etagr � s � � ��:� � � !�!rA c �� � U c g [ R R U 5 nUR381 c UR
[ R S9$ U$ ! [ [ 4 a gf = f)a# Parse an :rfc:`2822` date into a timezone-aware382:class:`datetime.datetime` object, or ``None`` if parsing fails.383 384This is a wrapper for :func:`email.utils.parsedate_to_datetime`. It385returns ``None`` if parsing fails instead of raising an exception,386and always returns a timezone-aware datetime object. If the string387doesn't have timezone information, it is assumed to be UTC.388 389:param value: A string with a supported date format.390 391.. versionchanged:: 2.0392 Return a timezone-aware datetime object. Use393 ``email.utils.parsedate_to_datetime``.394N��tzinfo) �email�utils�parsedate_to_datetime� TypeErrorr� r rP r �utc)rQ �dts rB r� r� � sd � �
�}���
�[�[�
.�
.�u�
5�� 395�y�y���z�z�� � �z�.�.�
�I��
�z� "� ���s � A �A$�#A$c �~ � [ U [ 5 ( ak [ U [ 5 ( d- [ R " U [ 5 [396 R S9n O [ U 5 n [ R R U SS9$ [ U [ 5 ( a [ U 5 n [ R R U SS9$ )a� Format a datetime object or timestamp into an :rfc:`2822` date397string.398 399This is a wrapper for :func:`email.utils.format_datetime`. It400assumes naive datetime objects are in UTC instead of raising an401exception.402 403:param timestamp: The datetime or timestamp to format. Defaults to404 the current time.405 406.. versionchanged:: 2.0407 Use ``email.utils.format_datetime``. Accept ``date`` objects.408r409 T)�usegmt)rk r r �combiner r r r r r
�format_datetimer
r �410formatdate)� timestamps rB � http_dater s� � � �)�T�"�"��)�X�.�.� �(�(��D�F�8�<�<�P�I� #�9�-�I��{�{�*�*�9�T�*�B�B��)�[�)�)��9�%� � �;�;� !� !�)�D� !� 9�9rA c � � U ( d g [ U 5 nUS: a g [ US9$ ! [ a gf = f! [ a gf = f)z�Parses a base-10 integer count of seconds into a timedelta.411 412If parsing fails, the return value is `None`.413 414:param value: a string consisting of an integer represented in base-10415:return: a :class:`datetime.timedelta` object or `None`.416Nr )�seconds)�intr� r �
OverflowError)rQ r s rB � parse_ager ; s[ � � ����e�*�� ��{�����)�)�� � ���� � ���s � & �6 �4173�3�418A�Ac � � U c g[ U [ 5 ( a [ U R 5 5 n O [ U 5 n U S: a [ S5 e[ U 5 $ )z�Formats the duration as a base-10 integer.419 420:param age: should be an integer number of seconds,421 a :class:`datetime.timedelta` object, or,422 if the age is unknown, `None` (default).423Nr zage cannot be negative)rk r r �
total_secondsr� rM )�ages rB �dump_ager! Q sQ � � �{���#�y�!�!��#�#�#�%�&���#�h��424�Q�w��1�2�2� �s�8�OrA c �� � [ R " U R S5 U R S5 U R S5 U R S5 U R S5 UUUUS9 $ )a� Convenience method for conditional requests.425 426:param environ: the WSGI environment of the request to be checked.427:param etag: the etag for the response for comparison.428:param data: or alternatively the data of the response to automatically429 generate an etag using :func:`generate_etag`.430:param last_modified: an optional date of the last modification.431:param ignore_if_range: If `False`, `If-Range` header will be taken into432 account.433:return: `True` if the resource was modified, otherwise `False`.434 435.. versionchanged:: 2.0436 SHA-1 is used to generate an etag value for the data. MD5 may437 not be available in some environments.438 439.. versionchanged:: 1.0.0440 The check is run for methods other than ``GET`` and ``HEAD``.441�442HTTP_RANGE�
HTTP_IF_RANGE�HTTP_IF_MODIFIED_SINCE�HTTP_IF_NONE_MATCH�
HTTP_IF_MATCH) �443http_range�
http_if_range�http_if_modified_since�http_if_none_match�
http_if_matchr� r �
last_modified�ignore_if_range)� _sansio_http�is_resource_modifiedr� )�environr� r r- r. s rB r0 r0 e sa � �2 � ,� ,��;�;�|�,� �k�k�/�2� &�{�{�+C� D�"�;�;�';�<� �k�k�/�2�
�
�#�'�444 � 445rA c �� � U Vs1 s H o"R 5 iM nnU VVs/ s H. u p4[ U5 ( a UR 5 U; d M+ X44PM0 snnU SS& gs snf s snnf )a� Remove all entity headers from a list or :class:`Headers` object. This446operation works in-place. `Expires` and `Content-Location` headers are447by default not removed. The reason for this is :rfc:`2616` section44810.3.5 which specifies some entity headers that should be sent.449 450.. versionchanged:: 0.5451 added `allowed` parameter.452 453:param headers: a list or :class:`Headers` object.454:param allowed: a list of headers that should still be allowed even though455 they are entity headers.456N)r� �is_entity_header)�headers�allowedrn rh rQ s rB �remove_entity_headersr6 � sg � � #*�*�'�Q�w�w�y�'�G�*� "��!�J�C� ��$�$�� � � �w�(>� �� �!��G�A�J�� +��s �A"�*A'�A'c �j � U VVs/ s H u p[ U5 ( a M X4PM snnU SS& gs snnf )z�Remove all HTTP/1.1 "Hop-by-Hop" headers from a list or457:class:`Headers` object. This operation works in-place.458 459.. versionadded:: 0.5460 461:param headers: a list or :class:`Headers` object.462N)�is_hop_by_hop_header)r4 rh rQ s rB �remove_hop_by_hop_headersr9 � s4 � � (/��'.���6J�3�6O� �� �w��G�A�J�� s �/�/c �0 � U R 5 [ ; $ )z�Check if a header is an entity header.463 464.. versionadded:: 0.5465 466:param header: the header to test.467:return: `True` if it's an entity header, `False` otherwise.468)r� �_entity_headersrw s rB r3 r3 � s � � �<�<�>�_� ,�,rA c �0 � U R 5 [ ; $ )z�Check if a header is an HTTP/1.1 "Hop-by-Hop" header.469 470.. versionadded:: 0.5471 472:param header: the header to test.473:return: `True` if it's an HTTP/1.1 "Hop-by-Hop" header, `False` otherwise.474)r� �_hop_by_hop_headersrw s rB r8 r8 � s � � �<�<�>� 0� 0�0rA c �� � [ U [ 5 ( a U R S5 nOU nU( a UR S5 R 5 n[475 R " X!S9$ )a Parse a cookie from a string or WSGI environ.476 477The same key can be provided multiple times, the values are stored478in-order. The default :class:`MultiDict` will have the first value479first, and all values can be retrieved with480:meth:`MultiDict.getlist`.481 482:param header: The cookie header as a string, or a WSGI environ dict483 with a ``HTTP_COOKIE`` key.484:param cls: A dict-like class to store the parsed cookies in.485 Defaults to :class:`MultiDict`.486 487.. versionchanged:: 3.0488 Passing bytes, and the ``charset`` and ``errors`` parameters, were removed.489 490.. versionchanged:: 1.0491 Returns a :class:`MultiDict` instead of a ``TypeConversionDict``.492 493.. versionchanged:: 0.5494 Returns a :class:`TypeConversionDict` instead of a regular dict. The ``cls``495 parameter was added.496� HTTP_COOKIE�latin1)�cookier� )rk rl r� �encode�decoder/ � parse_cookie)re r� rA s rB rD rD � sO � �4 �&�$� � ����M�*����
�� � �x�(�/�/�1�� � $� $�F� <�<rA z#[\w!#$%&'()*+\-./:<=>?@\[\]^`{|}~]*s [\x00-\x19\",;\\\x7f-\xff]s \"s \\)� "� \c # �P # � U H nUR S S5 SU- 4v � M g7f)r �bigs \%03oN)�to_bytes)rt �vs rB ru ru � s+ � � � �
6�� �Z�Z��5��9�q�=�)�
6�s �$&� s ,;� � c
� � Ub497 [ USS9nU( aA UR S5 S R S5 R S5 R S5 n[ U[ 5 ( a [ UR 5 5 nUb! [ U[ 5 ( d [ U5 nOFUbC U( a< [ [ R " [ R S9R 5 U- 5 nU498b! U499R! 5 n500U501S ; a [# S5025 eU ( a S n[$ R' U5 ( d: [( R+ S UR 5 5 R S5 nS
U S
3nU R 5 R S5 SU 3/n SU4SU4SU4SU4SU4SU4SU5034SU 44 H= u p�Ub USL a M US L a U R- U
5 M' U R- U
SU 35 M? SR/ U 5 n[1 U5 nU ( a9 UU :� a3 [1 U5 n[2 R4 " SU SU S UU-504 S U S U S 3 S S!9 U$ )"ar505 Create a Set-Cookie header without the ``Set-Cookie`` prefix.506 507The return value is usually restricted to ascii as the vast majority508of values are properly escaped, but that is no guarantee. It's509tunneled through latin1 as required by :pep:`3333`.510 511The return value is not ASCII safe if the key contains unicode512characters. This is technically against the specification but513happens in the wild. It's strongly recommended to not use514non-ASCII values for the keys.515 516:param max_age: should be a number of seconds, or `None` (default) if517 the cookie should last only as long as the client's518 browser session. Additionally `timedelta` objects519 are accepted, too.520:param expires: should be a `datetime` object or unix timestamp.521:param path: limits the cookie to a given path, per default it will522 span the whole domain.523:param domain: Use this if you want to set a cross-domain cookie. For524 example, ``domain="example.com"`` will set a cookie525 that is readable by the domain ``www.example.com``,526 ``foo.example.com`` etc. Otherwise, a cookie will only527 be readable by the domain that set it.528:param secure: The cookie will only be available via HTTPS529:param httponly: disallow JavaScript to access the cookie. This is an530 extension to the cookie standard and probably not531 supported by all browsers.532:param charset: the encoding for string values.533:param sync_expires: automatically set expires if max_age is defined534 but expires not.535:param max_size: Warn if the final header value exceeds this size. The536 default, 4093, should be safely `supported by most browsers537 <cookie_>`_. Set to 0 to disable this check.538:param samesite: Limits the scope of the cookie such that it will539 only be attached to requests if those requests are same-site.540:param partitioned: Opts the cookie into partitioned storage. This541 will also set secure to True542 543.. _`cookie`: http://browsercookielimits.squawky.net/544 545.. versionchanged:: 3.1546 The ``partitioned`` parameter was added.547 548.. versionchanged:: 3.0549 Passing bytes, and the ``charset`` parameter, were removed.550 551.. versionchanged:: 2.3.3552 The ``path`` parameter is ``/`` by default.553 554.. versionchanged:: 2.3.1555 The value allows more characters without quoting.556 557.. versionchanged:: 2.3558 ``localhost`` and other names without a dot are allowed for the domain. A559 leading dot is ignored.560 561.. versionchanged:: 2.3562 The ``path`` parameter is ``None`` by default.563 564.. versionchanged:: 1.0.0565 The string ``'None'`` is accepted for ``samesite``.566z%!$&'()*+,/:=@)�safe�:r �.�idnar� )�tz> �Lax�None�Strictz,SameSite must be 'Strict', 'Lax', or 'None'.Tc �0 � [ U R 5 $ r} )�_cookie_slash_mapr� )r� s rB �<lambda>� dump_cookie.<locals>.<lambda>` s � �'���� �2rA rK r@ r` �Domain�ExpireszMax-Age�Secure�HttpOnly�Path�SameSite� PartitionedFra zThe 'z%' cookie is too large: the value was z bytes but the header required z! extra bytes. The final size was z bytes but the limit is z> bytes. Browsers may silently ignore cookies larger than this.rW )�567stacklevel)r r� r� rB rC rk r r r rM r r �nowr r r �titler� �_cookie_no_quote_rer� �_cookie_slash_rer[ rb rd rY �warnings�warn)rh rQ �max_ager �path�domain�secure�httponly� sync_expires�max_size�samesite� partitioned�buf�krJ �rv� cookie_size�568value_sizes rB � dump_cookierw � sg � �X �� �T� 0�1��
��!�!�#�&�q�)�0�0��5�<�<�V�D�K�K�G�T���'�9�%�%��g�+�+�-�.�����'�3�'�'� ��(�G�� � � ��H�L�L�H�L�L� 9� C� C� E�� O�P�����>�>�#�� �4� 4� � K�L� L���� � (� (�� /� /� �$�$� 2�E�L�L�N�569�570�&��/� � �E�7�!� �� �j�j�l�!�!�(�+�
,�A�e�W� 5�5716�C� 572�6�� �G� � �G� � �6�� �X� � ��� �X� � � �$� ���
�9��U�573� � ��9� �J�J�q�M� � �574�575�a�S��!��:� �# �& 576���3� �B�577 �b�'�K��K�(�*���Z�578��
�
��C�5�=�j�\� J � +�j� 8� 9� :� �=� 8��579� C9�
9� � 580� �IrA c � � U SL USL :w a gU c USL =( d US:� $ Uc SU s=:* =( a U: $ s $ X:� a gSU s=:* =( a U: $ s $ )z[Checks if a given byte content range is valid for the given length.581 582.. versionadded:: 0.7583NFr r8 )r� r� r� s rB r� r� � sn � � ��
�4�4�<�(�� � ���~�,��1��,� � ��E� � �D� � � � � � �� �� � �� � � � rA )�datastructures)�http)T)rQ zt.AnyrR �bool�returnrM )rQ rM r| rM )re �584str | Nonerf zt.Mapping[str, t.Any]r| rM )rm z$dict[str, t.Any] | t.Iterable[t.Any]r| rM )re rp r| rM )rQ rM r| z list[str])rQ rM r| zdict[str, str | None])rQ r} r| ztuple[str, dict[str, str]])rQ r} r| r� )rQ r} r� ztype[_TAnyAccept]r| r� r} )rQ r} r� ztype[_TAnyAccept] | Noner| r� )rQ r} r� �9t.Callable[[ds.cache_control._CacheControl], None] | Noner| zds.RequestCacheControl)N.)rQ r} r� r~ r� r� r| r� r� )rQ r} r� r~ r� ztype[_TAnyCC] | Noner| r� )rQ r} r� �3t.Callable[[ds.ContentSecurityPolicy], None] | Noner| rp )rQ r} r� r r� r� r| r� )rQ r} r� r r� ztype[_TAnyCSP] | Noner| r� )rQ r} r� z't.Callable[[ds.HeaderSet], None] | Noner| z ds.HeaderSet)rQ r} r| z585ds.IfRange)rQ r} r� r{ r| zds.Range | None)rQ r} r� z*t.Callable[[ds.ContentRange], None] | Noner| zds.ContentRange | None)F)r� rM r� r{ r| rM )r� rM r| ztuple[str, bool])r� rU r| ztuple[None, None])r� r} r| z$tuple[str, bool] | tuple[None, None])rQ r} r| zds.ETags)r �bytesr| rM )rQ r} r| zdatetime | None)r z2datetime | date | int | float | struct_time | Noner| rM )rQ r} r| ztimedelta | None)r �timedelta | int | Noner| r} )NNNT) r1 r r� r} r z bytes | Noner- zdatetime | str | Noner. r{ r| r{ ))r r )r4 �"ds.Headers | list[tuple[str, str]]r5 zt.Iterable[str]r| rU )r4 r� r| rU )re rM r| r{ )re z WSGIEnvironment | str | Noner� z#type[ds.MultiDict[str, str]] | Noner| zds.MultiDict[str, str]) rz NNr� NFFTi� NF)rh rM rQ rM ri r� r z#str | datetime | int | float | Nonerj r} rk r} rl r{ rm r{ rn r{ ro r rp r} rq r{ r| rM )r� �586int | Noner� r� r� r� r| r{ )]�587__future__r � email.utilsr �re�typingr� rg r r r r r �enumr588 �hashlibr r r
� urllib.parser r � _internalr r �
TYPE_CHECKING�_typeshed.wsgir � frozensetrN �compiler� r; r= �HTTP_STATUS_CODESr5 rD rU �ArZ r] ri ro rx r� r� �ASCIIr� r� �VERBOSEr� r� r� r� �TypeVarr� �overloadr� r� r� r� r� r� r� r� r� r� r� r r r� r r r! r0 r6 r9 r3 r8 rD re rf rX �update�rangerw r� rz ry r� �sansiorz r/ r8 rA rB �<module>r� s9 �� "� � � � � � � � � � � � � � � � !� !��?�?�.��S�� � �:�:�?� @��� �
�� � � � �A���A�� �A� � �A� � � A�589 �� A� ��
A� ��A� � (�A� � �A� � �A� � �A� � �A� � �A� �� A� � � A� � �!A�" ��#A�$ ��%A�& � �'A�( ��)A�* � �+A�, � �-A�. � �/A�0 � �1A�2 � �3A�4 � �5A�6 ��7A�8 ��9A�: � �;A�< � �=A�> � (�?A�@ � �AA�B ��CA�D ��EA�F � �GA�H � �IA�J � #�KA�L � �MA�N � !�OA�P � *�QA�R � �SA�T � �UA�V � �WA�X � �YA�Z ��[A�\ � �]A�^ ��_A�` � �aA�b � �cA�d � �eA�f � *�gA�h 590� (� � � � � � %� "� � � � (�AA� �H"�4� "� �4� �! �H �j�j��2�4�4�(� ��&+ �\- �`591H�:�zH�X �J�J� 9����J� � �J�J�'>�b�h�h� O� ��J�J��592 �H�H�r�z�z��
� � �:�:�k�2�8�8�4� �X�v �j�j�)�2�8�8�4� ��i�i�
�[�9� � ��� <� � <� ��� V� � V� 8<�2� �2� 4�2��2�j �)�)�I�%E�593F�� ��� LP�!� �!�H�!� �!� �!� ��� LP� �� ��H�� 594��
� � �� LP� $�4� �4�H�4� 595 �4�
� 4�<
�9�9�Z�'A� B�� ��� FJ�#� �#�B�#� �#� �#� ��� FJ� �� ��B�� 596�� � � �� FJ�!%�!!� �!!�B�!!� 597 �!!� � !!�L :>� =� � =�6� =� � =�B.�& /3�8#� �8#�'+�8#��8#�z =A�3� �3�9�3� �3�l � ��� 4� � 4���� 6� � 6��598��)��2"�:"��< EI� :�A� :�� :�@�,�, � �+/� � #�
�#�599�#� �#� )� #�600 � #� 601�
#�P ?��
/��
�� 602��0603�-�1� 04�"=� (�"=� ,�"=� �"=�J �j�j�!G����N� ��:�:� <�b�d�d�C� �!�'�2� � � � � �
6�u�T�{�
6�U�
6�U�4��%5�
6�� � �&*�37�� ��� �� � �X� �X� �X� $�X� 1� X�604 � X�
�
X�
�X� �X� �X� �X� �X� �X� �X�v � � � '� �1;� � � �& #� (rA