o
    Þý°jÀ3  ã                   @  sæ   d dl mZ d dlmZ d dlZd dlZzddlm	Z	 W n e
y+   ddlm	Z	 Y nw ejr3d dlZG dd„ dejƒZG dd„ dejƒZddd„Zddd„Zddd„ZG dd„ deƒZG dd„ dejƒZG dd„ dƒZd dd„ZdS )!é    )ÚannotationsNé   )Ú_escape_innerc                   @  s   e Zd Zddd„ZdS )Ú_HasHTMLÚreturnÚstrc                C  ó   d S ©N© ©Úselfr
   r
   ú†/root/aizidognhua/tmp/workspace/projects/ec89d86c-575f-41c9-af57-ac45cbdbf775/venv/lib/python3.10/site-packages/markupsafe/__init__.pyÚ__html__   ó    z_HasHTML.__html__N©r   r   )Ú__name__Ú
__module__Ú__qualname__r   r
   r
   r
   r   r      ó    r   c                   @  s   e Zd Zddd„ZdS )	Ú	_TPEscapeÚsút.Anyr   ÚMarkupc                C  r   r	   r
   )r   r   r
   r
   r   Ú__call__   r   z_TPEscape.__call__N©r   r   r   r   )r   r   r   r   r
   r
   r
   r   r      r   r   r   r   r   r   c                C  s>   t | ƒtu rtt| ƒƒS t| dƒrt|  ¡ ƒS ttt| ƒƒƒS )a¾  Replace the characters ``&``, ``<``, ``>``, ``'``, and ``"`` in
    the string with HTML-safe sequences. Use this if you need to display
    text that might contain such characters in HTML.

    If the object has an ``__html__`` method, it is called and the
    return value is assumed to already be safe for HTML.

    :param s: An object to be converted to a string and escaped.
    :return: A :class:`Markup` string with the escaped text.
    r   )Útyper   r   r   Úhasattrr   ©r   r
   r
   r   Úescape   s
   
r   út.Any | Nonec                C  s   | du rt ƒ S t| ƒS )a  Like :func:`escape` but treats ``None`` as the empty string.
    Useful with optional values, as otherwise you get the string
    ``'None'`` when the value is ``None``.

    >>> escape(None)
    Markup('None')
    >>> escape_silent(None)
    Markup('')
    N)r   r   r   r
   r
   r   Úescape_silent0   s   
r    r   c                C  s   t | tƒs	t| ƒS | S )a¨  Convert an object to a string if it isn't already. This preserves
    a :class:`Markup` string rather than converting it back to a basic
    string, so it will still be marked as safe and won't be escaped
    again.

    >>> value = escape("<User 1>")
    >>> value
    Markup('&lt;User 1&gt;')
    >>> escape(str(value))
    Markup('&amp;lt;User 1&amp;gt;')
    >>> escape(soft_str(value))
    Markup('&lt;User 1&gt;')
    )Ú
isinstancer   r   r
   r
   r   Úsoft_str@   s   
