OpenSource/python-telegram-bot
OpenSource/python-telegram-bot
1
0
Fork 0
mirror of https://github.com/python-telegram-bot/python-telegram-bot.git synced 2024-12-22 06:25:12 +01:00
Code Issues Projects Releases Packages Wiki Activity

Bump version to v21.1

Browse source
This commit is contained in:
Hinrich Mahler 2024-04-12 12:39:38 +02:00
parent 153894728c
commit f6d009d3ac
22 changed files with 182 additions and 140 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

42
CHANGES.rst
View file

@ -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
==============

4
docs/source/conf.py
View file

@ -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"

2
telegram/_birthdate.py
View file

@ -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.

44
telegram/_bot.py
View file

@ -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.

12
telegram/_business.py
View file

@ -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

20
telegram/_chat.py
View file

@ -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

2
telegram/_chatadministratorrights.py
View file

@ -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.

2
telegram/_chatmember.py
View file

@ -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.

6
telegram/_files/inputsticker.py
View file

@ -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")

10
telegram/_files/sticker.py
View file

@ -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.

24
telegram/_keyboardbuttonrequest.py
View file

@ -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__ = (

56
telegram/_message.py
View file

@ -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:

26
telegram/_shared.py
View file

@ -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

32
telegram/_update.py
View file

@ -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`.

4
telegram/_user.py
View file

@ -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.

2
telegram/_version.py
View file

@ -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__)

14
telegram/constants.py
View file

@ -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
"""

2
telegram/ext/_application.py
View file

@ -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:

2
telegram/ext/_handlers/businessconnectionhandler.py
View file

@ -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

2
telegram/ext/_handlers/businessmessagesdeletedhandler.py
View file

@ -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

2
telegram/ext/_updater.py
View file

@ -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.

12
telegram/ext/filters.py
View file

@ -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
"""