RLi d dl ZddlmZ dej defdZdej ej defdZdej defdZ dej defd Z
dS )
N )Markupsreturnc d t | d r!t | S t t | dd dd dd dd d
d 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.
__html__&z&>z>>> escape(None)
Markup('None')
>>> escape_silent(None)
Markup('')
)r r r s r
escape_silentr s yxx !99r c N t | t st | 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("")
>>> value
Markup('<User 1>')
>>> escape(str(value))
Markup('<User 1>')
>>> escape(soft_str(value))
Markup('<User 1>')
)
isinstancer r s r soft_strr . s& a 1vv
Hr c b dd l }| dt d t | S )Nr z^'soft_unicode' has been renamed to 'soft_str'. The old name will be removed in MarkupSafe 2.1. )
stacklevel)warningswarnDeprecationWarningr )r r s r soft_unicoder B s? OOO MM . A;;r ) typingt r Anyr Optionalr r r r r r r' s ae 0
QZ&
6
#
( AE c r