r"   c                      s>  e Zd ZdZdZ	d~d‡ fdd„Zd€dd„Zd�‡ fdd„Zd�dd„Zd‚‡ fdd„Z	d‚‡ fdd„Z
dƒ‡ fdd„Zd„‡ fdd „Zd…‡ fd#d$„Z	%d†d‡‡ fd)d*„Z	%d†d‡‡ fd+d,„Z	-dˆd‰‡ fd0d1„Zd„d2d3„Zd„d4d5„ZedŠd7d8„ƒZd‹‡ fd;d<„Zd€‡ fd=d>„Zd€‡ fd?d@„Zd€‡ fdAdB„Zd€‡ fdCdD„ZdŒd�‡ fdHdI„ZdŽd�‡ fdMdN„ZdŽd�‡ fdOdP„Zd�d‘‡ fdRdS„Zd�d‘‡ fdTdU„ZdŽd�‡ fdVdW„Zd�d‘‡ fdXdY„Z d’‡ fd\d]„Z!d“d”‡ fd`da„Z"d€‡ fdbdc„Z#d•‡ fddde„Z$d€‡ fdfdg„Z%d–‡ fdidj„Z&d—‡ fdldm„Z'd˜‡ fdodp„Z(d˜‡ fdqdr„Z)d™dudv„Z*dšdydz„Z+d›d|d}„Z,‡  Z-S )œr   a®  A string that is ready to be safely inserted into an HTML or XML
    document, either because it was escaped or because it was marked
    safe.

    Passing an object to the constructor converts it to text and wraps
    it to mark it safe without escaping. To escape the text, use the
    :meth:`escape` class method instead.

    >>> Markup("Hello, <em>World</em>!")
    Markup('Hello, <em>World</em>!')
    >>> Markup(42)
    Markup('42')
    >>> Markup.escape("Hello, <em>World</em>!")
    Markup('Hello &lt;em&gt;World&lt;/em&gt;!')

    This implements the ``__html__()`` interface that some frameworks
    use. Passing an object that implements ``__html__()`` will wrap the
    output of that method, marking it safe.

    >>> class Foo:
    ...     def __html__(self):
    ...         return '<a href="/foo">foo</a>'
    ...
    >>> Markup(Foo())
    Markup('<a href="/foo">foo</a>')

    This is a subclass of :class:`str`. It has the same methods, but
    escapes their arguments and returns a ``Markup`` instance.

    >>> Markup("<em>%s</em>") % ("foo & bar",)
    Markup('<em>foo &amp; bar</em>')
    >>> Markup("<em>Hello</em> ") + "<foo>"
    Markup('<em>Hello</em> &lt;foo&gt;')
    r
   Ú NÚstrictÚobjectr   Úencodingú
str | NoneÚerrorsr   r   úte.Selfc                   s:   t |dƒr	| ¡ }|d u rtƒ  | |¡S tƒ  | |||¡S ©Nr   )r   r   ÚsuperÚ__new__)Úclsr%   r&   r(   ©Ú	__class__r
   r   r,   z   s
   
zMarkup.__new__c                C  s   | S r	   r
   r   r
   r
   r   r   …   s   zMarkup.__html__Úvalueústr | _HasHTMLc                  s0   t |tƒs
t|dƒr|  tƒ  |  |¡¡¡S tS r*   )r!   r   r   r/   r+   Ú__add__r   ÚNotImplemented©r   r0   r.   r
   r   r2   ˆ   s   zMarkup.__add__c                C  s(   t |tƒs
t|dƒr|  |¡ | ¡S tS r*   )r!   r   r   r   r2   r3   r4   r
   r
   r   Ú__radd__Ž   s   zMarkup.__radd__út.SupportsIndexc                  ó   |   tƒ  |¡¡S r	   ©r/   r+   Ú__mul__r4   r.   r
   r   r9   ”   ó   zMarkup.__mul__c                  r7   r	   r8   r4   r.   r
   r   Ú__rmul__—   r:   zMarkup.__rmul__c                  sh   t |tƒrt‡ fdd„|D ƒƒ}ntt|ƒdƒr$t |tƒs$t|ˆ jƒ}nt|ˆ jƒf}ˆ  tƒ  	|¡¡S )Nc                 3  s   � | ]	}t |ˆ jƒV  qd S r	   )Ú_MarkupEscapeHelperr   )Ú.0Úxr   r
   r   Ú	<genexpr>�   s   € z!Markup.__mod__.<locals>.<genexpr>Ú__getitem__)
