HEX
Server: Apache/2.4.52 (Ubuntu)
System: Linux spn-python 5.15.0-89-generic #99-Ubuntu SMP Mon Oct 30 20:42:41 UTC 2023 x86_64
User: arjun (1000)
PHP: 8.1.2-1ubuntu2.20
Disabled: NONE
$ pwd: /home/arjun/projects/env/lib/python3.10/site-packages/werkzeug/__pycache__/
Upload Files
File: //home/arjun/projects/env/lib/python3.10/site-packages/werkzeug/__pycache__/http.cpython-310.pyc
o

"wer��@srddlmZddlZddlZddlZddlZddlm	Z	ddlmZddlm
Z
ddlmZddlmZddl
mZdd	lmZdd
l
mZddl
mZddlmZdd
lmZddlmZddlmZddlmZejrsddlmZed�Z e�!d�Z"egd��Z#egd��Z$idd�dd�dd�dd�dd �d!d"�d#d$�d%d&�d'd(�d)d*�d+d,�d-d.�d/d0�d1d2�d3d4�d5d6�d7d8�id9d:�d;d<�d=d>�d?d@�dAdB�dCdD�dEdF�dGdH�dIdJ�dKdL�dMdN�dOdP�dQdR�dSdT�dUdV�dWdX�dYdZ��id[d\�d]d^�d_d`�dadb�dcdd�dedf�dgdh�didj�dkdl�dmdn�dodp�dqdr�dsdt�dudv�dwdx�dydz�d{d|��d}d~dd�d�d�d�d�d�d�d�d�d�d��
�Z%Gd�d��d�e�Z&Gd�d��d�e�Z'		��dI�dJd�d��Z(�dK�dLd�d��Z)�dMd�d��Z*	�dK�dNd�d��Z+�dOd�d��Z,�dPd�d��Z-�dK�dQd�d��Z.e�!d�ej/ej0B�Z1e�!d�ej/ej0B�Z2e�!d�ej/�Z3�dRd�d��Z4e�!d�ej/�Z5ej6d�d�d��Z7ej8�dSd�d���Z9ej8�dTd�d���Z9	�dK�dUd�d��Z9ej6d�d�d��Z:ej;ej<e:gdfZ=ej8	�dK�dVd�dɄ�Z>ej8�dWd�dɄ�Z>		�dX�dYd�dɄZ>ej6d�d�d��Z?ej;ej<e?gdfZ@ej8	�dK�dZd�dф�ZAej8�d[d�dф�ZA		�dX�d\d�dфZA	�dK�d]d�dلZB�d^d�d܄ZC	�dK�d_d�d�ZD�d`d�d�ZE	��da�dbd�d�ZF	�dK�dcd�d�ZG�dd�ded�d�ZH�dfd�d�ZI�dgd�d��ZJ�dhd�d��ZK�did�d��ZL	�dK�dj�d�d�ZM�dK�dk�d�d�ZN�dK�dl�d�d�ZO				��dm�dn�d�d�ZP�	�do�dp�d�d�ZQ�dq�d�d�ZR�dr�d�d�ZS�dr�d�d�ZT			�ds�dt�d#�d$�ZUe�!�d%ejV�ZWe�!�d&ejV�ZX�d'�d(�d)�ZYeY�Z�d*�d+�ge[�d,���d-�e[�d.�d/��D���	0		�	1		�	�		��	2	�du�dv�d?�d@�Z\�dw�dE�dF�Z]d�dGl^m_Z`d�dHlambZcdS(x�)�annotationsN��date)�datetime)�time)�	timedelta)�timezone)�Enum)�sha1)�mktime)�struct_time)�quote)�unquote)�parse_http_list�)�
_dt_as_utc)�
_plain_int)�WSGIEnvironmentzM!#$%&'*+-.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ^_`abcdefghijklmnopqrstuvwxyz|~z&([Ww]/)?(?:"(.*?)"|(.*?))(?:\s*,\s*|$))
�allowzcontent-encodingzcontent-languagezcontent-length�content-locationzcontent-md5z
content-rangezcontent-type�expiresz
last-modified)�
connectionz
keep-alivezproxy-authenticatezproxy-authorization�te�trailerztransfer-encoding�upgrade�d�Continue�ezSwitching Protocols�f�
Processing�gzEarly Hints���OK���Created���Accepted��zNon Authoritative Information��z
No Content��z
Reset Content��zPartial Content��zMulti Status��zAlready Reported��zIM Usedi,zMultiple Choicesi-zMoved Permanentlyi.�Foundi/z	See Otheri0zNot Modifiedi1z	Use Proxyi2zSwitch Proxyi3zTemporary Redirecti4zPermanent Redirecti�zBad Requesti��Unauthorizedi�zPayment Requiredi��	Forbiddeni�z	Not Foundi�zMethod Not Allowedi�zNot Acceptablei�zProxy Authentication Requiredi�zRequest Timeouti��Conflicti��Gonei�zLength Requiredi�zPrecondition Failedi�zRequest Entity Too Largei�zRequest URI Too Longi�zUnsupported Media Typei�zRequested 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�zRequest Header Fields Too Largez
Retry WithzUnavailable For Legal ReasonszInternal Server ErrorzNot ImplementedzBad GatewayzService UnavailablezGateway TimeoutzHTTP Version Not SupportedzVariant Also NegotiateszInsufficient Storagez
Loop DetectedzNot ExtendedzNetwork Authentication Failed)
i�i�i�i�i�i�i�i�i�i�i�i�i�c@seZdZdZdZdZdS)�COEPzCross Origin Embedder Policies�unsafe-nonezrequire-corpN)�__name__�
__module__�__qualname__�__doc__�UNSAFE_NONE�REQUIRE_CORP�r<r<�F/home/arjun/projects/env/lib/python3.10/site-packages/werkzeug/http.pyr4|sr4c@seZdZdZdZdZdZdS)�COOPzCross Origin Opener Policiesr5zsame-origin-allow-popupszsame-originN)r6r7r8r9r:�SAME_ORIGIN_ALLOW_POPUPS�SAME_ORIGINr<r<r<r=r>�s
r>T�value�t.Any�extra_chars�
str | None�allow_token�bool�return�strcCs�t|t�rtjdtdd�|�d�}|durtjdtdd�t|�}|s&dS|r9t}|r2|t|�O}|�	|�r9|S|�
dd	��
d
d�}d
|�d
�S)aAdd double quotes around a header value. If the header contains only ASCII token
    characters, it will be returned unchanged. If the header contains ``"`` or ``\``
    characters, they will be escaped with an additional ``\`` character.

    This is the reverse of :func:`unquote_header_value`.

    :param value: The value to quote. Will be converted to a string.
    :param allow_token: Disable to quote the value even if it only has token characters.

    .. versionchanged:: 2.3
        The value is quoted if it is the empty string.

    .. versionchanged:: 2.3
        Passing bytes is deprecated and will not be supported in Werkzeug 3.0.

    .. versionchanged:: 2.3
        The ``extra_chars`` parameter is deprecated and will be removed in Werkzeug 3.0.

    .. versionadded:: 0.5
    �FPassing bytes is deprecated and will not be supported in Werkzeug 3.0.���
