?HAMA

Edit File Size: 1.94 KB

//proc/self/root/opt/alt/python37/lib64/python3.7/site-packages/markupsafe/_native.py

Text Base64

import typing as t

from . import Markup

def escape(s: t.Any) -> Markup:
    """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.
    """
    if hasattr(s, "__html__"):
        return Markup(s.__html__())

return Markup(
        str(s)
        .replace("&", "&amp;")
        .replace(">", "&gt;")
        .replace("<", "&lt;")
        .replace("'", "&#39;")
        .replace('"', "&#34;")
    )

def escape_silent(s: t.Optional[t.Any]) -> Markup:
    """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('')
    """
    if s is None:
        return Markup()

return escape(s)

def soft_str(s: t.Any) -> str:
    """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;')
    """
    if not isinstance(s, str):
        return str(s)

return s

def soft_unicode(s: t.Any) -> str:
    import warnings

warnings.warn(
        "'soft_unicode' has been renamed to 'soft_str'. The old name"
        " will be removed in MarkupSafe 2.1.",
        DeprecationWarning,
        stacklevel=2,
    )
    return soft_str(s)

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
__pycache__ DIR	-	drwxr-xr-x	2024-03-03 19:12:14	Edit Download recursive recursive
py.typed	0 B	lrw-r--r--	2021-01-30 02:46:42	Edit Download recursive recursive
_native.py	1.94 KB	lrw-r--r--	2021-04-15 22:27:24	Edit Download recursive recursive
_speedups.cpython-37m-x86_64-linux-gnu.so	15.91 KB	lrwxr-xr-x	2023-04-24 19:06:45	Edit Download recursive recursive
_speedups.pyi	229 B	lrw-r--r--	2021-05-11 02:01:42	Edit Download recursive recursive
__init__.py	8.71 KB	lrw-r--r--	2021-05-18 17:03:18	Edit Download recursive recursive

Directory Contents