r!   Útupler   r   r   r<   r   r/   r+   Ú__mod__r4   r.   r   r   rB   š   s   
zMarkup.__mod__c                  s   | j j› dtƒ  ¡ › d�S )Nú(ú))r/   r   r+   Ú__repr__r   r.   r
   r   rE   §   ó   zMarkup.__repr__Úiterableúcabc.Iterable[str | _HasHTML]c                  s   |   tƒ  t| j|ƒ¡¡S r	   )r/   r+   ÚjoinÚmapr   )r   rG   r.   r
   r   rI   ª   rF   zMarkup.joinéÿÿÿÿÚsepÚmaxsplitúlist[te.Self]c                  ó   ‡ fdd„t ƒ  ||¡D ƒS )Nc                   ó   g | ]}ˆ   |¡‘qS r
   r.   ©r=   Úvr   r
   r   Ú
<listcomp>°   ó    z Markup.split.<locals>.<listcomp>)r+   Úsplit©r   rL   rM   r.   r   r   rU   ­   ó   zMarkup.splitc                  rO   )Nc                   rP   r
   r.   rQ   r   r
   r   rS   µ   rT   z!Markup.rsplit.<locals>.<listcomp>)r+   ÚrsplitrV   r.   r   r   rX   ²   rW   zMarkup.rsplitFÚkeependsÚboolc                  s   ‡ fdd„t ƒ  |¡D ƒS )Nc                   rP   r
   r.   rQ   r   r
   r   rS   º   rT   z%Markup.splitlines.<locals>.<listcomp>)r+   Ú
splitlines)r   rY   r.   r   r   r[   ·   s   zMarkup.splitlinesc                C  s   ddl m} |t| ƒƒS )uß   Convert escaped markup back into a text string. This replaces
        HTML entities with the characters they represent.

        >>> Markup("Main &raquo; <em>About</em>").unescape()
        'Main Â» <em>About</em>'
        r   )Úunescape)Úhtmlr\   r   )r   r\   r
   r
   r   r\   ¼   s   zMarkup.unescapec                C  sØ   t | ƒ}| d¡ }dkr1| d|¡ }dkrn|d|… › ||d d… › �}| d¡ }dks| d¡ }dkr^| d|¡ }dkrEn|d|… › ||d d… › �}| d¡ }dks:d	 | ¡ ¡}|  |¡ ¡ S )
u¼   :meth:`unescape` the markup, remove tags, and normalize
        whitespace to single spaces.

        >>> Markup("Main &raquo;	<em>About</em>").striptags()
        'Main Â» About'
        z<!--rK   z-->Né   ú<ú>r   ú )r   ÚfindrI   rU   r/   r\   )r   r0   ÚstartÚendr
   r
   r   Ú	striptagsÇ   s    û üzMarkup.striptagsr   c                C  s   t |ƒ}|j| ur| |ƒS |S )ztEscape a string. Calls :func:`escape` and ensures that for
        subclasses the correct type is returned.
        )r   r/   )r-   r   Úrvr
   r
   r   r   æ   s   
zMarkup.escapeÚkeyút.SupportsIndex | slicec                  r7   r	   )r/   r+   r@   ©r   rg   r.   r
   r   r@   ò   r:   zMarkup.__getitem__c                  ó   |   tƒ  ¡ ¡S r	   )r/   r+   Ú
capitalizer   r.   r
   r   rk   õ   ó   zMarkup.capitalizec                  rj   r	   )r/   r+   Útitler   r.   r
   r   rm   ø   rl   zMarkup.titlec                  rj   r	   )r/   r+   Úlowerr   r.   r
   r   rn   û   rl   zMarkup.lowerc                  rj   r	   )r/   r+   Úupperr   r.   r
   r   ro   þ   rl   zMarkup.upperÚoldÚnewÚcountc                  s   |   tƒ  ||  |¡|¡¡S r	   )r/   r+   Úreplacer   )r   rp   rq   rr   r.   r
   r   rs     s   zMarkup.replacera   ÚwidthÚfillcharc                  ó   |   tƒ  ||  |¡¡¡S r	   )r/   r+   Úljustr   ©r   rt   ru   r.   r
   r   rw     rF   zMarkup.ljustc                  rv   r	   )r/   r+   Úrjustr   rx   r.   r
   r   ry     rF   zMarkup.rjustÚcharsc                  r7   r	   )r/   r+   Úlstrip©r   rz   r.   r
   r   r{   
  r:   zMarkup.lstripc                  r7   r	   )r/   r+   Úrstripr|   r.   r
   r   r}     r:   zMarkup.rstripc                  rv   r	   )r/   r+   Úcenterr   rx   r.   r
   r   r~     rF   zMarkup.centerc                  r7   r	   )r/   r+   Ústripr|   r.   r
   r   r     r:   zMarkup.stripÚtableú#cabc.Mapping[int, str | int | None]c                  r7   r	   )r/   r+   Ú	translate)r   r€   r.   r
   r   r‚     s   zMarkup.translateé   Útabsizec                  r7   r	   )r/   r+   Ú