stacklevel�latin1NzNThe 'extra_chars' parameter is deprecated and will be removed in Werkzeug 3.0.z""�\�\\�"�\")�
isinstance�bytes�warnings�warn�DeprecationWarning�decoderH�_token_chars�set�
issuperset�replace)rArCrE�token_charsr<r<r=�quote_header_value�s0
�
�
r]�is_filename�bool | NonecCsn|durtjdtdd�t|�dkr5|d|dkr dkr5n|S|dd�}|s5|�d	d
��dd�S|S)aBRemove double quotes and decode slash-escaped ``"`` and ``\`` characters in a
    header value.

    This is the reverse of :func:`quote_header_value`.

    :param value: The header value to unquote.

    .. versionchanged:: 2.3
        The ``is_filename`` parameter is deprecated and will be removed in Werkzeug 3.0.
    NzNThe 'is_filename' parameter is deprecated and will be removed in Werkzeug 3.0.rJrKr���rPrrOrNrQ)rTrUrV�lenr[)rAr^r<r<r=�unquote_header_value�s�*�rb�header�options�t.Mapping[str, t.Any]cCsvg}|dur|�|�|��D]&\}}|durq|ddkr)|�|�d|���q|�|�dt|����qd�|�S)aAProduce a header value and ``key=value`` parameters separated by semicolons
    ``;``. For example, the ``Content-Type`` header.

    .. code-block:: python

        dump_options_header("text/html", {"charset": "UTF-8"})
        'text/html; charset=UTF-8'

    This is the reverse of :func:`parse_options_header`.

    If a value contains non-token characters, it will be quoted.

    If a value is ``None``, the parameter is skipped.

    In some keys for some headers, a UTF-8 value can be encoded using a special
    ``key*=UTF-8''value`` form, where ``value`` is percent encoded. This function will
    not produce that format automatically, but if a given key ends with an asterisk
    ``*``, the value is assumed to have that form and will not be quoted further.

    :param header: The primary header value.
    :param options: Parameters to encode as ``key=value`` pairs.

    .. versionchanged:: 2.3
        Keys with ``None`` values are skipped rather than treated as a bare key.

    .. versionchanged:: 2.2.3
        If a key ends with ``*``, its value will not be quoted.
    Nr`�*�=�; )�append�itemsr]�join)rcrd�segments�keyrAr<r<r=�dump_options_header�s

rn�iterable�$dict[str, t.Any] | t.Iterable[t.Any]c	s��dur
tjdtdd�nd�t|t�rIg}|��D]-\}}|dur(|�|�q|ddkr9|�|�d|���q|�|�dt|�d	����qn	�fd
d�|D�}d�|�S)
aNProduce a header value from a list of items or ``key=value`` pairs, separated by
    commas ``,``.

    This is the reverse of :func:`parse_list_header`, :func:`parse_dict_header`, and
    :func:`parse_set_header`.

    If a value contains non-token characters, it will be quoted.

    If a value is ``None``, the key is output alone.

    In some keys for some headers, a UTF-8 value can be encoded using a special
    ``key*=UTF-8''value`` form, where ``value`` is percent encoded. This function will
    not produce that format automatically, but if a given key ends with an asterisk
    ``*``, the value is assumed to have that form and will not be quoted further.

    .. code-block:: python

        dump_header(["foo", "bar baz"])
        'foo, "bar baz"'

        dump_header({"foo": "bar baz"})
        'foo="bar baz"'

    :param iterable: The items to create a header from.

    .. versionchanged:: 2.3
        The ``allow_token`` parameter is deprecated and will be removed in Werkzeug 3.0.

    .. versionchanged:: 2.2.3
        If a key ends with ``*``, its value will not be quoted.
    NzO'The 'allow_token' parameter is deprecated and will be removed in Werkzeug 3.0.rJrKTr`rfrg�rEcsg|]}t|�d��qS)rq)r]��.0�xrqr<r=�
