o knh3@sddlmZddlmZddlZddlZzddlm Z Wne y+ddl m Z Ynwej r3ddl ZGdddejZGdddejZdd dZdddZdddZGdd d eZGdddejZGdddZd ddZdS)!) annotationsN) _escape_innerc@seZdZdddZdS)_HasHTMLreturnstrcCdSNselfr r >/usr/local/lib/python3.10/dist-packages/markupsafe/__init__.py__html__z_HasHTML.__html__Nrr)__name__ __module__ __qualname__rr r r r rrc@seZdZdddZdS) _TPEscapest.AnyrMarkupcCrr r )r rr r r __call__rz_TPEscape.__call__Nrrrr)rrrrr r r r rrrrrrrcCs>t|tur tt|St|drt|Sttt|S)aReplace 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)typerrrhasattrrrr r r escapes    r t.Any | NonecCs|durtSt|S)aLike :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)rrrr r r escape_silent0s r rcCst|ts t|S|S)aConvert 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("") >>> value Markup('<User 1>') >>> escape(str(value)) Markup('&lt;User 1&gt;') >>> escape(soft_str(value)) Markup('<User 1>') ) isinstancerrr r r soft_str@s r"cs>eZdZdZdZ d~dfdd ZdddZdfdd ZdddZdfdd Z dfdd Z dfdd Z dfdd Z dfd#d$ Z %ddfd)d* Z %ddfd+d, Z -ddfd0d1 Zdd2d3Zdd4d5Zedd7d8Zdfd;d< Zdfd=d> Zdfd?d@ ZdfdAdB ZdfdCdD ZddfdHdI ZddfdMdN ZddfdOdP ZddfdRdS ZddfdTdU ZddfdVdW ZddfdXdY Z dfd\d] Z!ddfd`da Z"dfdbdc Z#dfddde Z$dfdfdg Z%dfdidj Z&dfdldm Z'dfdodp Z(dfdqdr Z)ddudvZ*ddydzZ+dd|d}Z,Z-S)raA 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, World!") Markup('Hello, World!') >>> Markup(42) Markup('42') >>> Markup.escape("Hello, World!") Markup('Hello <em>World</em>!') 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 'foo' ... >>> Markup(Foo()) Markup('foo') This is a subclass of :class:`str`. It has the same methods, but escapes their arguments and returns a ``Markup`` instance. >>> Markup("%s") % ("foo & bar",) Markup('foo & bar') >>> Markup("Hello ") + "" Markup('Hello <foo>') r Nstrictobjectrencoding str | Noneerrorsrrte.Selfcs:t|dr |}|durt||St||||SNr)rrsuper__new__)clsr%r&r( __class__r r r,zs zMarkup.__new__cCs|Sr r r r r r rszMarkup.__html__valuestr | _HasHTMLcs0t|ts t|dr|t||StSr*)r!rrr/r+__add__rNotImplementedr r0r.r r r2szMarkup.__add__cCs(t|ts t|dr|||StSr*)r!rrrr2r3r4r r r __radd__szMarkup.__radd__t.SupportsIndexc|t|Sr r/r+__mul__r4r.r r r9zMarkup.__mul__cr7r r8r4r.r r __rmul__r:zMarkup.__rmul__csht|trtfdd|D}ntt|dr$t|ts$t|j}nt|jf}t |S)Nc3s|] }t|jVqdSr )_MarkupEscapeHelperr).0xr r r sz!Markup.__mod__.. __getitem__) r!tuplerrrr<rr/r+__mod__r4r.r r rBs zMarkup.__mod__cs|jjdtdS)N())r/rr+__repr__r r.r r rEzMarkup.__repr__iterablecabc.Iterable[str | _HasHTML]cs|tt|j|Sr )r/r+joinmapr)r rGr.r r rIrFz Markup.joinsepmaxsplit list[te.Self]cfddt||DS)Ncg|]}|qSr r.r=vr r r z Markup.split..)r+splitr rLrMr.r r rUz Markup.splitcrO)NcrPr r.rQr r r rSrTz!Markup.rsplit..)r+rsplitrVr.r r rXrWz Markup.rsplitFkeependsboolcsfddt|DS)NcrPr r.rQr r r rSrTz%Markup.splitlines..)r+ splitlines)r rYr.r r r[szMarkup.splitlinescCsddlm}|t|S)uConvert escaped markup back into a text string. This replaces HTML entities with the characters they represent. >>> Markup("Main » About").unescape() 'Main » About' r)unescape)htmlr\r)r r\r r r r\s  zMarkup.unescapecCst|}|d}dkr1|d|}dkrn|d|||dd}|d}dks |d}dkr^|d|}dkrEn|d|||dd}|d}dks:d |}||S) u:meth:`unescape` the markup, remove tags, and normalize whitespace to single spaces. >>> Markup("Main » About").striptags() 'Main » About' zN<>r )rfindrIrUr/r\)r r0startendr r r striptagss  zMarkup.striptagsrcCst|}|j|ur ||S|S)ztEscape a string. Calls :func:`escape` and ensures that for subclasses the correct type is returned. )rr/)r-rrvr r r rs z Markup.escapekeyt.SupportsIndex | slicecr7r )r/r+r@r rgr.r r r@r:zMarkup.__getitem__c|tSr )r/r+ capitalizer r.r r rkzMarkup.capitalizecrjr )r/r+titler r.r r rmrlz Markup.titlecrjr )r/r+lowerr r.r r rnrlz Markup.lowercrjr )r/r+upperr r.r r rorlz Markup.upperoldnewcountcs|t||||Sr )r/r+replacer)r rprqrrr.r r rsszMarkup.replacerawidthfillcharc|t|||Sr )r/r+ljustrr rtrur.r r rwrFz Markup.ljustcrvr )r/r+rjustrrxr.r r ryrFz Markup.rjustcharscr7r )r/r+lstripr rzr.r r r{ r:z Markup.lstripcr7r )r/r+rstripr|r.r r r} r:z Markup.rstripcrvr )r/r+centerrrxr.r r r~rFz Markup.centercr7r )r/r+stripr|r.r r rr:z Markup.striptable#cabc.Mapping[int, str | int | None]cr7r )r/r+ translate)r rr.r r rszMarkup.translatetabsizecr7r )r/r+ expandtabs)r rr.r r rr:zMarkup.expandtabscrjr )r/r+swapcaser r.r r r rlzMarkup.swapcasecr7r )r/r+zfill)r rtr.r r r#r:z Markup.zfillcrjr )r/r+casefoldr r.r r r&rlzMarkup.casefoldprefixcr7r )r/r+ removeprefix)r rr.r r r)r:zMarkup.removeprefixsuffixcr7r )r/r+ removesuffix)r rr.r r r,r:zMarkup.removesuffix tuple[te.Self, te.Self, te.Self]c.t|\}}}|j}||||||fSr )r+ partitionr/r rLleftrightr-r.r r r/zMarkup.partitioncrr )r+ rpartitionr/rr.r r r4rzMarkup.rpartitionargskwargscOst|j}|||||Sr EscapeFormatterrr/vformat)r rr formatterr r r format9s z Markup.formatmappingcabc.Mapping[str, t.Any]cCst|j}|||d|S)Nr r)r rrr r r format_map=s zMarkup.format_map format_speccCs|rtd|S)Nz,Unsupported format specification for Markup.) ValueError)r rr r r __html_format__EszMarkup.__html_format__)r#Nr$)r%rr&r'r(rrr))rr))r0r1rr))r0r6rr))r0rrr)r)rGrHrr))NrK)rLr'rMr6rrN)F)rYrZrrN)rrrr))rgrhrr))rK)rprrqrrrr6rr))ra)rtr6rurrr)r )rzr'rr))rrrr)r)rr6rr))rtr6rr))rrrr))rrrr))rLrrr)rrrrrr))rrrr))rrrr)).rrr__doc__ __slots__r,rr2r5r9r;rBrErIrUrXr[r\re classmethodrr@rkrmrnrorsrwryr{r}r~rrrrrrrrrrrrr __classcell__r r r.r rTs^#         cs0eZdZdZdfdd Zdfd d ZZS)r)rrrrNonecs||_tdSr )rr+__init__)r rr.r r rOszEscapeFormatter.__init__r0rrrcsht|dr ||}n"t|dr$|rtd|dt|d|}n t|t|}t||S)NrrzFormat specifier z given, but z{ does not define __html_format__. A class that defines __html__ must define __html_format__ to work with format specifiers.) rrrrrr+ format_fieldrr)r r0rrfr.r r rSs    zEscapeFormatter.format_field)rrrr)r0rrrrr)rrrrrrrr r r.r rLsrc@sPeZdZdZdZdd d Zdd dZdddZdddZdddZ dddZ dS) r<z"Helper for :meth:`Markup.__mod__`.objrrrrrrrcCs||_||_dSr r)r rrr r r rjs z_MarkupEscapeHelper.__init__rgr)cCs||j||jSr )r/rrrir r r r@nz_MarkupEscapeHelper.__getitem__rcCst||jSr )rrrr r r r __str__qrlz_MarkupEscapeHelper.__str__cCst|t|jSr )rrreprrr r r r rEtrz_MarkupEscapeHelper.__repr__intcC t|jSr )rrr r r r __int__w z_MarkupEscapeHelper.__int__floatcCrr )rrr r r r __float__zrz_MarkupEscapeHelper.__float__N)rrrrrr)rgrrr)r)rr)rr) rrrrrrr@rrErrr r r r r<es     r<namecCs:|dkrddl}ddl}|jddd|jdSt|)N __version__rzThe '__version__' attribute is deprecated and will be removed in MarkupSafe 3.1. Use feature detection, or `importlib.metadata.version("markupsafe")`, instead.) stacklevel markupsafe)importlib.metadatawarningswarnmetadataversionAttributeError)r importlibrr r r __getattr__~s rr)rrrr)rrrr)rrrr) __future__rcollections.abcabccabcstringtypingt _speedupsr ImportError_native TYPE_CHECKINGtyping_extensionsteProtocolrrrr r"rr Formatterrr<rr r r r s*     y