Bump version to v21.1

CHANGES.rst

@@ -4,6 +4,48 @@
 Changelog
 =========
 
+Version 21.1
+==============
+
+*Released 2024-04-12*
+
+This is the technical changelog for version 21.1. More elaborate release notes can be found in the news channel `@pythontelegrambotchannel <https://t.me/pythontelegrambotchannel>`__.
+
+Major Changes
+-------------
+
+-  API 7.2 (:pr:`4180` closes :issue:`4179` and :issue:`4181`, :issue:`4181`)
+-  Make ``ChatAdministratorRights/ChatMemberAdministrator.can_*_stories`` Required (API 7.1) (:pr:`4192`)
+
+Minor Changes
+-------------
+
+-  Refactor Debug logging in ``Bot`` to Improve Type Hinting (:pr:`4151` closes :issue:`4010`)
+
+New Features
+------------
+
+-  Make ``Message.reply_*`` Reply in the Same Topic by Default (:pr:`4170` by `@aelkheir <https://github.com/aelkheir>`__ closes :issue:`4139`)
+-  Accept Socket Objects for Webhooks (:pr:`4161` closes :issue:`4078`)
+-  Add ``Update.effective_sender`` (:pr:`4168` by `@aelkheir <https://github.com/aelkheir>`__ closes :issue:`4085`)
+
+Documentation Improvements
+--------------------------
+
+-  Documentation Improvements (:pr:`4171`, :pr:`4158` by `@teslaedison <https://github.com/teslaedison>`__)
+
+Internal Changes
+----------------
+
+-  Temporarily Mark Tests with ``get_sticker_set`` as XFAIL due to API 7.2 Update (:pr:`4190`)
+
+Dependency Updates
+------------------
+
+-  ``pre-commit`` autoupdate (:pr:`4184`)
+-  Bump ``dependabot/fetch-metadata`` from 1.6.0 to 2.0.0 (:pr:`4185`)
+
+
 Version 21.0.1
 ==============
 

docs/source/conf.py

@@ -20,9 +20,9 @@ author = "Leandro Toledo"
 # built documents.
 #
 # The short X.Y version.
-version = "21.0.1"  # telegram.__version__[:3]
+version = "21.1"  # telegram.__version__[:3]
 # The full version, including alpha/beta/rc tags.
-release = "21.0.1"  # telegram.__version__
+release = "21.1"  # telegram.__version__
 
 # If your documentation needs a minimal Sphinx version, state it here.
 needs_sphinx = "6.1.3"

telegram/_birthdate.py

@@ -31,7 +31,7 @@ class Birthdate(TelegramObject):
     Objects of this class are comparable in terms of equality. Two objects of this class are
     considered equal, if their :attr:`day`, and :attr:`month` are equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
 
     Args:
         day (:obj:`int`): Day of the user's birth; 1-31.

telegram/_bot.py

@@ -964,7 +964,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -1332,7 +1332,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -1481,7 +1481,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -1630,7 +1630,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -1751,7 +1751,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -1901,7 +1901,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -2044,7 +2044,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -2195,7 +2195,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -2340,7 +2340,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -2461,7 +2461,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -2637,7 +2637,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -2918,7 +2918,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -3055,7 +3055,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -3170,7 +3170,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -3248,7 +3248,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
                 .. versionadded:: 20.0
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Returns:
             :obj:`bool`:  On success, :obj:`True` is returned.
@@ -6365,7 +6365,7 @@ CUSTOM_EMOJI_IDENTIFIER_LIMIT` custom emoji identifiers can be specified.
 
                 .. versionadded:: 20.2
 
-                .. deprecated:: NEXT.VERSION
+                .. deprecated:: 21.1
                     Use :paramref:`telegram.InputSticker.format` instead.
 
             sticker_type (:obj:`str`, optional): Type of stickers in the set, pass
@@ -6502,7 +6502,7 @@ CUSTOM_EMOJI_IDENTIFIER_LIMIT` custom emoji identifiers can be specified.
 
         .. versionadded:: 20.2
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
             As per Bot API 7.2, the new argument :paramref:`format` will be required, and thus the
             order of the arguments had to be changed.
 