<listcomp>Jszdump_header.<locals>.<listcomp>z, )	rTrUrVrR�dictrjrir]rk)rorErjrmrAr<rqr=�dump_headers(#�
��

rw�ds.ContentSecurityPolicycCsd�dd�|��D��S)z�Dump a Content Security Policy header.

    These are structured into policies such as "default-src 'self';
    script-src 'self'".

    .. versionadded:: 1.0.0
       Support for Content Security Policy headers was added.

    rhcss"�|]\}}|�d|��VqdS)� Nr<�rsrmrAr<r<r=�	<genexpr>Ys� z"dump_csp_header.<locals>.<genexpr>)rkrj�rcr<r<r=�dump_csp_headerOs
r}�	list[str]cCsXg}t|�D]#}t|�dkr$|d|dkrdkr$nn|dd�}|�|�q|S)a�Parse a header value that consists of a list of comma separated items according
    to `RFC 9110 <https://httpwg.org/specs/rfc9110.html#abnf.extension>`__.

    This extends :func:`urllib.request.parse_http_list` to remove surrounding quotes
    from values.

    .. code-block:: python

        parse_list_header('token, "quoted value"')
        ['token', 'quoted value']

    This is the reverse of :func:`dump_header`.

    :param value: The header value to parse.
    rJrr`rPr)�_parse_list_headerrari)rA�result�itemr<r<r=�parse_list_header\s,r��cls�type[dict] | None�dict[str, str]cCs|durt}ntjdtdd�|�}t|t�r$tjdtdd�|�d�}t|�D]b}|�d�\}}}|�	�}|s=d||<q(|�	�}d}|dd	krj|dd�}t
�|�}|r`|��\}}|�
�}|d
vrjt||d�}t|�dkr�|d|dkr~d
kr�nn|dd�}|||<q(|S)a�Parse a list header using :func:`parse_list_header`, then parse each item as a
    ``key=value`` pair.

    .. code-block:: python

        parse_dict_header('a=b, c="d, e", f')
        {"a": "b", "c": "d, e", "f": None}

    This is the reverse of :func:`dump_header`.

    If a key does not have a value, it is ``None``.

    This handles charsets for values as described in
    `RFC 2231 <https://www.rfc-editor.org/rfc/rfc2231#section-3>`__. Only ASCII, UTF-8,
    and ISO-8859-1 charsets are accepted, otherwise the value remains quoted.

    :param value: The header value to parse.

    .. versionchanged:: 2.3
        Added support for ``key*=charset''value`` encoded items.

    .. versionchanged:: 2.3
        Passing bytes is deprecated, support will be removed in Werkzeug 3.0.

    .. versionchanged:: 2.3
        The ``cls`` argument is deprecated and will be removed in Werkzeug 3.0.

    .. versionchanged:: 0.9
       The ``cls`` argument was added.
    NzFThe 'cls' parameter is deprecated and will be removed in Werkzeug 3.0.rJrKz@Passing bytes is deprecated and will be removed in Werkzeug 3.0.rMrgr`rf>�ascii�utf-8�us-ascii�
iso-8859-1��encodingrrPr)rvrTrUrVrRrSrWr��	partition�strip�_charset_value_re�match�groups�lowerrra)rAr�r�r�rm�	has_valuer�r�r<r<r=�parse_dict_headerwsF�
�

,
r�a�
    # don't match multiple empty parts, that causes backtracking
    \s*;\s*  # find the part delimiter
    (?:
        ([\w!#$%&'*+\-.^`|~]+)  # key, one or more token chars
        =  # equals, with no space on either side
        (  # value, token or quoted string
            [\w!#$%&'*+\-.^`|~]+  # one or more token chars
        |
            "(?:\\\\|\\"|.)*?"  # quoted string, consuming slash escapes
        )
    )?  # optionally match key=value, to account for empty parts
    z�
    ([\w!#$%&*+\-.^`|~]*)'  # charset part, could be empty
    [\w!#$%&*+\-.^`|~]*'  # don't care about language part, usually empty
    ([\w!#$%&'*+\-.^`|~]+)  # one or more token chars with percent encoding
    z\*(\d+)$�tuple[str, dict[str, str]]c	CsZ|durdifS|�d�\}}}|��}|��}|r|s |ifSd|��}i}d}d}t�|�D]x\}}|s7q0|��}|ddkrh|dd�}t�|�}|rX|��\}}|��}|s\|}|dvrh|}t||d�}|d|dkrvd	kr�nn|d