expandtabs)r   r„   r.   r
   r   r…     r:   zMarkup.expandtabsc                  rj   r	   )r/   r+   Úswapcaser   r.   r
   r   r†      rl   zMarkup.swapcasec                  r7   r	   )r/   r+   Úzfill)r   rt   r.   r
   r   r‡   #  r:   zMarkup.zfillc                  rj   r	   )r/   r+   Úcasefoldr   r.   r
   r   rˆ   &  rl   zMarkup.casefoldÚprefixc                  r7   r	   )r/   r+   Úremoveprefix)r   r‰   r.   r
   r   rŠ   )  r:   zMarkup.removeprefixÚsuffixc                   r7   r	   )r/   r+   Úremovesuffix)r   r‹   r.   r
   r   rŒ   ,  r:   zMarkup.removesuffixú tuple[te.Self, te.Self, te.Self]c                  ó.   t ƒ  |¡\}}}| j}||ƒ||ƒ||ƒfS r	   )r+   Ú	partitionr/   ©r   rL   ÚleftÚrightr-   r.   r
   r   r�   /  ó   zMarkup.partitionc                  rŽ   r	   )r+   Ú
rpartitionr/   r�   r.   r
   r   r”   4  r“   zMarkup.rpartitionÚargsÚkwargsc                 O  s   t | jƒ}|  | | ||¡¡S r	   ©ÚEscapeFormatterr   r/   Úvformat)r   r•   r–   Ú	formatterr
   r
   r   Úformat9  s   
zMarkup.formatÚmappingúcabc.Mapping[str, t.Any]c                C  s   t | jƒ}|  | | d|¡¡S )Nr
   r—   )r   rœ   rš   r
   r
   r   Ú
format_map=  s   
zMarkup.format_mapÚformat_specc                C  s   |rt dƒ‚| S )Nz,Unsupported format specification for Markup.)Ú
ValueError)r   rŸ   r
   r
   r   Ú__html_format__E  s   zMarkup.__html_format__)r#   Nr$   )r%   r   r&   r'   r(   r   r   r)   )r   r)   )r0   r1   r   r)   )r0   r6   r   r)   )r0   r   r   r)   r   )rG   rH   r   r)   )NrK   )rL   r'   rM   r6   r   rN   )F)rY   rZ   r   rN   )r   r   r   r)   )rg   rh   r   r)   )rK   )rp   r   rq   r   rr   r6   r   r)   )ra   )rt   r6   ru   r   r   r)   r	   )rz   r'   r   r)   )r€   r�   r   r   )rƒ   )r„   r6   r   r)   )rt   r6   r   r)   )r‰   r   r   r)   )r‹   r   r   r)   )rL   r   r   r�   )r•   r   r–   r   r   r)   )rœ   r�   r   r)   )rŸ   r   r   r)   ).r   r   r   Ú__doc__Ú	__slots__r,   r   r2   r5   r9   r;   rB   rE   rI   rU   rX   r[   r\   re   Úclassmethodr   r@   rk   rm   rn   ro   rs   rw   ry   r{   r}   r~   r   r‚   r…   r†   r‡   rˆ   rŠ   rŒ   r�   r”   r›   rž   r¡   Ú__classcell__r
   r
   r.   r   r   T   s^    #ÿ