@@ -6515,7 +6515,7 @@ CUSTOM_EMOJI_IDENTIFIER_LIMIT` custom emoji identifiers can be specified.
                 for a ``.TGS`` animation, :tg-const:`telegram.constants.StickerFormat.VIDEO` for a
                 WEBM video.
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
             thumbnail (:obj:`str` | :term:`file object` | :obj:`bytes` | :class:`pathlib.Path`, \
                 optional): A **.WEBP** or **.PNG** image with the thumbnail, must
@@ -6909,7 +6909,7 @@ CUSTOM_EMOJI_IDENTIFIER_LIMIT` custom emoji identifiers can be specified.
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -7072,7 +7072,7 @@ CUSTOM_EMOJI_IDENTIFIER_LIMIT` custom emoji identifiers can be specified.
                 .. versionadded:: 20.8
             business_connection_id (:obj:`str`, optional): |business_id_str|
 
-                .. versionadded:: NEXT.VERSION
+                .. versionadded:: 21.1
 
         Keyword Args:
             allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
@@ -8791,7 +8791,7 @@ CUSTOM_EMOJI_IDENTIFIER_LIMIT` custom emoji identifiers can be specified.
         """
         Use this method to get information about the connection of the bot with a business account.
 
-        .. versionadded:: NEXT.VERSION
+        .. versionadded:: 21.1
 
         Args:
             business_connection_id (:obj:`str`): Unique identifier of the business connection.
@@ -8834,7 +8834,7 @@ CUSTOM_EMOJI_IDENTIFIER_LIMIT` custom emoji identifiers can be specified.
         The method is equivalent to calling :meth:`delete_sticker_from_set`,
         then :meth:`add_sticker_to_set`, then :meth:`set_sticker_position_in_set`.
 
-        .. versionadded:: NEXT.VERSION
+        .. versionadded:: 21.1
 
         Args:
             user_id (:obj:`int`): User identifier of the sticker set owner.

telegram/_business.py

@@ -43,7 +43,7 @@ class BusinessConnection(TelegramObject):
     considered equal if their :attr:`id`, :attr:`user`, :attr:`user_chat_id`, :attr:`date`,
     :attr:`can_reply`, and :attr:`is_enabled` are equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
 
     Args:
         id (:obj:`str`): Unique identifier of the business connection.
@@ -130,7 +130,7 @@ class BusinessMessagesDeleted(TelegramObject):
     considered equal if their :attr:`business_connection_id`, :attr:`message_ids`, and
     :attr:`chat` are equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
 
     Args:
         business_connection_id (:obj:`str`): Unique identifier of the business connection.
@@ -195,7 +195,7 @@ class BusinessIntro(TelegramObject):
     Two objects of this class are considered equal, if their
     :attr:`title`, :attr:`message` and :attr:`sticker` are equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
 
     Args:
         title (:obj:`str`, optional): Title text of the business intro.
@@ -252,7 +252,7 @@ class BusinessLocation(TelegramObject):
     Two objects of this class are considered equal, if their
     :attr:`address` is equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
 
     Args:
         address (:obj:`str`): Address of the business.
@@ -304,7 +304,7 @@ class BusinessOpeningHoursInterval(TelegramObject):
     Two objects of this class are considered equal, if their
     :attr:`opening_minute` and :attr:`closing_minute` are equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
 
     Examples:
         A day has (24 * 60 =) 1440 minutes, a week has (7 * 1440 =) 10080 minutes.
@@ -396,7 +396,7 @@ class BusinessOpeningHours(TelegramObject):
     Two objects of this class are considered equal, if their
     :attr:`time_zone_name` and :attr:`opening_hours` are equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
 
     Args:
         time_zone_name (:obj:`str`): Unique name of the time zone for which the opening

telegram/_chat.py

@@ -177,17 +177,17 @@ class Chat(TelegramObject):
             business accounts, the intro of the business. Returned only in
             :meth:`telegram.Bot.get_chat`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         business_location (:class:`telegram.BusinessLocation`, optional): For private chats with
             business accounts, the location of the business. Returned only in
             :meth:`telegram.Bot.get_chat`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         business_opening_hours (:class:`telegram.BusinessOpeningHours`, optional): For private
             chats with business accounts, the opening hours of the business. Returned only in
             :meth:`telegram.Bot.get_chat`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         available_reactions (Sequence[:class:`telegram.ReactionType`], optional): List of available
             reactions allowed in the chat. If omitted, then all of
             :const:`telegram.constants.ReactionEmoji` are allowed. Returned only in
@@ -251,11 +251,11 @@ class Chat(TelegramObject):
         birthdate (:obj:`telegram.Birthdate`, optional): For private chats,
             the date of birth of the user. Returned only in :meth:`telegram.Bot.get_chat`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         personal_chat (:obj:`telegram.Chat`, optional): For private chats, the personal channel of
             the user. Returned only in :meth:`telegram.Bot.get_chat`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
     Attributes:
         id (:obj:`int`): Unique identifier for this chat. This number may be greater than 32 bits
@@ -343,17 +343,17 @@ class Chat(TelegramObject):
             business accounts, the intro of the business. Returned only in
             :meth:`telegram.Bot.get_chat`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         business_location (:class:`telegram.BusinessLocation`): Optional. For private chats with
             business accounts, the location of the business. Returned only in
             :meth:`telegram.Bot.get_chat`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         business_opening_hours (:class:`telegram.BusinessOpeningHours`): Optional. For private
             chats with business accounts, the opening hours of the business. Returned only in
             :meth:`telegram.Bot.get_chat`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         available_reactions (Tuple[:class:`telegram.ReactionType`]): Optional. List of available
             reactions allowed in the chat. If omitted, then all of
             :const:`telegram.constants.ReactionEmoji` are allowed. Returned only in
@@ -417,11 +417,11 @@ class Chat(TelegramObject):
         birthdate (:obj:`telegram.Birthdate`): Optional. For private chats,
             the date of birth of the user. Returned only in :meth:`telegram.Bot.get_chat`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         personal_chat (:obj:`telegram.Chat`): Optional. For private chats, the personal channel of
             the user. Returned only in :meth:`telegram.Bot.get_chat`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
     .. _topics: https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups
     .. _accent colors: https://core.telegram.org/bots/api#accent-colors

telegram/_chatadministratorrights.py

@@ -44,7 +44,7 @@ class ChatAdministratorRights(TelegramObject):
         :attr:`can_post_stories`, :attr:`can_edit_stories`, and :attr:`can_delete_stories` are
         considered as well when comparing objects of this type in terms of equality.
 
-    .. versionchanged:: NEXT.VERSION
+    .. versionchanged:: 21.1
         As of this version, :attr:`can_post_stories`, :attr:`can_edit_stories`,
         and :attr:`can_delete_stories` is now required. Thus, the order of arguments had to be
         changed.

telegram/_chatmember.py

@@ -191,7 +191,7 @@ class ChatMemberAdministrator(ChatMember):
        * The argument :paramref:`can_manage_topics` was added, which changes the position of the
          optional argument :paramref:`custom_title`.
 
-    .. versionchanged:: NEXT.VERSION
+    .. versionchanged:: 21.1
         As of this version, :attr:`can_post_stories`, :attr:`can_edit_stories`,
         and :attr:`can_delete_stories` is now required. Thus, the order of arguments had to be
         changed.

telegram/_files/inputsticker.py

@@ -36,7 +36,7 @@ class InputSticker(TelegramObject):
 
     .. versionadded:: 20.2
 
-    .. versionchanged:: NEXT.VERSION
+    .. versionchanged:: 21.1
         As of Bot API 7.2, the new argument :paramref:`format` is a required argument, and thus the
         order of the arguments has changed.
 
@@ -62,7 +62,7 @@ class InputSticker(TelegramObject):
             for a ``.TGS`` animation, :tg-const:`telegram.constants.StickerFormat.VIDEO` for a WEBM
             video.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
     Attributes:
         sticker (:obj:`str` | :class:`telegram.InputFile`): The added sticker.
@@ -85,7 +85,7 @@ class InputSticker(TelegramObject):
             for a ``.TGS`` animation, :tg-const:`telegram.constants.StickerFormat.VIDEO` for a WEBM
             video.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
     """
 
     __slots__ = ("emoji_list", "format", "keywords", "mask_position", "sticker")