d��	dd��	d
d	��	dd	�}t
�|�}|r�|d|���}|�
|d�|||<q0|||<q0||fS)a�Parse a header that consists of a value with ``key=value`` parameters separated
    by semicolons ``;``. For example, the ``Content-Type`` header.

    .. code-block:: python

        parse_options_header("text/html; charset=UTF-8")
        ('text/html', {'charset': 'UTF-8'})

        parse_options_header("")
        ("", {})

    This is the reverse of :func:`dump_options_header`.

    This parses valid parameter parts as described in
    `RFC 9110 <https://httpwg.org/specs/rfc9110.html#parameter>`__. Invalid parts are
    skipped.

    This handles continuations and charsets as described in
    `RFC 2231 <https://www.rfc-editor.org/rfc/rfc2231#section-3>`__, although not as
    strictly as the RFC. Only ASCII, UTF-8, and ISO-8859-1 charsets are accepted,
    otherwise the value remains quoted.

    Clients may not be consistent in how they handle a quote character within a quoted
    value. The `HTML Standard <https://html.spec.whatwg.org/#multipart-form-data>`__
    replaces it with ``%22`` in multipart form data.
    `RFC 9110 <https://httpwg.org/specs/rfc9110.html#quoted.strings>`__ uses backslash
    escapes in HTTP headers. Both are decoded to the ``"`` character.

    Clients may not be consistent in how they handle non-ASCII characters. HTML
    documents must declare ``<meta charset=UTF-8>``, otherwise browsers may replace with
    HTML character references, which can be decoded using :func:`html.unescape`.

    :param value: The header value to parse.
    :return: ``(value, options)``, where ``options`` is a dict

    .. versionchanged:: 2.3
        Invalid parts, such as keys with no value, quoted keys, and incorrectly quoted
        values, are discarded instead of treating as ``None``.

    .. versionchanged:: 2.3
        Only ASCII, UTF-8, and ISO-8859-1 are accepted for charset values.

    .. versionchanged:: 2.3
        Escaped quotes in quoted values, like ``%22`` and ``\"``, are handled.

    .. versionchanged:: 2.2
        Option names are always converted to lowercase.

    .. versionchanged:: 2.2
        The ``multiple`` parameter was removed.

    .. versionchanged:: 0.15
        :rfc:`2231` parameter continuations are handled.

    .. versionadded:: 0.5
    N��;r`rf>r�r�r�r�r�rrPrrOrNrQz%22)r�r��
_parameter_re�findallr�r�r�r�rr[�_continuation_re�search�start�get)	rA�_�restrdr��continued_encoding�pk�pvr�r<r<r=�parse_options_header�sD9

 $

r�z
-?\d+(\.\d+)?�_TAnyAccept�	ds.Accept)�boundcC�dS�Nr<)rAr<r<r=�parse_accept_headerl�r��type[_TAnyAccept]cCr�r�r<)rAr�r<r<r=r�qr��type[_TAnyAccept] | NonecCs�|durt�tjttj�}|s|d�Sg}t|�D]9}t|�\}}d|vrC|�d��	�}t
�|�dur5qt|�}|dksA|dkrBqnd}|rLt
||�}|�||f�q||�S)akParse an ``Accept`` header according to
    `RFC 9110 <https://httpwg.org/specs/rfc9110.html#field.accept>`__.

    Returns an :class:`.Accept` instance, which can sort and inspect items based on
    their quality parameter. When parsing ``Accept-Charset``, ``Accept-Encoding``, or
    ``Accept-Language``, pass the appropriate :class:`.Accept` subclass.

    :param value: The header value to parse.
    :param cls: The :class:`.Accept` class to wrap the result in.
    :return: An instance of ``cls``.

    .. versionchanged:: 2.3
        Parse according to RFC 9110. Items with invalid ``q`` values are skipped.
    N�qrr)�t�cast�Typer��ds�Acceptr�r��popr��_q_value_re�	fullmatch�floatrnri)rAr�r�r�rd�q_strr�r<r<r=r�vs(�
�_TAnyCCzds.cache_control._CacheControl�	on_update�_t_cc_update�None�ds.RequestCacheControlcCr�r�r<�rAr�r�r<r<r=�parse_cache_control_header��r��
type[_TAnyCC]cCr�r�r<r�r<r<r=r��r��type[_TAnyCC] | NonecCs8|durt�tjttj�}|s|d|�S|t|�|�S)aParse a cache control header.  The RFC differs between response and
    request cache control, this method does not.  It's your responsibility
    to not use the wrong control statements.

    .. versionadded:: 0.5
       The `cls` was added.  If not specified an immutable
       :class:`~werkzeug.datastructures.RequestCacheControl` is returned.

    :param value: a cache control header to be parsed.
    :param on_update: an optional callable that is called every time a value
                      on the :class:`~werkzeug.datastructures.CacheControl`
                      object is changed.
    :param cls: the class for the returned object.  By default
                :class:`~werkzeug.datastructures.RequestCacheControl` is used.
    :return: a `cls` object.
    Nr<)r�r�r�r�r��RequestCacheControlr�r�r<r<r=r��s

�_TAnyCSP�
_t_csp_updatecCr�r�r<r�r<r<r=�parse_csp_header�r�r��type[_TAnyCSP]cCr�r�r<r�r<r<r=r��r��type[_TAnyCSP] | NonecCs�|durt�tjttj�}|dur|d|�Sg}|�d�D]}|��}d|vr=|���dd�\}}|�|��|��f�q|||�S)a�Parse a Content Security Policy header.

    .. versionadded:: 1.0.0
       Support for Content Security Policy headers was added.

    :param value: a csp header to be parsed.
    :param on_update: an optional callable that is called every time a value
                      on the object is changed.
    :param cls: the class for the returned object.  By default
                :class:`~werkzeug.datastructures.ContentSecurityPolicy` is used.
    :return: a `cls` object.
    Nr<r�ryr)	r�r�r�r�r��ContentSecurityPolicy�splitr�ri)rAr�r�rj�policy�	directiver<r<r=r��s
