Bump mako from 1.3.5 to 1.3.6 (#2423)

* Bump mako from 1.3.5 to 1.3.6

Bumps [mako](https://github.com/sqlalchemy/mako) from 1.3.5 to 1.3.6.
- [Release notes](https://github.com/sqlalchemy/mako/releases)
- [Changelog](https://github.com/sqlalchemy/mako/blob/main/CHANGES)
- [Commits](https://github.com/sqlalchemy/mako/commits)

---
updated-dependencies:
- dependency-name: mako
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>

* Update mako==1.3.6

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>

[skip ci]
This commit is contained in:
dependabot[bot] 2024-11-16 14:51:58 -08:00 committed by GitHub
parent af752e0acc
commit 9289ead996
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
7 changed files with 237 additions and 353 deletions

View file

@ -5,4 +5,4 @@
# the MIT License: http://www.opensource.org/licenses/mit-license.php # the MIT License: http://www.opensource.org/licenses/mit-license.php
__version__ = "1.3.5" __version__ = "1.3.6"

View file

@ -375,7 +375,7 @@ class Lexer:
| |
(?=\${) # an expression (?=\${) # an expression
| |
(?=</?[%&]) # a substitution or block or call start or end (?=</?%) # a substitution or block or call start or end
# - don't consume # - don't consume
| |
(\\\r?\n) # an escaped newline - throw away (\\\r?\n) # an escaped newline - throw away

View file

@ -1,29 +1,84 @@
import functools from __future__ import annotations
import collections.abc as cabc
import string import string
import sys
import typing as t import typing as t
try:
from ._speedups import _escape_inner
except ImportError:
from ._native import _escape_inner
if t.TYPE_CHECKING: if t.TYPE_CHECKING:
import typing_extensions as te import typing_extensions as te
class HasHTML(te.Protocol):
def __html__(self) -> str:
pass
_P = te.ParamSpec("_P") class _HasHTML(t.Protocol):
def __html__(self, /) -> str: ...
__version__ = "2.1.5" class _TPEscape(t.Protocol):
def __call__(self, s: t.Any, /) -> Markup: ...
def _simple_escaping_wrapper(func: "t.Callable[_P, str]") -> "t.Callable[_P, Markup]": def escape(s: t.Any, /) -> Markup:
@functools.wraps(func) """Replace the characters ``&``, ``<``, ``>``, ``'``, and ``"`` in
def wrapped(self: "Markup", *args: "_P.args", **kwargs: "_P.kwargs") -> "Markup": the string with HTML-safe sequences. Use this if you need to display
arg_list = _escape_argspec(list(args), enumerate(args), self.escape) text that might contain such characters in HTML.
_escape_argspec(kwargs, kwargs.items(), self.escape)
return self.__class__(func(self, *arg_list, **kwargs)) # type: ignore[arg-type]
return wrapped # type: ignore[return-value] 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 the object is already a plain string, skip __html__ check and string
# conversion. This is the most common use case.
# Use type(s) instead of s.__class__ because a proxy object may be reporting
# the __class__ of the proxied value.
if type(s) is str:
return Markup(_escape_inner(s))
if hasattr(s, "__html__"):
return Markup(s.__html__())
return Markup(_escape_inner(str(s)))
def escape_silent(s: t.Any | None, /) -> 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
class Markup(str): class Markup(str):
@ -65,82 +120,72 @@ class Markup(str):
__slots__ = () __slots__ = ()
def __new__( def __new__(
cls, base: t.Any = "", encoding: t.Optional[str] = None, errors: str = "strict" cls, object: t.Any = "", encoding: str | None = None, errors: str = "strict"
) -> "te.Self": ) -> te.Self:
if hasattr(base, "__html__"): if hasattr(object, "__html__"):
base = base.__html__() object = object.__html__()
if encoding is None: if encoding is None:
return super().__new__(cls, base) return super().__new__(cls, object)
return super().__new__(cls, base, encoding, errors) return super().__new__(cls, object, encoding, errors)
def __html__(self) -> "te.Self": def __html__(self, /) -> te.Self:
return self return self
def __add__(self, other: t.Union[str, "HasHTML"]) -> "te.Self": def __add__(self, value: str | _HasHTML, /) -> te.Self:
if isinstance(other, str) or hasattr(other, "__html__"): if isinstance(value, str) or hasattr(value, "__html__"):
return self.__class__(super().__add__(self.escape(other))) return self.__class__(super().__add__(self.escape(value)))
return NotImplemented return NotImplemented
def __radd__(self, other: t.Union[str, "HasHTML"]) -> "te.Self": def __radd__(self, value: str | _HasHTML, /) -> te.Self:
if isinstance(other, str) or hasattr(other, "__html__"): if isinstance(value, str) or hasattr(value, "__html__"):
return self.escape(other).__add__(self) return self.escape(value).__add__(self)
return NotImplemented return NotImplemented
def __mul__(self, num: "te.SupportsIndex") -> "te.Self": def __mul__(self, value: t.SupportsIndex, /) -> te.Self:
if isinstance(num, int): return self.__class__(super().__mul__(value))
return self.__class__(super().__mul__(num))
return NotImplemented def __rmul__(self, value: t.SupportsIndex, /) -> te.Self:
return self.__class__(super().__mul__(value))
__rmul__ = __mul__ def __mod__(self, value: t.Any, /) -> te.Self:
if isinstance(value, tuple):
def __mod__(self, arg: t.Any) -> "te.Self":
if isinstance(arg, tuple):
# a tuple of arguments, each wrapped # a tuple of arguments, each wrapped
arg = tuple(_MarkupEscapeHelper(x, self.escape) for x in arg) value = tuple(_MarkupEscapeHelper(x, self.escape) for x in value)
elif hasattr(type(arg), "__getitem__") and not isinstance(arg, str): elif hasattr(type(value), "__getitem__") and not isinstance(value, str):
# a mapping of arguments, wrapped # a mapping of arguments, wrapped
arg = _MarkupEscapeHelper(arg, self.escape) value = _MarkupEscapeHelper(value, self.escape)
else: else:
# a single argument, wrapped with the helper and a tuple # a single argument, wrapped with the helper and a tuple
arg = (_MarkupEscapeHelper(arg, self.escape),) value = (_MarkupEscapeHelper(value, self.escape),)
return self.__class__(super().__mod__(arg)) return self.__class__(super().__mod__(value))
def __repr__(self) -> str: def __repr__(self, /) -> str:
return f"{self.__class__.__name__}({super().__repr__()})" return f"{self.__class__.__name__}({super().__repr__()})"
def join(self, seq: t.Iterable[t.Union[str, "HasHTML"]]) -> "te.Self": def join(self, iterable: cabc.Iterable[str | _HasHTML], /) -> te.Self:
return self.__class__(super().join(map(self.escape, seq))) return self.__class__(super().join(map(self.escape, iterable)))
join.__doc__ = str.join.__doc__
def split( # type: ignore[override] def split( # type: ignore[override]
self, sep: t.Optional[str] = None, maxsplit: int = -1 self, /, sep: str | None = None, maxsplit: t.SupportsIndex = -1
) -> t.List["te.Self"]: ) -> list[te.Self]:
return [self.__class__(v) for v in super().split(sep, maxsplit)] return [self.__class__(v) for v in super().split(sep, maxsplit)]
split.__doc__ = str.split.__doc__
def rsplit( # type: ignore[override] def rsplit( # type: ignore[override]
self, sep: t.Optional[str] = None, maxsplit: int = -1 self, /, sep: str | None = None, maxsplit: t.SupportsIndex = -1
) -> t.List["te.Self"]: ) -> list[te.Self]:
return [self.__class__(v) for v in super().rsplit(sep, maxsplit)] return [self.__class__(v) for v in super().rsplit(sep, maxsplit)]
rsplit.__doc__ = str.rsplit.__doc__
def splitlines( # type: ignore[override] def splitlines( # type: ignore[override]
self, keepends: bool = False self, /, keepends: bool = False
) -> t.List["te.Self"]: ) -> list[te.Self]:
return [self.__class__(v) for v in super().splitlines(keepends)] return [self.__class__(v) for v in super().splitlines(keepends)]
splitlines.__doc__ = str.splitlines.__doc__ def unescape(self, /) -> str:
def unescape(self) -> str:
"""Convert escaped markup back into a text string. This replaces """Convert escaped markup back into a text string. This replaces
HTML entities with the characters they represent. HTML entities with the characters they represent.
@ -151,7 +196,7 @@ class Markup(str):
return unescape(str(self)) return unescape(str(self))
def striptags(self) -> str: def striptags(self, /) -> str:
""":meth:`unescape` the markup, remove tags, and normalize """:meth:`unescape` the markup, remove tags, and normalize
whitespace to single spaces. whitespace to single spaces.
@ -163,31 +208,17 @@ class Markup(str):
# Look for comments then tags separately. Otherwise, a comment that # Look for comments then tags separately. Otherwise, a comment that
# contains a tag would end early, leaving some of the comment behind. # contains a tag would end early, leaving some of the comment behind.
while True: # keep finding comment start marks
# keep finding comment start marks while (start := value.find("<!--")) != -1:
start = value.find("<!--")
if start == -1:
break
# find a comment end mark beyond the start, otherwise stop # find a comment end mark beyond the start, otherwise stop
end = value.find("-->", start) if (end := value.find("-->", start)) == -1:
if end == -1:
break break
value = f"{value[:start]}{value[end + 3:]}" value = f"{value[:start]}{value[end + 3:]}"
# remove tags using the same method # remove tags using the same method
while True: while (start := value.find("<")) != -1:
start = value.find("<") if (end := value.find(">", start)) == -1:
if start == -1:
break
end = value.find(">", start)
if end == -1:
break break
value = f"{value[:start]}{value[end + 1:]}" value = f"{value[:start]}{value[end + 1:]}"
@ -197,7 +228,7 @@ class Markup(str):
return self.__class__(value).unescape() return self.__class__(value).unescape()
@classmethod @classmethod
def escape(cls, s: t.Any) -> "te.Self": def escape(cls, s: t.Any, /) -> te.Self:
"""Escape a string. Calls :func:`escape` and ensures that for """Escape a string. Calls :func:`escape` and ensures that for
subclasses the correct type is returned. subclasses the correct type is returned.
""" """
@ -208,49 +239,90 @@ class Markup(str):
return rv # type: ignore[return-value] return rv # type: ignore[return-value]
__getitem__ = _simple_escaping_wrapper(str.__getitem__) def __getitem__(self, key: t.SupportsIndex | slice, /) -> te.Self:
capitalize = _simple_escaping_wrapper(str.capitalize) return self.__class__(super().__getitem__(key))
title = _simple_escaping_wrapper(str.title)
lower = _simple_escaping_wrapper(str.lower)
upper = _simple_escaping_wrapper(str.upper)
replace = _simple_escaping_wrapper(str.replace)
ljust = _simple_escaping_wrapper(str.ljust)
rjust = _simple_escaping_wrapper(str.rjust)
lstrip = _simple_escaping_wrapper(str.lstrip)
rstrip = _simple_escaping_wrapper(str.rstrip)
center = _simple_escaping_wrapper(str.center)
strip = _simple_escaping_wrapper(str.strip)
translate = _simple_escaping_wrapper(str.translate)
expandtabs = _simple_escaping_wrapper(str.expandtabs)
swapcase = _simple_escaping_wrapper(str.swapcase)
zfill = _simple_escaping_wrapper(str.zfill)
casefold = _simple_escaping_wrapper(str.casefold)
if sys.version_info >= (3, 9): def capitalize(self, /) -> te.Self:
removeprefix = _simple_escaping_wrapper(str.removeprefix) return self.__class__(super().capitalize())
removesuffix = _simple_escaping_wrapper(str.removesuffix)
def partition(self, sep: str) -> t.Tuple["te.Self", "te.Self", "te.Self"]: def title(self, /) -> te.Self:
l, s, r = super().partition(self.escape(sep)) return self.__class__(super().title())
def lower(self, /) -> te.Self:
return self.__class__(super().lower())
def upper(self, /) -> te.Self:
return self.__class__(super().upper())
def replace(self, old: str, new: str, count: t.SupportsIndex = -1, /) -> te.Self:
return self.__class__(super().replace(old, self.escape(new), count))
def ljust(self, width: t.SupportsIndex, fillchar: str = " ", /) -> te.Self:
return self.__class__(super().ljust(width, self.escape(fillchar)))
def rjust(self, width: t.SupportsIndex, fillchar: str = " ", /) -> te.Self:
return self.__class__(super().rjust(width, self.escape(fillchar)))
def lstrip(self, chars: str | None = None, /) -> te.Self:
return self.__class__(super().lstrip(chars))
def rstrip(self, chars: str | None = None, /) -> te.Self:
return self.__class__(super().rstrip(chars))
def center(self, width: t.SupportsIndex, fillchar: str = " ", /) -> te.Self:
return self.__class__(super().center(width, self.escape(fillchar)))
def strip(self, chars: str | None = None, /) -> te.Self:
return self.__class__(super().strip(chars))
def translate(
self,
table: cabc.Mapping[int, str | int | None], # type: ignore[override]
/,
) -> str:
return self.__class__(super().translate(table))
def expandtabs(self, /, tabsize: t.SupportsIndex = 8) -> te.Self:
return self.__class__(super().expandtabs(tabsize))
def swapcase(self, /) -> te.Self:
return self.__class__(super().swapcase())
def zfill(self, width: t.SupportsIndex, /) -> te.Self:
return self.__class__(super().zfill(width))
def casefold(self, /) -> te.Self:
return self.__class__(super().casefold())
def removeprefix(self, prefix: str, /) -> te.Self:
return self.__class__(super().removeprefix(prefix))
def removesuffix(self, suffix: str) -> te.Self:
return self.__class__(super().removesuffix(suffix))
def partition(self, sep: str, /) -> tuple[te.Self, te.Self, te.Self]:
left, sep, right = super().partition(sep)
cls = self.__class__ cls = self.__class__
return cls(l), cls(s), cls(r) return cls(left), cls(sep), cls(right)
def rpartition(self, sep: str) -> t.Tuple["te.Self", "te.Self", "te.Self"]: def rpartition(self, sep: str, /) -> tuple[te.Self, te.Self, te.Self]:
l, s, r = super().rpartition(self.escape(sep)) left, sep, right = super().rpartition(sep)
cls = self.__class__ cls = self.__class__
return cls(l), cls(s), cls(r) return cls(left), cls(sep), cls(right)
def format(self, *args: t.Any, **kwargs: t.Any) -> "te.Self": def format(self, *args: t.Any, **kwargs: t.Any) -> te.Self:
formatter = EscapeFormatter(self.escape) formatter = EscapeFormatter(self.escape)
return self.__class__(formatter.vformat(self, args, kwargs)) return self.__class__(formatter.vformat(self, args, kwargs))
def format_map( # type: ignore[override] def format_map(
self, map: t.Mapping[str, t.Any] self,
) -> "te.Self": mapping: cabc.Mapping[str, t.Any], # type: ignore[override]
/,
) -> te.Self:
formatter = EscapeFormatter(self.escape) formatter = EscapeFormatter(self.escape)
return self.__class__(formatter.vformat(self, (), map)) return self.__class__(formatter.vformat(self, (), mapping))
def __html_format__(self, format_spec: str) -> "te.Self": def __html_format__(self, format_spec: str, /) -> te.Self:
if format_spec: if format_spec:
raise ValueError("Unsupported format specification for Markup.") raise ValueError("Unsupported format specification for Markup.")
@ -260,8 +332,8 @@ class Markup(str):
class EscapeFormatter(string.Formatter): class EscapeFormatter(string.Formatter):
__slots__ = ("escape",) __slots__ = ("escape",)
def __init__(self, escape: t.Callable[[t.Any], Markup]) -> None: def __init__(self, escape: _TPEscape) -> None:
self.escape = escape self.escape: _TPEscape = escape
super().__init__() super().__init__()
def format_field(self, value: t.Any, format_spec: str) -> str: def format_field(self, value: t.Any, format_spec: str) -> str:
@ -278,55 +350,46 @@ class EscapeFormatter(string.Formatter):
else: else:
# We need to make sure the format spec is str here as # We need to make sure the format spec is str here as
# otherwise the wrong callback methods are invoked. # otherwise the wrong callback methods are invoked.
rv = string.Formatter.format_field(self, value, str(format_spec)) rv = super().format_field(value, str(format_spec))
return str(self.escape(rv)) return str(self.escape(rv))
_ListOrDict = t.TypeVar("_ListOrDict", list, dict)
def _escape_argspec(
obj: _ListOrDict, iterable: t.Iterable[t.Any], escape: t.Callable[[t.Any], Markup]
) -> _ListOrDict:
"""Helper for various string-wrapped functions."""
for key, value in iterable:
if isinstance(value, str) or hasattr(value, "__html__"):
obj[key] = escape(value)
return obj
class _MarkupEscapeHelper: class _MarkupEscapeHelper:
"""Helper for :meth:`Markup.__mod__`.""" """Helper for :meth:`Markup.__mod__`."""
__slots__ = ("obj", "escape") __slots__ = ("obj", "escape")
def __init__(self, obj: t.Any, escape: t.Callable[[t.Any], Markup]) -> None: def __init__(self, obj: t.Any, escape: _TPEscape) -> None:
self.obj = obj self.obj: t.Any = obj
self.escape = escape self.escape: _TPEscape = escape
def __getitem__(self, item: t.Any) -> "te.Self": def __getitem__(self, key: t.Any, /) -> te.Self:
return self.__class__(self.obj[item], self.escape) return self.__class__(self.obj[key], self.escape)
def __str__(self) -> str: def __str__(self, /) -> str:
return str(self.escape(self.obj)) return str(self.escape(self.obj))
def __repr__(self) -> str: def __repr__(self, /) -> str:
return str(self.escape(repr(self.obj))) return str(self.escape(repr(self.obj)))
def __int__(self) -> int: def __int__(self, /) -> int:
return int(self.obj) return int(self.obj)
def __float__(self) -> float: def __float__(self, /) -> float:
return float(self.obj) return float(self.obj)
# circular import def __getattr__(name: str) -> t.Any:
try: if name == "__version__":
from ._speedups import escape as escape import importlib.metadata
from ._speedups import escape_silent as escape_silent import warnings
from ._speedups import soft_str as soft_str
except ImportError: warnings.warn(
from ._native import escape as escape "The '__version__' attribute is deprecated and will be removed in"
from ._native import escape_silent as escape_silent # noqa: F401 " MarkupSafe 3.1. Use feature detection, or"
from ._native import soft_str as soft_str # noqa: F401 ' `importlib.metadata.version("markupsafe")`, instead.',
stacklevel=2,
)
return importlib.metadata.version("markupsafe")
raise AttributeError(name)

View file

@ -1,63 +1,8 @@
import typing as t def _escape_inner(s: str, /) -> str:
return (
from . import Markup s.replace("&", "&amp;")
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(">", "&gt;")
.replace("<", "&lt;") .replace("<", "&lt;")
.replace("'", "&#39;") .replace("'", "&#39;")
.replace('"', "&#34;") .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

View file

@ -1,22 +1,5 @@
#include <Python.h> #include <Python.h>
static PyObject* markup;
static int
init_constants(void)
{
PyObject *module;
/* import markup type so that we can mark the return value */
module = PyImport_ImportModule("markupsafe");
if (!module)
return 0;
markup = PyObject_GetAttrString(module, "Markup");
Py_DECREF(module);
return 1;
}
#define GET_DELTA(inp, inp_end, delta) \ #define GET_DELTA(inp, inp_end, delta) \
while (inp < inp_end) { \ while (inp < inp_end) { \
switch (*inp++) { \ switch (*inp++) { \
@ -166,135 +149,29 @@ escape_unicode_kind4(PyUnicodeObject *in)
} }
static PyObject* static PyObject*
escape_unicode(PyUnicodeObject *in) escape_unicode(PyObject *self, PyObject *s)
{ {
if (PyUnicode_READY(in)) if (!PyUnicode_Check(s))
return NULL; return NULL;
switch (PyUnicode_KIND(in)) { // This check is no longer needed in Python 3.12.
if (PyUnicode_READY(s))
return NULL;
switch (PyUnicode_KIND(s)) {
case PyUnicode_1BYTE_KIND: case PyUnicode_1BYTE_KIND:
return escape_unicode_kind1(in); return escape_unicode_kind1((PyUnicodeObject*) s);
case PyUnicode_2BYTE_KIND: case PyUnicode_2BYTE_KIND:
return escape_unicode_kind2(in); return escape_unicode_kind2((PyUnicodeObject*) s);
case PyUnicode_4BYTE_KIND: case PyUnicode_4BYTE_KIND:
return escape_unicode_kind4(in); return escape_unicode_kind4((PyUnicodeObject*) s);
} }
assert(0); /* shouldn't happen */ assert(0); /* shouldn't happen */
return NULL; return NULL;
} }
static PyObject*
escape(PyObject *self, PyObject *text)
{
static PyObject *id_html;
PyObject *s = NULL, *rv = NULL, *html;
if (id_html == NULL) {
id_html = PyUnicode_InternFromString("__html__");
if (id_html == NULL) {
return NULL;
}
}
/* we don't have to escape integers, bools or floats */
if (PyLong_CheckExact(text) ||
PyFloat_CheckExact(text) || PyBool_Check(text) ||
text == Py_None)
return PyObject_CallFunctionObjArgs(markup, text, NULL);
/* if the object has an __html__ method that performs the escaping */
html = PyObject_GetAttr(text ,id_html);
if (html) {
s = PyObject_CallObject(html, NULL);
Py_DECREF(html);
if (s == NULL) {
return NULL;
}
/* Convert to Markup object */
rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
Py_DECREF(s);
return rv;
}
/* otherwise make the object unicode if it isn't, then escape */
PyErr_Clear();
if (!PyUnicode_Check(text)) {
PyObject *unicode = PyObject_Str(text);
if (!unicode)
return NULL;
s = escape_unicode((PyUnicodeObject*)unicode);
Py_DECREF(unicode);
}
else
s = escape_unicode((PyUnicodeObject*)text);
/* convert the unicode string into a markup object. */
rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
Py_DECREF(s);
return rv;
}
static PyObject*
escape_silent(PyObject *self, PyObject *text)
{
if (text != Py_None)
return escape(self, text);
return PyObject_CallFunctionObjArgs(markup, NULL);
}
static PyObject*
soft_str(PyObject *self, PyObject *s)
{
if (!PyUnicode_Check(s))
return PyObject_Str(s);
Py_INCREF(s);
return s;
}
static PyMethodDef module_methods[] = { static PyMethodDef module_methods[] = {
{ {"_escape_inner", (PyCFunction)escape_unicode, METH_O, NULL},
"escape",
(PyCFunction)escape,
METH_O,
"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.\n\n"
"If the object has an ``__html__`` method, it is called and the"
" return value is assumed to already be safe for HTML.\n\n"
":param s: An object to be converted to a string and escaped.\n"
":return: A :class:`Markup` string with the escaped text.\n"
},
{
"escape_silent",
(PyCFunction)escape_silent,
METH_O,
"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``.\n\n"
">>> escape(None)\n"
"Markup('None')\n"
">>> escape_silent(None)\n"
"Markup('')\n"
},
{
"soft_str",
(PyCFunction)soft_str,
METH_O,
"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.\n\n"
">>> value = escape(\"<User 1>\")\n"
">>> value\n"
"Markup('&lt;User 1&gt;')\n"
">>> escape(str(value))\n"
"Markup('&amp;lt;User 1&amp;gt;')\n"
">>> escape(soft_str(value))\n"
"Markup('&lt;User 1&gt;')\n"
},
{NULL, NULL, 0, NULL} /* Sentinel */ {NULL, NULL, 0, NULL} /* Sentinel */
}; };
@ -313,8 +190,15 @@ static struct PyModuleDef module_definition = {
PyMODINIT_FUNC PyMODINIT_FUNC
PyInit__speedups(void) PyInit__speedups(void)
{ {
if (!init_constants()) PyObject *m = PyModule_Create(&module_definition);
return NULL;
return PyModule_Create(&module_definition); if (m == NULL) {
return NULL;
}
#ifdef Py_GIL_DISABLED
PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
#endif
return m;
} }

View file

@ -1,9 +1 @@
from typing import Any def _escape_inner(s: str, /) -> str: ...
from typing import Optional
from . import Markup
def escape(s: Any) -> Markup: ...
def escape_silent(s: Optional[Any]) -> Markup: ...
def soft_str(s: Any) -> str: ...
def soft_unicode(s: Any) -> str: ...

View file

@ -20,7 +20,7 @@ importlib-metadata==8.5.0
importlib-resources==6.4.5 importlib-resources==6.4.5
git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
IPy==1.01 IPy==1.01
Mako==1.3.5 Mako==1.3.6
MarkupSafe==2.1.5 MarkupSafe==2.1.5
musicbrainzngs==0.7.1 musicbrainzngs==0.7.1
packaging==24.1 packaging==24.1