telegram/_files/sticker.py

@@ -230,7 +230,7 @@ class StickerSet(TelegramObject):
         The parameter ``contains_masks`` has been removed. Use :paramref:`sticker_type` instead.
 
 
-    .. versionchanged:: NEXT.VERSION
+    .. versionchanged:: 21.1
         The parameters ``is_video`` and ``is_animated`` are deprecated and now made optional. Thus,
         the order of the arguments had to be changed.
 
@@ -242,13 +242,13 @@ class StickerSet(TelegramObject):
         title (:obj:`str`): Sticker set title.
         is_animated (:obj:`bool`): :obj:`True`, if the sticker set contains animated stickers.
 
-            .. deprecated:: NEXT.VERSION
+            .. deprecated:: 21.1
                 Bot API 7.2 deprecated this field. This parameter will be removed in a future
                 version of the library.
         is_video (:obj:`bool`): :obj:`True`, if the sticker set contains video stickers.
             .. versionadded:: 13.11
 
-            .. deprecated:: NEXT.VERSION
+            .. deprecated:: 21.1
                 Bot API 7.2 deprecated this field. This parameter will be removed in a future
                 version of the library.
         stickers (Sequence[:class:`telegram.Sticker`]): List of all set stickers.
@@ -271,13 +271,13 @@ class StickerSet(TelegramObject):
         title (:obj:`str`): Sticker set title.
         is_animated (:obj:`bool`): :obj:`True`, if the sticker set contains animated stickers.
 