�
�'t.Callable[[ds.HeaderSet], None] | None�ds.HeaderSetcCs |st�d|�St�t|�|�S)aParse a set-like header and return a
    :class:`~werkzeug.datastructures.HeaderSet` object:

    >>> hs = parse_set_header('token, "quoted value"')

    The return value is an object that treats the items case-insensitively
    and keeps the order of the items:

    >>> 'TOKEN' in hs
    True
    >>> hs.index('quoted value')
    1
    >>> hs
    HeaderSet(['token', 'quoted value'])

    To create a header from the :class:`HeaderSet` again, use the
    :func:`dump_header` function.

    :param value: a set header to be parsed.
    :param on_update: an optional callable that is called every time a
                      value on the :class:`~werkzeug.datastructures.HeaderSet`
                      object is changed.
    :return: a :class:`~werkzeug.datastructures.HeaderSet`
    N)r��	HeaderSetr�)rAr�r<r<r=�parse_set_headersr��ds.Authorization | NonecCs&ddlm}tjdtdd�|�|�S)a�Parse an HTTP basic/digest authorization header transmitted by the web
    browser.  The return value is either `None` if the header was invalid or
    not given, otherwise an :class:`~werkzeug.datastructures.Authorization`
    object.

    :param value: the authorization header to parse.
    :return: a :class:`~werkzeug.datastructures.Authorization` object or `None`.

    .. deprecated:: 2.3
        Will be removed in Werkzeug 3.0. Use :meth:`.Authorization.from_header` instead.
    r)�
Authorizationzx'parse_authorization_header' is deprecated and will be removed in Werkzeug 2.4. Use 'Authorization.from_header' instead.rJrK)�datastructuresr�rTrUrV�from_header)rAr�r<r<r=�parse_authorization_header2s�
r��-t.Callable[[ds.WWWAuthenticate], None] | None�ds.WWWAuthenticatecCs@ddlm}tjdtdd�|�|�}|dur|d�}||_|S)a0Parse an HTTP WWW-Authenticate header into a
    :class:`~werkzeug.datastructures.WWWAuthenticate` object.

    :param value: a WWW-Authenticate header to parse.
    :param on_update: an optional callable that is called every time a value
                      on the :class:`~werkzeug.datastructures.WWWAuthenticate`
                      object is changed.
    :return: a :class:`~werkzeug.datastructures.WWWAuthenticate` object.

    .. deprecated:: 2.3
        Will be removed in Werkzeug 3.0. Use :meth:`.WWWAuthenticate.from_header`
        instead.
    r)�WWWAuthenticatez}'parse_www_authenticate_header' is deprecated and will be removed in Werkzeug 2.4. Use 'WWWAuthenticate.from_header' instead.rJrKN�basic)�datastructures.authr�rTrUrVr��
_on_update)rAr�r��rvr<r<r=�parse_www_authenticate_headerKs�
r��
ds.IfRangecCs:|st��St|�}|durtj|d�St�t|�d�S)z�Parses an if-range header which can be an etag or a date.  Returns
    a :class:`~werkzeug.datastructures.IfRange` object.

    .. versionchanged:: 2.0
        If the value represents a datetime, it is timezone-aware.

    .. versionadded:: 0.7
    Nrr)r��IfRange�
parse_date�unquote_etag)rArr<r<r=�parse_if_range_headerms	r��make_inclusive�ds.Range | Nonec	Csl|rd|vrdSg}d}|�dd�\}}|����}|�d�D]�}|��}d|vr,dS|�d�rO|dkr8dSzt|�}WntyIYdSwd}d}nYd|vr�|�dd�\}	}
|	��}	|
��}
zt|	�}WntytYdSw||ks}|dkr�dS|
r�zt|
�d}Wnty�YdSw||kr�dSnd}|dur�|nd}|�||f�qt�||�S)aParses a range header into a :class:`~werkzeug.datastructures.Range`
    object.  If the header is missing or malformed `None` is returned.
    `ranges` is a list of ``(start, stop)`` tuples where the ranges are
    non-inclusive.

    .. versionadded:: 0.7
    rgNrr�,�-r`)	r�r�r��
startswithr�
ValueErrorrir��Range)rAr��ranges�last_end�units�rngr��begin�end�	begin_str�end_strr<r<r=�parse_range_headersX

����r��*t.Callable[[ds.ContentRange], None] | None�ds.ContentRange | NonecCs$|durdSz|p
d���dd�\}}Wn
tyYdSwd|vr%dS|�dd�\}}|dkr4d}nzt|�}Wn
tyDYdSw|dkr[tdd|�sQdStj|dd||d�Sd|vradS|�dd�\}}zt|�}	t|�d}
Wn
tyYdSwt|	|
|�r�tj||	|
||d�SdS)a�Parses a range header into a
    :class:`~werkzeug.datastructures.ContentRange` object or `None` if
    parsing is not possible.

    .. versionadded:: 0.7

    :param value: a content range header to be parsed.
    :param on_update: an optional callable that is called every time a value
                      on the :class:`~werkzeug.datastructures.ContentRange`
                      object is changed.
    Nr�r�/rf)r�r�)r�r�r�r�is_byte_range_validr��ContentRange)rAr�r��rangedefr��
length_str�length�	start_str�stop_strr��stopr<r<r=�parse_content_range_header�sB���r�F�etag�weakcCs.d|vrtd��d|�d�}|rd|��}|S)ziQuote an etag.

    :param etag: the etag to quote.
    :param weak: set to `True` to tag it "weak".
    rPzinvalid etag�W/)r��r�r�r<r<r=�
quote_etag�s
r�$tuple[str, bool] | tuple[None, None]cCsp|sdS|��}d}|�d�rd}|dd�}|dd�|dd�kr)d	kr4n||fS|dd�}||fS)
z�Unquote a single etag:

    >>> unquote_etag('W/"bar"')
    ('bar', True)
    >>> unquote_etag('"bar"')
    ('bar', False)

    :param etag: the etag identifier to unquote.
    :return: a ``(etag, weak)`` tuple.
    �NNF)r�zw/TrJNrr`rP)r�r�rr<r<r=r��s