ÿÿÿ



c                      s0   e Zd ZdZd‡ fdd„Zd‡ fdd„Z‡  ZS )r˜   )r   r   r   r   ÚNonec                   s   || _ tƒ  ¡  d S r	   )r   r+   Ú__init__)r   r   r.   r
   r   r§   O  s   zEscapeFormatter.__init__r0   r   rŸ   r   c                   sh   t |dƒr| |¡}n"t |dƒr$|rtd|› dt|ƒ› d�ƒ‚| ¡ }n	tƒ  |t|ƒ¡}t|  |¡ƒS )Nr¡   r   zFormat specifier z given, but z{ does not define __html_format__. A class that defines __html__ must define __html_format__ to work with format specifiers.)	r   r¡   r    r   r   r+   Úformat_fieldr   r   )r   r0   rŸ   rf   r.   r
   r   r¨   S  s   

ÿ
zEscapeFormatter.format_field)r   r   r   r¦   )r0   r   rŸ   r   r   r   )r   r   r   r£   r§   r¨   r¥   r
   r
   r.   r   r˜   L  s    r˜   c                   @  sP   e Zd ZdZdZdd	d
„Zddd„Zddd„Zddd„Zddd„Z	ddd„Z
dS ) r<   z"Helper for :meth:`Markup.__mod__`.©Úobjr   rª   r   r   r   r   r¦   c                 C  s   || _ || _d S r	   r©   )r   rª   r   r
   r
   r   r§   j  s   
z_MarkupEscapeHelper.__init__rg   r)   c                C  s   |   | j| | j¡S r	   )r/   rª   r   ri   r
   r
   r   r@   n  ó   z_MarkupEscapeHelper.__getitem__r   c                C  s   t |  | j¡ƒS r	   )r   r   rª   r   r
   r
   r   Ú__str__q  rl   z_MarkupEscapeHelper.__str__c                C  s   t |  t| jƒ¡ƒS r	   )r   r   Úreprrª   r   r
   r
   r   rE   t  r«   z_MarkupEscapeHelper.__repr__Úintc                C  ó
   t | jƒS r	   )r®   rª   r   r
   r
   r   Ú__int__w  ó   
z_MarkupEscapeHelper.__int__Úfloatc                C  r¯   r	   )r²   rª   r   r
   r
   r   Ú	__float__z  r±   z_MarkupEscapeHelper.__float__N)rª   r   r   r   r   r¦   )rg   r   r   r)   r   )r   r®   )r   r²   )r   r   r   r¢   r£   r§   r@   r¬   rE   r°   r³   r
   r
   r
   r   r<   e  s    




r<   Únamec                 C  s<   | dkrdd l }dd l}|jdtdd� |j d¡S t| ƒ‚)NÚ__version__r   zŸThe '__version__' attribute is deprecated and will be removed in MarkupSafe 3.1. Use feature detection, or `importlib.metadata.version("markupsafe")`, instead.é   )Ú
stacklevelÚ
markupsafe)Úimportlib.metadataÚwarningsÚwarnÚDeprecationWarningÚmetadataÚversionÚAttributeError)r´   Ú	importlibrº   r
   r
   r   Ú__getattr__~  s   ûrÁ   r   )r   r   r   r   )r   r   r   r   )r´   r   r   r   )Ú
__future__r   Úcollections.abcÚabcÚcabcÚstringÚtypingÚtÚ	_speedupsr   ÚImportErrorÚ_nativeÚTYPE_CHECKINGÚtyping_extensionsÚteÚProtocolr   r   r   r    r"   r   r   Ú	Formatterr˜   r<   rÁ   r
   r
   r
   r   Ú<module>   s*    ÿ


 y