-            .. deprecated:: NEXT.VERSION
+            .. deprecated:: 21.1
                 Bot API 7.2 deprecated this field. This parameter will be removed in a future
                 version of the library.
         is_video (:obj:`bool`): :obj:`True`, if the sticker set contains video stickers.
             .. versionadded:: 13.11
 
-            .. deprecated:: NEXT.VERSION
+            .. deprecated:: 21.1
                 Bot API 7.2 deprecated this field. This parameter will be removed in a future
                 version of the library.
         stickers (Tuple[:class:`telegram.Sticker`]): List of all set stickers.

telegram/_keyboardbuttonrequest.py

@@ -60,13 +60,13 @@ class KeyboardButtonRequestUsers(TelegramObject):
         request_name (:obj:`bool`, optional): Pass :obj:`True` to request the users' first and last
             name.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         request_username (:obj:`bool`, optional): Pass :obj:`True` to request the users' username.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         request_photo (:obj:`bool`, optional): Pass :obj:`True` to request the users' photo.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
     Attributes:
         request_id (:obj:`int`): Identifier of the request.
@@ -85,13 +85,13 @@ class KeyboardButtonRequestUsers(TelegramObject):
         request_name (:obj:`bool`): Optional. Pass :obj:`True` to request the users' first and last
             name.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         request_username (:obj:`bool`): Optional. Pass :obj:`True` to request the users' username.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         request_photo (:obj:`bool`): Optional. Pass :obj:`True` to request the users' photo.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
     """
 
@@ -171,13 +171,13 @@ class KeyboardButtonRequestChat(TelegramObject):
             as a member. Otherwise, no additional restrictions are applied.
         request_title (:obj:`bool`, optional): Pass :obj:`True` to request the chat's title.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         request_username (:obj:`bool`, optional): Pass :obj:`True` to request the chat's username.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         request_photo (:obj:`bool`, optional): Pass :obj:`True` to request the chat's photo.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
     Attributes:
         request_id (:obj:`int`): Identifier of the request.
         chat_is_channel (:obj:`bool`): Pass :obj:`True` to request a channel chat, pass
@@ -201,13 +201,13 @@ class KeyboardButtonRequestChat(TelegramObject):
             as a member. Otherwise, no additional restrictions are applied.
         request_title (:obj:`bool`): Optional. Pass :obj:`True` to request the chat's title.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         request_username (:obj:`bool`): Optional. Pass :obj:`True` to request the chat's username.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         request_photo (:obj:`bool`): Optional. Pass :obj:`True` to request the chat's photo.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
     """
 
     __slots__ = (

telegram/_message.py

@@ -306,7 +306,7 @@ class Message(MaybeInaccessibleMessage):
             by an implicit action, for example, as an away or a greeting business message,
             or as a scheduled message.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         media_group_id (:obj:`str`, optional): The unique identifier of a media message group this
             message belongs to.
         text (:obj:`str`, optional): For text messages, the actual UTF-8 text of the message,
@@ -545,13 +545,13 @@ class Message(MaybeInaccessibleMessage):
             corresponding business account that is independent from any potential bot chat which
             might share the same identifier.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
         sender_business_bot (:obj:`telegram.User`, optional): The bot that actually sent the
             message on behalf of the business account. Available only for outgoing messages sent
             on behalf of the connected business account.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
     Attributes:
         message_id (:obj:`int`): Unique message identifier inside this chat.
@@ -590,7 +590,7 @@ class Message(MaybeInaccessibleMessage):
             by an implicit action, for example, as an away or a greeting business message,
             or as a scheduled message.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         media_group_id (:obj:`str`): Optional. The unique identifier of a media message group this
             message belongs to.
         text (:obj:`str`): Optional. For text messages, the actual UTF-8 text of the message,
@@ -845,13 +845,13 @@ class Message(MaybeInaccessibleMessage):
             corresponding business account that is independent from any potential bot chat which
             might share the same identifier.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
         sender_business_bot (:obj:`telegram.User`): Optional. The bot that actually sent the
             message on behalf of the business account. Available only for outgoing messages sent
             on behalf of the connected business account.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
     .. |custom_emoji_no_md1_support| replace:: Since custom emoji entities are not supported by
        :attr:`~telegram.constants.ParseMode.MARKDOWN`, this method now raises a
@@ -1628,7 +1628,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -1707,7 +1707,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Note:
@@ -1789,7 +1789,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -1867,7 +1867,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -1943,7 +1943,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_media_group`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2021,7 +2021,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_photo`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2103,7 +2103,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_audio`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2186,7 +2186,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_document`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2270,7 +2270,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_animation`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2349,7 +2349,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_sticker`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2429,7 +2429,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_video`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2512,7 +2512,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_video_note`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2590,7 +2590,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_voice`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2670,7 +2670,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_location`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2753,7 +2753,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_venue`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2834,7 +2834,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_contact`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2918,7 +2918,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_poll`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -2998,7 +2998,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_dice`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -3059,7 +3059,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_chat_action`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         .. versionadded:: 13.2
@@ -3111,7 +3111,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_game`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:
@@ -3201,7 +3201,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_invoice`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Warning:
@@ -3412,7 +3412,7 @@ class Message(MaybeInaccessibleMessage):
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.copy_message`.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
                 |reply_same_thread|
 
         Keyword Args:

telegram/_shared.py

@@ -46,7 +46,7 @@ class UsersShared(TelegramObject):
        Bot API 7.0 replaces ``UserShared`` with this class. The only difference is that now
        the :attr:`user_ids` is a sequence instead of a single integer.
 
-    .. versionchanged:: NEXT.VERSION
+    .. versionchanged:: 21.1
        The argument :attr:`users` is now considered for the equality comparison instead of
        :attr:`user_ids`.
 
@@ -55,9 +55,9 @@ class UsersShared(TelegramObject):
         users (Sequence[:class:`telegram.SharedUser`]): Information about users shared with the
             bot.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
-            .. deprecated:: NEXT.VERSION
+            .. deprecated:: 21.1
                 In future versions, this argument will become keyword only.
         user_ids (Sequence[:obj:`int`], optional): Identifiers of the shared users. These numbers
             may have more than 32 significant bits and some programming languages may have
@@ -66,7 +66,7 @@ class UsersShared(TelegramObject):
             identifiers. The bot may not have access to the users and could be unable to use
             these identifiers, unless the users are already known to the bot by some other means.
 
-            .. deprecated:: NEXT.VERSION
+            .. deprecated:: 21.1
                Bot API 7.2 introduced by :paramref:`users`, replacing this argument. Hence, this
                argument is now optional and will be removed in future versions.
 
@@ -75,7 +75,7 @@ class UsersShared(TelegramObject):
         users (Tuple[:class:`telegram.SharedUser`]): Information about users shared with the
             bot.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
     """
 
     __slots__ = ("request_id", "users")
@@ -140,7 +140,7 @@ class UsersShared(TelegramObject):
         bot may not have access to the users and could be unable to use these identifiers,
         unless the users are already known to the bot by some other means.
 
-        .. deprecated:: NEXT.VERSION
+        .. deprecated:: 21.1
             As Bot API 7.2 replaces this attribute with :attr:`users`, this attribute will be
             removed in future versions.
         """
@@ -171,15 +171,15 @@ class ChatShared(TelegramObject):
             float type are safe for storing this identifier.
         title (:obj:`str`, optional): Title of the chat, if the title was requested by the bot.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         username (:obj:`str`, optional): Username of the chat, if the username was requested by
             the bot and available.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         photo (Sequence[:class:`telegram.PhotoSize`], optional): Available sizes of the chat photo,
             if the photo was requested by the bot
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
     Attributes:
         request_id (:obj:`int`): Identifier of the request.
@@ -189,15 +189,15 @@ class ChatShared(TelegramObject):
             float type are safe for storing this identifier.
         title (:obj:`str`): Optional. Title of the chat, if the title was requested by the bot.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         username (:obj:`str`): Optional. Username of the chat, if the username was requested by
             the bot and available.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
         photo (Tuple[:class:`telegram.PhotoSize`]): Optional. Available sizes of the chat photo,
             if the photo was requested by the bot
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
     """
 
     __slots__ = ("chat_id", "photo", "request_id", "title", "username")
@@ -243,7 +243,7 @@ class SharedUser(TelegramObject):
     Objects of this class are comparable in terms of equality. Two objects of this class are
     considered equal, if their :attr:`user_id` is equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
 
     Args:
         user_id (:obj:`int`): Identifier of the shared user. This number may have 32 significant

telegram/_update.py

@@ -139,22 +139,22 @@ class Update(TelegramObject):
             to or disconnected from a business account, or a user edited an existing connection
             with the bot.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
         business_message (:class:`telegram.Message`, optional): New non-service message
             from a connected business account.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
         edited_business_message (:class:`telegram.Message`, optional): New version of a message
             from a connected business account.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
         deleted_business_messages (:class:`telegram.BusinessMessagesDeleted`, optional): Messages
             were deleted from a connected business account.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
 
     Attributes:
@@ -247,22 +247,22 @@ class Update(TelegramObject):
             to or disconnected from a business account, or a user edited an existing connection
             with the bot.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
         business_message (:class:`telegram.Message`): Optional. New non-service message
             from a connected business account.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
         edited_business_message (:class:`telegram.Message`): Optional. New version of a message
             from a connected business account.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
         deleted_business_messages (:class:`telegram.BusinessMessagesDeleted`): Optional. Messages
             were deleted from a connected business account.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
     """
 
     __slots__ = (
@@ -370,19 +370,19 @@ class Update(TelegramObject):
     BUSINESS_CONNECTION: Final[str] = constants.UpdateType.BUSINESS_CONNECTION
     """:const:`telegram.constants.UpdateType.BUSINESS_CONNECTION`
 
-    .. versionadded:: NEXT.VERSION"""
+    .. versionadded:: 21.1"""
     BUSINESS_MESSAGE: Final[str] = constants.UpdateType.BUSINESS_MESSAGE
     """:const:`telegram.constants.UpdateType.BUSINESS_MESSAGE`
 
-    .. versionadded:: NEXT.VERSION"""
+    .. versionadded:: 21.1"""
     EDITED_BUSINESS_MESSAGE: Final[str] = constants.UpdateType.EDITED_BUSINESS_MESSAGE
     """:const:`telegram.constants.UpdateType.EDITED_BUSINESS_MESSAGE`
 
-    .. versionadded:: NEXT.VERSION"""
+    .. versionadded:: 21.1"""
     DELETED_BUSINESS_MESSAGES: Final[str] = constants.UpdateType.DELETED_BUSINESS_MESSAGES
     """:const:`telegram.constants.UpdateType.DELETED_BUSINESS_MESSAGES`
 
-    .. versionadded:: NEXT.VERSION"""
+    .. versionadded:: 21.1"""
     ALL_TYPES: Final[List[str]] = list(constants.UpdateType)
     """List[:obj:`str`]: A list of all available update types.
 
@@ -471,7 +471,7 @@ class Update(TelegramObject):
 
         is present.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
             This property now also considers :attr:`business_connection`, :attr:`business_message`
             and :attr:`edited_business_message`.
 
@@ -563,7 +563,7 @@ class Update(TelegramObject):
             * If :attr:`channel_post` is present, this will give
               :attr:`telegram.Message.sender_chat`.
 
-        .. versionadded:: NEXT.VERSION
+        .. versionadded:: 21.1
         """
         if self._effective_sender:
             return self._effective_sender
@@ -603,7 +603,7 @@ class Update(TelegramObject):
         :attr:`shipping_query`, :attr:`pre_checkout_query`, :attr:`poll`,
         :attr:`poll_answer`, or :attr:`business_connection` is present.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
             This property now also considers :attr:`business_message`,
             :attr:`edited_business_message`, and :attr:`deleted_business_messages`.
 
@@ -673,7 +673,7 @@ class Update(TelegramObject):
             :attr:`callback_query` (i.e. :attr:`telegram.CallbackQuery.message`) or :obj:`None`, if
             none of those are present.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
             This property now also considers :attr:`business_message`, and
             :attr:`edited_business_message`.
 

telegram/_user.py

@@ -95,7 +95,7 @@ class User(TelegramObject):
             to a Telegram Business account to receive its messages. Returned only in
             :meth:`telegram.Bot.get_me`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
 
     Attributes:
         id (:obj:`int`): Unique identifier for this user or bot.
@@ -122,7 +122,7 @@ class User(TelegramObject):
             to a Telegram Business account to receive its messages. Returned only in
             :meth:`telegram.Bot.get_me`.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 21.1
     .. |user_chat_id_note| replace:: This shortcuts build on the assumption that :attr:`User.id`
         coincides with the :attr:`Chat.id` of the private chat with the user. This has been the
         case so far, but Telegram does not guarantee that this stays this way.

telegram/_version.py

@@ -51,7 +51,7 @@ class Version(NamedTuple):
 
 
 __version_info__: Final[Version] = Version(
-    major=21, minor=0, micro=1, releaselevel="final", serial=0
+    major=21, minor=1, micro=0, releaselevel="final", serial=0
 )
 __version__: Final[str] = str(__version_info__)
 

telegram/constants.py

@@ -1717,7 +1717,7 @@ class MessageType(StringEnum):
     BUSINESS_CONNECTION_ID = "business_connection_id"
     """:obj:`str`: Messages with :attr:`telegram.Message.business_connection_id`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
     """
     CHANNEL_CHAT_CREATED = "channel_chat_created"
     """:obj:`str`: Messages with :attr:`telegram.Message.channel_chat_created`."""
@@ -1829,7 +1829,7 @@ class MessageType(StringEnum):
     SENDER_BUSINESS_BOT = "sender_business_bot"
     """:obj:`str`: Messages with :attr:`telegram.Message.sender_business_bot`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
     """
     STICKER = "sticker"
     """:obj:`str`: Messages with :attr:`telegram.Message.sticker`."""
@@ -2327,7 +2327,7 @@ class StickerSetLimit(IntEnum):
     """:obj:`int`: Maximum number of stickers allowed in an animated or video sticker set, as given
     in :meth:`telegram.Bot.add_sticker_to_set`.
 
-    .. deprecated:: NEXT.VERSION
+    .. deprecated:: 21.1
         The animated sticker limit is now 120, the same as :attr:`MAX_STATIC_STICKERS`.
     """
     MAX_STATIC_STICKERS = 120
@@ -2524,22 +2524,22 @@ class UpdateType(StringEnum):
     BUSINESS_CONNECTION = "business_connection"
     """:obj:`str`: Updates with :attr:`telegram.Update.business_connection`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
     """
     BUSINESS_MESSAGE = "business_message"
     """:obj:`str`: Updates with :attr:`telegram.Update.business_message`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
     """
     EDITED_BUSINESS_MESSAGE = "edited_business_message"
     """:obj:`str`: Updates with :attr:`telegram.Update.edited_business_message`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
     """
     DELETED_BUSINESS_MESSAGES = "deleted_business_messages"
     """:obj:`str`: Updates with :attr:`telegram.Update.deleted_business_messages`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
     """
 
 

telegram/ext/_application.py

@@ -980,7 +980,7 @@ class Application(Generic[BT, CCT, UD, CD, BD, JQ], AsyncContextManager["Applica
                     appropriate :paramref:`webhook_url`.
 
                 .. versionadded:: 20.8
-                .. versionchanged:: NEXT.VERSION
+                .. versionchanged:: 21.1
                     Added support to pass a socket instance itself.
         """
         if not self.updater:

telegram/ext/_handlers/businessconnectionhandler.py

@@ -33,7 +33,7 @@ class BusinessConnectionHandler(BaseHandler[Update, CCT]):
     """Handler class to handle Telegram
     :attr:`Business Connections <telegram.Update.business_connection>`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
 
     Args:
         callback (:term:`coroutine function`): The callback function for this handler. Will be

telegram/ext/_handlers/businessmessagesdeletedhandler.py

@@ -33,7 +33,7 @@ class BusinessMessagesDeletedHandler(BaseHandler[Update, CCT]):
     """Handler class to handle
     :attr:`deleted Telegram Business messages <telegram.Update.deleted_business_messages>`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
 
     Args:
         callback (:term:`coroutine function`): The callback function for this handler. Will be

telegram/ext/_updater.py

@@ -562,7 +562,7 @@ class Updater(AsyncContextManager["Updater"]):
                     appropriate :paramref:`webhook_url`.
 
                 .. versionadded:: 20.8
-                .. versionchanged:: NEXT.VERSION
+                .. versionchanged:: 21.1
                     Added support to pass a socket instance itself.
         Returns:
             :class:`queue.Queue`: The update queue that can be filled from the main thread.

telegram/ext/filters.py

@@ -273,7 +273,7 @@ class BaseFilter:
     def check_update(self, update: Update) -> Optional[Union[bool, FilterDataDict]]:
         """Checks if the specified update should be handled by this filter.
 
-        .. versionchanged:: NEXT.VERSION
+        .. versionchanged:: 21.1
             This filter now also returns :obj:`True` if the update contains
             :attr:`~telegram.Update.business_message`
             or :attr:`~telegram.Update.edited_business_message`.
@@ -1573,7 +1573,7 @@ class _IsFromOffline(MessageFilter):
 IS_FROM_OFFLINE = _IsFromOffline(name="filters.IS_FROM_OFFLINE")
 """Messages that contain :attr:`telegram.Message.is_from_offline`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
 """
 
 
@@ -2522,7 +2522,7 @@ class UpdateType:
 
     .. versionadded:: 20.0
 
-    .. versionchanged:: NEXT.VERSION
+    .. versionchanged:: 21.1
         Added :attr:`telegram.Update.edited_business_message` to the filter.
     """
 
@@ -2573,7 +2573,7 @@ class UpdateType:
     BUSINESS_MESSAGE = _BusinessMessage(name="filters.UpdateType.BUSINESS_MESSAGE")
     """Updates with :attr:`telegram.Update.business_message`.
 
-    .. versionadded:: NEXT.VERSION"""
+    .. versionadded:: 21.1"""
 
     class _EditedBusinessMessage(UpdateFilter):
         __slots__ = ()
@@ -2586,7 +2586,7 @@ class UpdateType:
     )
     """Updates with :attr:`telegram.Update.edited_business_message`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
     """
 
     class _BusinessMessages(UpdateFilter):
@@ -2601,7 +2601,7 @@ class UpdateType:
     """Updates with either :attr:`telegram.Update.business_message` or
     :attr:`telegram.Update.edited_business_message`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 21.1
     """