&�r��ds.ETagsc	Cs�|st��Sg}g}t|�}d}||krIt�||�}|durn*|��\}}}|dkr0tjdd�S|r4|}|r<|�|�n|�|�|��}||kst�||�S)z�Parse an etag header.

    :param value: the tag header to parse
    :return: an :class:`~werkzeug.datastructures.ETags` object.
    rNrfT)�star_tag)r��ETagsra�_etag_rer�r�rir�)	rA�strongr�r��posr��is_weak�quoted�rawr<r<r=�parse_etagss*
�r
�datarScCst|���S)z�Generate an etag for some data.

    .. versionchanged:: 2.0
        Use SHA-1. MD5 may not be available in some environments.
    )r
�	hexdigest)rr<r<r=�
generate_etag4sr�datetime | Nonec	CsR|durdSztj�|�}WnttfyYdSw|jdur'|jtjd�S|S)aKParse an :rfc:`2822` date into a timezone-aware
    :class:`datetime.datetime` object, or ``None`` if parsing fails.

    This is a wrapper for :func:`email.utils.parsedate_to_datetime`. It
    returns ``None`` if parsing fails instead of raising an exception,
    and always returns a timezone-aware datetime object. If the string
    doesn't have timezone information, it is assumed to be UTC.

    :param value: A string with a supported date format.

    .. versionchanged:: 2.0
        Return a timezone-aware datetime object. Use
        ``email.utils.parsedate_to_datetime``.
    N��tzinfo)	�email�utils�parsedate_to_datetime�	TypeErrorr�rr[r�utc)rA�dtr<r<r=r�=s�
r��	timestamp�2datetime | date | int | float | struct_time | NonecCsdt|t�r!t|t�stj|t�tjd�}nt|�}tj	j
|dd�St|t�r*t|�}tj	j
|dd�S)a�Format a datetime object or timestamp into an :rfc:`2822` date
    string.

    This is a wrapper for :func:`email.utils.format_datetime`. It
    assumes naive datetime objects are in UTC instead of raising an
    exception.

    :param timestamp: The datetime or timestamp to format. Defaults to
        the current time.

    .. versionchanged:: 2.0
        Use ``email.utils.format_datetime``. Accept ``date`` objects.
    rT)�usegmt)rRrr�combinerrrrrr�format_datetimerr�
formatdate)rr<r<r=�	http_dateZs


r �timedelta | NonecCsX|sdSzt|�}Wn
tyYdSw|dkrdSzt|d�WSty+YdSw)z�Parses a base-10 integer count of seconds into a timedelta.

    If parsing fails, the return value is `None`.

    :param value: a string consisting of an integer represented in base-10
    :return: a :class:`datetime.timedelta` object or `None`.
    Nr)�seconds)�intr�r�
OverflowError)rAr"r<r<r=�	parse_agezs��r%�age�timedelta | int | NonecCsD|durdSt|t�rt|���}nt|�}|dkrtd��t|�S)z�Formats the duration as a base-10 integer.

    :param age: should be an integer number of seconds,
                a :class:`datetime.timedelta` object, or,
                if the age is unknown, `None` (default).
    Nrzage cannot be negative)rRrr#�
total_secondsr�rH)r&r<r<r=�dump_age�s
r)�environr�bytes | None�
last_modified�datetime | str | None�ignore_if_rangecCs:tj|�d�|�d�|�d�|�d�|�d�||||d�	S)a2Convenience method for conditional requests.

    :param environ: the WSGI environment of the request to be checked.
    :param etag: the etag for the response for comparison.
    :param data: or alternatively the data of the response to automatically
                 generate an etag using :func:`generate_etag`.
    :param last_modified: an optional date of the last modification.
    :param ignore_if_range: If `False`, `If-Range` header will be taken into
                            account.
    :return: `True` if the resource was modified, otherwise `False`.

    .. versionchanged:: 2.0
        SHA-1 is used to generate an etag value for the data. MD5 may
        not be available in some environments.

    .. versionchanged:: 1.0.0
        The check is run for methods other than ``GET`` and ``HEAD``.
    �
HTTP_RANGE�
HTTP_IF_RANGE�HTTP_IF_MODIFIED_SINCE�HTTP_IF_NONE_MATCH�
HTTP_IF_MATCH)	�
http_range�
http_if_range�http_if_modified_since�http_if_none_match�
http_if_matchr�rr,r.)�_sansio_http�is_resource_modifiedr�)r*r�rr,r.r<r<r=r:�s�r:�rr�headers�"ds.Headers | list[tuple[str, str]]�allowed�t.Iterable[str]cs,dd��D���fdd�|D�|dd�<dS)aRemove all entity headers from a list or :class:`Headers` object.  This
    operation works in-place.  `Expires` and `Content-Location` headers are
    by default not removed.  The reason for this is :rfc:`2616` section
    10.3.5 which specifies some entity headers that should be sent.

    .. versionchanged:: 0.5
       added `allowed` parameter.

    :param headers: a list or :class:`Headers` object.
    :param allowed: a list of headers that should still be allowed even though
                    they are entity headers.
    cSsh|]}|���qSr<)r�rrr<r<r=�	<setcomp>�sz(remove_entity_headers.<locals>.<setcomp>cs,g|]\}}t|�r|���vr||f�qSr<)�is_entity_headerr�rz�r>r<r=ru�s��z)remove_entity_headers.<locals>.<listcomp>Nr<)r<r>r<rBr=�remove_entity_headers�s
�rCcCsdd�|D�|dd�<dS)z�Remove all HTTP/1.1 "Hop-by-Hop" headers from a list or
    :class:`Headers` object.  This operation works in-place.

    .. versionadded:: 0.5

    :param headers: a list or :class:`Headers` object.
    cSs g|]\}}t|�s||f�qSr<)�is_hop_by_hop_headerrzr<r<r=ru�s
��z-remove_hop_by_hop_headers.<locals>.<listcomp>Nr<)r<r<r<r=�remove_hop_by_hop_headers�s�rEcC�|��tvS)z�Check if a header is an entity header.

    .. versionadded:: 0.5

    :param header: the header to test.
    :return: `True` if it's an entity header, `False` otherwise.
    )r��_entity_headersr|r<r<r=rA��rAcCrF)z�Check if a header is an HTTP/1.1 "Hop-by-Hop" header.

    .. versionadded:: 0.5

    :param header: the header to test.
    :return: `True` if it's an HTTP/1.1 "Hop-by-Hop" header, `False` otherwise.
    )r��_hop_by_hop_headersr|r<r<r=rD�rHrD�WSGIEnvironment | str | None�charset�errors�type[ds.MultiDict] | None�ds.MultiDict[str, str]cCsbt|t�r|�d�}nt|t�rtjdtdd�|��}n|}|r(|�d���}t	j
||||d�S)a}Parse a cookie from a string or WSGI environ.

    The same key can be provided multiple times, the values are stored
    in-order. The default :class:`MultiDict` will have the first value
    first, and all values can be retrieved with
    :meth:`MultiDict.getlist`.

    :param header: The cookie header as a string, or a WSGI environ dict
        with a ``HTTP_COOKIE`` key.
    :param cls: A dict-like class to store the parsed cookies in.
        Defaults to :class:`MultiDict`.

    .. versionchanged:: 2.3
        Passing bytes, and the ``charset`` and ``errors`` parameters, are deprecated and
        will be removed in Werkzeug 3.0.

    .. versionchanged:: 1.0
        Returns a :class:`MultiDict` instead of a ``TypeConversionDict``.

    .. versionchanged:: 0.5
        Returns a :class:`TypeConversionDict` instead of a regular dict. The ``cls``
        parameter was added.
    �HTTP_COOKIErIrJrKrM)�cookierKrLr�)rRrvr�rSrTrUrVrW�encoder9�parse_cookie)rcrKrLr�rPr<r<r=rRs

