Aug 3, 2024 · Aug 3, 2024
diff --git a/docs/auxil/admonition_inserter.py b/docs/auxil/admonition_inserter.py
            r"^\s*(?P<attr_name>[a-z_]+)"  # Any number of spaces, named group for attribute
            r"\s?\("  # Optional whitespace, opening parenthesis
            r".*"  # Any number of characters (that could denote a built-in type)
            r":class:`.+`"  # Marker of a classref, class name in backticks
            r":(class|obj):`.+`"  # Marker of a classref, class name in backticks
            r".*\):"  # Any number of characters, closing parenthesis, colon.
            # The ^ colon above along with parenthesis is important because it makes sure that
            # the class is mentioned in the attribute description, not in free text.
        )

        # for properties: there is no attr name in docstring.  Just check if there's a class name.
        prop_docstring_pattern = re.compile(r":class:`.+`.*:")
        prop_docstring_pattern = re.compile(r":(class|obj):`.+`.*:")

        # pattern for iterating over potentially many class names in docstring for one attribute.
        # Tilde is optional (sometimes it is in the docstring, sometimes not).
        single_class_name_pattern = re.compile(r":class:`~?(?P<class_name>[\w.]*)`")
        single_class_name_pattern = re.compile(r":(class|obj):`~?(?P<class_name>[\w.]*)`")

        classes_to_inspect = inspect.getmembers(telegram, inspect.isclass) + inspect.getmembers(
            telegram.ext, inspect.isclass
                    # to ".. admonition: Examples":
                    ".. admonition:: Examples",
                    ".. version",
                    "Args:",
                    # The space after ":param" is important because docstring can contain
                    # ":paramref:" in its plain text in the beginning of a line (e.g. ExtBot):
                    ":param ",
diff --git a/telegram/_payment/refundedpayment.py b/telegram/_payment/refundedpayment.py
    Objects of this class are comparable in terms of equality. Two objects of this class are
    considered equal, if their :attr:`telegram_payment_charge_id` is equal.

    .. versionadded:: 21.4

    Args:
        currency (:obj:`str`): Three-letter ISO 4217 `currency
            <https://core.telegram.org/bots/payments#supported-currencies>`_ code, or ``XTR`` for
Original file line number	Diff line number	Diff line change
Expand Up		@@ -140,7 +140,7 @@ def _create_available_in(self) -> dict[type, str]:
		r"^\s*(?P<attr_name>[a-z_]+)" # Any number of spaces, named group for attribute
		r"\s?\(" # Optional whitespace, opening parenthesis
		r".*" # Any number of characters (that could denote a built-in type)
		r":class:`.+`" # Marker of a classref, class name in backticks
		r":(class\|obj):`.+`" # Marker of a classref, class name in backticks
		r".*\):" # Any number of characters, closing parenthesis, colon.
		# The ^ colon above along with parenthesis is important because it makes sure that
		# the class is mentioned in the attribute description, not in free text.
Expand All		@@ -149,11 +149,11 @@ def _create_available_in(self) -> dict[type, str]:
		)

		# for properties: there is no attr name in docstring. Just check if there's a class name.
		prop_docstring_pattern = re.compile(r":class:`.+`.*:")
		prop_docstring_pattern = re.compile(r":(class\|obj):`.+`.*:")

		# pattern for iterating over potentially many class names in docstring for one attribute.
		# Tilde is optional (sometimes it is in the docstring, sometimes not).
		single_class_name_pattern = re.compile(r":class:`~?(?P<class_name>[\w.]*)`")
		single_class_name_pattern = re.compile(r":(class\|obj):`~?(?P<class_name>[\w.]*)`")

		classes_to_inspect = inspect.getmembers(telegram, inspect.isclass) + inspect.getmembers(
		telegram.ext, inspect.isclass
Expand DownExpand Up		@@ -366,6 +366,7 @@ def _find_insert_pos_for_admonition(lines: list[str]) -> int:
		# to ".. admonition: Examples":
		".. admonition:: Examples",
		".. version",
		"Args:",
		# The space after ":param" is important because docstring can contain
		# ":paramref:" in its plain text in the beginning of a line (e.g. ExtBot):
		":param ",
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -30,6 +30,8 @@ class RefundedPayment(TelegramObject):
		Objects of this class are comparable in terms of equality. Two objects of this class are
		considered equal, if their :attr:`telegram_payment_charge_id` is equal.

		.. versionadded:: 21.4

		Args:
		currency (:obj:`str`): Three-letter ISO 4217 `currency
		<https://core.telegram.org/bots/payments#supported-currencies>`_ code, or ``XTR`` for
Expand Down