�
�rRz#[\w!#$%&'()*+\-./:<=>?@\[\]^`{|}~]*s[\x00-\x19\",;\\\x7f-\xff]s\"s\\)�"�\ccs$�|]
}|�dd�d|fVqdS)r�bigs\%03oN)�to_bytes)rs�vr<r<r=r{9s
��
�r{� s,;��r�r��rm�max_ager�#str | datetime | int | float | None�path�domain�secure�httponly�sync_expires�max_sizer#�samesitecCs2|dur
tjdtdd�nd}t|t�r tjdtdd�|��}t|t�r1tjdtdd�|��}|dur<t|d|d	�}|rN|�d
�d�d��	d
��d�}t|t
�rYt|���}|durgt|t
�sft|�}n|durz|	rzttjtjd���|�}|dur�|��}|dvr�td��t�|�s�t�dd�|�	|���d�}d|�d�}|�	��d��d|��g}d|fd|fd|fd|fd|fd|fd|ffD]!\}
}|dus�|dur�q�|dur�|�|
�q�|�|
�d|���q�d �|�}t|�}|
�r||
k�rt|�}tjd!|�d"|�d#||�d$|�d%|
�d&�dd�|S)'a�
Create a Set-Cookie header without the ``Set-Cookie`` prefix.

    The return value is usually restricted to ascii as the vast majority
    of values are properly escaped, but that is no guarantee. It's
    tunneled through latin1 as required by :pep:`3333`.

    The return value is not ASCII safe if the key contains unicode
    characters.  This is technically against the specification but
    happens in the wild.  It's strongly recommended to not use
    non-ASCII values for the keys.

    :param max_age: should be a number of seconds, or `None` (default) if
                    the cookie should last only as long as the client's
                    browser session.  Additionally `timedelta` objects
                    are accepted, too.
    :param expires: should be a `datetime` object or unix timestamp.
    :param path: limits the cookie to a given path, per default it will
                 span the whole domain.
    :param domain: Use this if you want to set a cross-domain cookie. For
                   example, ``domain="example.com"`` will set a cookie
                   that is readable by the domain ``www.example.com``,
                   ``foo.example.com`` etc. Otherwise, a cookie will only
                   be readable by the domain that set it.
    :param secure: The cookie will only be available via HTTPS
    :param httponly: disallow JavaScript to access the cookie.  This is an
                     extension to the cookie standard and probably not
                     supported by all browsers.
    :param charset: the encoding for string values.
    :param sync_expires: automatically set expires if max_age is defined
                         but expires not.
    :param max_size: Warn if the final header value exceeds this size. The
        default, 4093, should be safely `supported by most browsers
        <cookie_>`_. Set to 0 to disable this check.
    :param samesite: Limits the scope of the cookie such that it will
        only be attached to requests if those requests are same-site.

    .. _`cookie`: http://browsercookielimits.squawky.net/

    .. versionchanged:: 2.3.3
        The ``path`` parameter is ``/`` by default.

    .. versionchanged:: 2.3.1
        The value allows more characters without quoting.

    .. versionchanged:: 2.3
        ``localhost`` and other names without a dot are allowed for the domain. A
        leading dot is ignored.

    .. versionchanged:: 2.3
        The ``path`` parameter is ``None`` by default.

    .. versionchanged:: 2.3
        Passing bytes, and the ``charset`` parameter, are deprecated and will be removed
        in Werkzeug 3.0.

    .. versionchanged:: 1.0.0
        The string ``'None'`` is accepted for ``samesite``.
    NzJThe 'charset' parameter is deprecated and will be removed in Werkzeug 3.0.rJrKr�zeThe 'key' parameter must be a string. Bytes are deprecated and will not be supported in Werkzeug 3.0.zgThe 'value' parameter must be a string. Bytes are deprecated and will not be supported in Werkzeug 3.0.z%!$&'()*+,/:=@)�safer��:r�.�idnar�)�tz>�Laxr��Strictz,SameSite must be 'Strict', 'Lax', or 'None'.cSst|��Sr�)�_cookie_slash_map�group)�mr<r<r=�<lambda>�szdump_cookie.<locals>.<lambda>rPrMrg�Domain�ExpireszMax-Age�Secure�HttpOnly�Path�SameSiteFTrhzThe '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.)rTrUrVrRrSrWr
r��lstriprQrr#r(rHr r�nowrrr�titler��_cookie_no_quote_rer��_cookie_slash_re�subrirkra)rmrAr\rr^r_r`rarKrbrcrd�buf�krWr��cookie_size�
value_sizer<r<r=�dump_cookie?s�H�
�
� 

�
���	

����r�r��
int | Noner�r�cCsp|du|dukr
dS|dur|dup|dkS|dur&d|ko#|kSS||kr,dSd|ko5|kSS)zcChecks if a given byte content range is valid for the given length.

    .. versionadded:: 0.7
    NFrr<)r�r�r�r<r<r=r��sr�)r�)�http)NT)rArBrCrDrErFrGrHr�)rArHr^r_rGrH)rcrDrdrerGrH)rorprEr_rGrH)rcrxrGrH)rArHrGr~)rArHr�r�rGr�)rArDrGr�)rArDrGr�)rArDr�r�rGr�)rArDr�r�rGr�)rArDr�r�r�r�rGr�)rArDr�r�r�r�rGr�r)rArDr�r�r�r�rGr�)rArDr�r�r�r�rGrx)rArDr�r�r�r�rGr�)rArDr�r�r�r�rGr�)rArDr�r�rGr�)rArDrGr�)rArDr�r�rGr�)rArDrGr�)T)rArDr�rFrGr�)rArDr�r�rGr�)F)r�rHr�rFrGrH)r�rDrGr)rArDrGr)rrSrGrH)rArDrGr)rrrGrH)rArDrGr!)r&r'rGrD)NNNT)r*rr�rDrr+r,r-r.rFrGrF)r;)r<r=r>r?rGr�)r<r=rGr�)rcrHrGrF)NNN)
rcrJrKrDrLrDr�rMrGrN)r�NNr�NFFNTr[N)rmrHrArHr\r'rr]r^rDr_rDr`rFrarFrKrDrbrFrcr#rdrDrGrH)r�r�r�r�r�r�rGrF)d�
__future__r�email.utilsr�re�typingr�rTrrrrr�enumr	�hashlibr
rr�urllib.parser
r�urllib.requestrr�	_internalrr�
TYPE_CHECKING�_typeshed.wsgir�	frozensetrX�compilerrGrI�HTTP_STATUS_CODESr4r>r]rbrnrwr}r�r��ASCII�VERBOSEr�r�r�r�r��TypeVarr��overloadr�r��Optional�Callabler�r�r�r�r�r�r�r�r�r�r�rr�r
rr�r r%r)r:rCrErArDrR�Aryrzrl�update�ranger�r�r�r�r��sansior�r9r<r<r<r=�<module>s��
����������	�
���
������������������� �!�"�#�$�%�&�'�(�)�*�+�,�-�.�/�0�1�2�3�4�D
�;0�?
X

�
�	|�5����&�!�"�=�6	� �(�

�1 ��0
@ Telegram