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-10-23 17:36:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

Bump version to v21.2

Browse source
This commit is contained in:
Hinrich Mahler 2024-05-20 17:23:38 +02:00
parent 512a0b7417
commit 6fc45a803d
28 changed files with 188 additions and 136 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

52
CHANGES.rst
View file

@ -4,6 +4,58 @@
Changelog Changelog
========= =========
Version 21.2
============
*Released 2024-05-20*
This is the technical changelog for version 21.2. More elaborate release notes can be found in the news channel `@pythontelegrambotchannel <https://t.me/pythontelegrambotchannel>`_.
Major Changes
-------------
- Full Support for Bot API 7.3 (:pr:`4246`, :pr:`4260`, :pr:`4243`, :pr:`4248`, :pr:`4242` closes :issue:`4236`, :pr:`4247` by `aelkheir <https://github.com/aelkheir>`_)
- Remove Functionality Deprecated by Bot API 7.2 (:pr:`4245`)
New Features
------------
- Add Version to ``PTBDeprecationWarning`` (:pr:`4262` closes :issue:`4261`)
- Handle Exceptions in building ``CallbackContext`` (:pr:`4222`)
Bug Fixes
---------
- Call ``Application.post_stop`` Only if ``Application.stop`` was called (:pr:`4211` closes :issue:`4210`)
- Handle ``SystemExit`` raised in Handlers (:pr:`4157` closes :issue:`4155` and :issue:`4156`)
- Make ``Birthdate.to_date`` Return a ``datetime.date`` Object (:pr:`4251`)
Documentation Improvements
--------------------------
- Documentation Improvements (:pr:`4217`)
Internal Changes
----------------
- Add New Rules to ``ruff`` Config (:pr:`4250`)
- Adapt Test Suite to Changes in Error Messages (:pr:`4238`)
Dependency Updates
------------------
- Bump ``furo`` from 2024.4.27 to 2024.5.6 (:pr:`4252`)
- ``pre-commit`` autoupdate (:pr:`4239`)
- Bump ``pytest`` from 8.1.1 to 8.2.0 (:pr:`4231`)
- Bump ``dependabot/fetch-metadata`` from 2.0.0 to 2.1.0 (:pr:`4228`)
- Bump ``pytest-asyncio`` from 0.21.1 to 0.21.2 (:pr:`4232`)
- Bump ``pytest-xdist`` from 3.6.0 to 3.6.1 (:pr:`4233`)
- Bump ``furo`` from 2024.1.29 to 2024.4.27 (:pr:`4230`)
- Bump ``srvaroa/labeler`` from 1.10.0 to 1.10.1 (:pr:`4227`)
- Bump ``pytest`` from 7.4.4 to 8.1.1 (:pr:`4218`)
- Bump ``sphinx`` from 7.2.6 to 7.3.7 (:pr:`4215`)
- Bump ``pytest-xdist`` from 3.5.0 to 3.6.0 (:pr:`4215`)
Version 21.1.1 Version 21.1.1
============== ==============

4
docs/source/conf.py
View file

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

2
docs/source/telegram.backgroundfill.rst
View file

@ -1,7 +1,7 @@
BackgroundFill BackgroundFill
============== ==============
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
.. autoclass:: telegram.BackgroundFill .. autoclass:: telegram.BackgroundFill
:members: :members:

2
docs/source/telegram.backgroundfillfreeformgradient.rst
View file

@ -1,7 +1,7 @@
BackgroundFillFreeformGradient BackgroundFillFreeformGradient
============================== ==============================
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
.. autoclass:: telegram.BackgroundFillFreeformGradient .. autoclass:: telegram.BackgroundFillFreeformGradient
:members: :members:

2
docs/source/telegram.backgroundfillgradient.rst
View file

@ -1,7 +1,7 @@
BackgroundFillGradient BackgroundFillGradient
====================== ======================
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
.. autoclass:: telegram.BackgroundFillGradient .. autoclass:: telegram.BackgroundFillGradient
:members: :members:

2
docs/source/telegram.backgroundfillsolid.rst
View file

@ -1,7 +1,7 @@
BackgroundFillSolid BackgroundFillSolid
=================== ===================
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
.. autoclass:: telegram.BackgroundFillSolid .. autoclass:: telegram.BackgroundFillSolid
:members: :members:

2
docs/source/telegram.backgroundtype.rst
View file

@ -1,7 +1,7 @@
BackgroundType BackgroundType
============== ==============
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
.. autoclass:: telegram.BackgroundType .. autoclass:: telegram.BackgroundType
:members: :members:

2
docs/source/telegram.backgroundtypechattheme.rst
View file

@ -1,7 +1,7 @@
BackgroundTypeChatTheme BackgroundTypeChatTheme
======================= =======================
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
.. autoclass:: telegram.BackgroundTypeChatTheme .. autoclass:: telegram.BackgroundTypeChatTheme
:members: :members:

2
docs/source/telegram.backgroundtypefill.rst
View file

@ -1,7 +1,7 @@
BackgroundTypeFill BackgroundTypeFill
================== ==================
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
.. autoclass:: telegram.BackgroundTypeFill .. autoclass:: telegram.BackgroundTypeFill
:members: :members:

2
docs/source/telegram.backgroundtypepattern.rst
View file

@ -1,7 +1,7 @@
BackgroundTypePattern BackgroundTypePattern
===================== =====================
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
.. autoclass:: telegram.BackgroundTypePattern .. autoclass:: telegram.BackgroundTypePattern
:members: :members:

2
docs/source/telegram.backgroundtypewallpaper.rst
View file

@ -1,7 +1,7 @@
BackgroundTypeWallpaper BackgroundTypeWallpaper
======================= =======================
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
.. autoclass:: telegram.BackgroundTypeWallpaper .. autoclass:: telegram.BackgroundTypeWallpaper
:members: :members:

2
docs/source/telegram.chatbackground.rst
View file

@ -1,7 +1,7 @@
ChatBackground ChatBackground
============== ==============
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
.. autoclass:: telegram.ChatBackground .. autoclass:: telegram.ChatBackground
:members: :members:

2
telegram/_birthdate.py
View file

@ -73,7 +73,7 @@ class Birthdate(TelegramObject):
def to_date(self, year: Optional[int] = None) -> date: def to_date(self, year: Optional[int] = None) -> date:
"""Return the birthdate as a date object. """Return the birthdate as a date object.
.. versionchanged:: NEXT.VERSION .. versionchanged:: 21.2
Now returns a :obj:`datetime.date` object instead of a :obj:`datetime.datetime` object, Now returns a :obj:`datetime.date` object instead of a :obj:`datetime.datetime` object,
as was originally intended. as was originally intended.

12
telegram/_bot.py
View file

@ -2772,7 +2772,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
date must remain within the next 90 days. If not specified, then ``live_period`` date must remain within the next 90 days. If not specified, then ``live_period``
remains unchanged remains unchanged
.. versionadded:: NEXT.VERSION. .. versionadded:: 21.2.
Keyword Args: Keyword Args:
location (:class:`telegram.Location`, optional): The location to send. location (:class:`telegram.Location`, optional): The location to send.
@ -4457,7 +4457,7 @@ class Bot(TelegramObject, AsyncContextManager["Bot"]):
Use this method to get up to date information about the chat (current name of the user for Use this method to get up to date information about the chat (current name of the user for
one-on-one conversations, current username of a user, group or channel, etc.). one-on-one conversations, current username of a user, group or channel, etc.).
.. versionchanged:: NEXT.VERSION .. versionchanged:: 21.2
In accordance to Bot API 7.3, this method now returns a :class:`telegram.ChatFullInfo`. In accordance to Bot API 7.3, this method now returns a :class:`telegram.ChatFullInfo`.
Args: Args:
@ -6360,7 +6360,7 @@ CUSTOM_EMOJI_IDENTIFIER_LIMIT` custom emoji identifiers can be specified.
Removed the deprecated parameters mentioned above and adjusted the order of the Removed the deprecated parameters mentioned above and adjusted the order of the
parameters. parameters.
.. versionremoved:: NEXT.VERSION .. versionremoved:: 21.2
Removed the deprecated parameter ``sticker_format``. Removed the deprecated parameter ``sticker_format``.
Args: Args:
@ -6867,7 +6867,7 @@ CUSTOM_EMOJI_IDENTIFIER_LIMIT` custom emoji identifiers can be specified.
.. versionchanged:: 20.0 .. versionchanged:: 20.0
|sequenceargs| |sequenceargs|
.. versionchanged:: NEXT.VERSION .. versionchanged:: 21.2
Bot API 7.3 adds support for :class:`~telegram.InputPollOption` objects. Bot API 7.3 adds support for :class:`~telegram.InputPollOption` objects.
is_anonymous (:obj:`bool`, optional): :obj:`True`, if the poll needs to be anonymous, is_anonymous (:obj:`bool`, optional): :obj:`True`, if the poll needs to be anonymous,
defaults to :obj:`True`. defaults to :obj:`True`.
@ -6927,12 +6927,12 @@ CUSTOM_EMOJI_IDENTIFIER_LIMIT` custom emoji identifiers can be specified.
See the constants in :class:`telegram.constants.ParseMode` for the available modes. See the constants in :class:`telegram.constants.ParseMode` for the available modes.
Currently, only custom emoji entities are allowed. Currently, only custom emoji entities are allowed.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
question_entities (Sequence[:class:`telegram.Message`], optional): Special entities question_entities (Sequence[:class:`telegram.Message`], optional): Special entities
that appear in the poll :paramref:`question`. It can be specified instead of that appear in the poll :paramref:`question`. It can be specified instead of
:paramref:`question_parse_mode`. :paramref:`question_parse_mode`.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Keyword Args: Keyword Args:
allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply| allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|

144
telegram/_chat.py
View file

@ -150,13 +150,13 @@ class Chat(TelegramObject):
photo (:class:`telegram.ChatPhoto`, optional): Chat photo. photo (:class:`telegram.ChatPhoto`, optional): Chat photo.
Returned only in :meth:`telegram.Bot.get_chat`. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
bio (:obj:`str`, optional): Bio of the other party in a private chat. Returned only in bio (:obj:`str`, optional): Bio of the other party in a private chat. Returned only in
:meth:`telegram.Bot.get_chat`. :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_private_forwards (:obj:`bool`, optional): :obj:`True`, if privacy settings of the other has_private_forwards (:obj:`bool`, optional): :obj:`True`, if privacy settings of the other
@ -165,38 +165,38 @@ class Chat(TelegramObject):
.. versionadded:: 13.9 .. versionadded:: 13.9
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
description (:obj:`str`, optional): Description, for groups, supergroups and channel chats. description (:obj:`str`, optional): Description, for groups, supergroups and channel chats.
Returned only in :meth:`telegram.Bot.get_chat`. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
invite_link (:obj:`str`, optional): Primary invite link, for groups, supergroups and invite_link (:obj:`str`, optional): Primary invite link, for groups, supergroups and
channel. Returned only in :meth:`telegram.Bot.get_chat`. channel. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
pinned_message (:class:`telegram.Message`, optional): The most recent pinned message pinned_message (:class:`telegram.Message`, optional): The most recent pinned message
(by sending date). Returned only in :meth:`telegram.Bot.get_chat`. (by sending date). Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
permissions (:class:`telegram.ChatPermissions`): Optional. Default chat member permissions, permissions (:class:`telegram.ChatPermissions`): Optional. Default chat member permissions,
for groups and supergroups. Returned only in :meth:`telegram.Bot.get_chat`. for groups and supergroups. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
slow_mode_delay (:obj:`int`, optional): For supergroups, the minimum allowed delay between slow_mode_delay (:obj:`int`, optional): For supergroups, the minimum allowed delay between
consecutive messages sent by each unprivileged user. consecutive messages sent by each unprivileged user.
Returned only in :meth:`telegram.Bot.get_chat`. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
message_auto_delete_time (:obj:`int`, optional): The time after which all messages sent to message_auto_delete_time (:obj:`int`, optional): The time after which all messages sent to
@ -205,7 +205,7 @@ class Chat(TelegramObject):
.. versionadded:: 13.4 .. versionadded:: 13.4
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_protected_content (:obj:`bool`, optional): :obj:`True`, if messages from the chat can't has_protected_content (:obj:`bool`, optional): :obj:`True`, if messages from the chat can't
@ -213,7 +213,7 @@ class Chat(TelegramObject):
.. versionadded:: 13.9 .. versionadded:: 13.9
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_visible_history (:obj:`bool`, optional): :obj:`True`, if new chat members will have has_visible_history (:obj:`bool`, optional): :obj:`True`, if new chat members will have
@ -222,32 +222,32 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
sticker_set_name (:obj:`str`, optional): For supergroups, name of group sticker set. sticker_set_name (:obj:`str`, optional): For supergroups, name of group sticker set.
Returned only in :meth:`telegram.Bot.get_chat`. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
can_set_sticker_set (:obj:`bool`, optional): :obj:`True`, if the bot can change group the can_set_sticker_set (:obj:`bool`, optional): :obj:`True`, if the bot can change group the
sticker set. Returned only in :meth:`telegram.Bot.get_chat`. sticker set. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
linked_chat_id (:obj:`int`, optional): Unique identifier for the linked chat, i.e. the linked_chat_id (:obj:`int`, optional): Unique identifier for the linked chat, i.e. the
discussion group identifier for a channel and vice versa; for supergroups and channel discussion group identifier for a channel and vice versa; for supergroups and channel
chats. Returned only in :meth:`telegram.Bot.get_chat`. chats. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
location (:class:`telegram.ChatLocation`, optional): For supergroups, the location to which location (:class:`telegram.ChatLocation`, optional): For supergroups, the location to which
the supergroup is connected. Returned only in :meth:`telegram.Bot.get_chat`. the supergroup is connected. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
join_to_send_messages (:obj:`bool`, optional): :obj:`True`, if users need to join the join_to_send_messages (:obj:`bool`, optional): :obj:`True`, if users need to join the
@ -256,7 +256,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
join_by_request (:obj:`bool`, optional): :obj:`True`, if all users directly joining the join_by_request (:obj:`bool`, optional): :obj:`True`, if all users directly joining the
@ -265,7 +265,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_restricted_voice_and_video_messages (:obj:`bool`, optional): :obj:`True`, if the has_restricted_voice_and_video_messages (:obj:`bool`, optional): :obj:`True`, if the
@ -274,7 +274,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
is_forum (:obj:`bool`, optional): :obj:`True`, if the supergroup chat is a forum is_forum (:obj:`bool`, optional): :obj:`True`, if the supergroup chat is a forum
@ -288,7 +288,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
business_intro (:class:`telegram.BusinessIntro`, optional): For private chats with business_intro (:class:`telegram.BusinessIntro`, optional): For private chats with
@ -297,7 +297,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.1 .. versionadded:: 21.1
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
business_location (:class:`telegram.BusinessLocation`, optional): For private chats with business_location (:class:`telegram.BusinessLocation`, optional): For private chats with
@ -306,7 +306,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.1 .. versionadded:: 21.1
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
business_opening_hours (:class:`telegram.BusinessOpeningHours`, optional): For private business_opening_hours (:class:`telegram.BusinessOpeningHours`, optional): For private
@ -315,7 +315,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.1 .. versionadded:: 21.1
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
available_reactions (Sequence[:class:`telegram.ReactionType`], optional): List of available available_reactions (Sequence[:class:`telegram.ReactionType`], optional): List of available
@ -325,7 +325,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
accent_color_id (:obj:`int`, optional): Identifier of the accent_color_id (:obj:`int`, optional): Identifier of the
@ -336,7 +336,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
background_custom_emoji_id (:obj:`str`, optional): Custom emoji identifier of emoji chosen background_custom_emoji_id (:obj:`str`, optional): Custom emoji identifier of emoji chosen
@ -345,7 +345,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
profile_accent_color_id (:obj:`int`, optional): Identifier of the profile_accent_color_id (:obj:`int`, optional): Identifier of the
@ -355,7 +355,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
profile_background_custom_emoji_id (:obj:`str`, optional): Custom emoji identifier of profile_background_custom_emoji_id (:obj:`str`, optional): Custom emoji identifier of
@ -364,7 +364,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
emoji_status_custom_emoji_id (:obj:`str`, optional): Custom emoji identifier of emoji emoji_status_custom_emoji_id (:obj:`str`, optional): Custom emoji identifier of emoji
@ -373,7 +373,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
emoji_status_expiration_date (:class:`datetime.datetime`, optional): Expiration date of emoji_status_expiration_date (:class:`datetime.datetime`, optional): Expiration date of
@ -383,7 +383,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.5 .. versionadded:: 20.5
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_aggressive_anti_spam_enabled (:obj:`bool`, optional): :obj:`True`, if aggressive has_aggressive_anti_spam_enabled (:obj:`bool`, optional): :obj:`True`, if aggressive
@ -392,7 +392,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_hidden_members (:obj:`bool`, optional): :obj:`True`, if non-administrators can only has_hidden_members (:obj:`bool`, optional): :obj:`True`, if non-administrators can only
@ -401,7 +401,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
unrestrict_boost_count (:obj:`int`, optional): For supergroups, the minimum number of unrestrict_boost_count (:obj:`int`, optional): For supergroups, the minimum number of
@ -410,7 +410,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.0 .. versionadded:: 21.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
custom_emoji_sticker_set_name (:obj:`str`, optional): For supergroups, the name of the custom_emoji_sticker_set_name (:obj:`str`, optional): For supergroups, the name of the
@ -419,7 +419,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.0 .. versionadded:: 21.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
birthdate (:obj:`telegram.Birthdate`, optional): For private chats, birthdate (:obj:`telegram.Birthdate`, optional): For private chats,
@ -427,7 +427,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.1 .. versionadded:: 21.1
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
personal_chat (:obj:`telegram.Chat`, optional): For private chats, the personal channel of personal_chat (:obj:`telegram.Chat`, optional): For private chats, the personal channel of
@ -435,7 +435,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.1 .. versionadded:: 21.1
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
@ -454,13 +454,13 @@ class Chat(TelegramObject):
photo (:class:`telegram.ChatPhoto`): Optional. Chat photo. photo (:class:`telegram.ChatPhoto`): Optional. Chat photo.
Returned only in :meth:`telegram.Bot.get_chat`. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
bio (:obj:`str`): Optional. Bio of the other party in a private chat. Returned only in bio (:obj:`str`): Optional. Bio of the other party in a private chat. Returned only in
:meth:`telegram.Bot.get_chat`. :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_private_forwards (:obj:`bool`): Optional. :obj:`True`, if privacy settings of the other has_private_forwards (:obj:`bool`): Optional. :obj:`True`, if privacy settings of the other
@ -469,38 +469,38 @@ class Chat(TelegramObject):
.. versionadded:: 13.9 .. versionadded:: 13.9
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
description (:obj:`str`): Optional. Description, for groups, supergroups and channel chats. description (:obj:`str`): Optional. Description, for groups, supergroups and channel chats.
Returned only in :meth:`telegram.Bot.get_chat`. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
invite_link (:obj:`str`): Optional. Primary invite link, for groups, supergroups and invite_link (:obj:`str`): Optional. Primary invite link, for groups, supergroups and
channel. Returned only in :meth:`telegram.Bot.get_chat`. channel. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
pinned_message (:class:`telegram.Message`): Optional. The most recent pinned message pinned_message (:class:`telegram.Message`): Optional. The most recent pinned message
(by sending date). Returned only in :meth:`telegram.Bot.get_chat`. (by sending date). Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
permissions (:class:`telegram.ChatPermissions`): Optional. Default chat member permissions, permissions (:class:`telegram.ChatPermissions`): Optional. Default chat member permissions,
for groups and supergroups. Returned only in :meth:`telegram.Bot.get_chat`. for groups and supergroups. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
slow_mode_delay (:obj:`int`): Optional. For supergroups, the minimum allowed delay between slow_mode_delay (:obj:`int`): Optional. For supergroups, the minimum allowed delay between
consecutive messages sent by each unprivileged user. Returned only in consecutive messages sent by each unprivileged user. Returned only in
:meth:`telegram.Bot.get_chat`. :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
message_auto_delete_time (:obj:`int`): Optional. The time after which all messages sent to message_auto_delete_time (:obj:`int`): Optional. The time after which all messages sent to
@ -509,7 +509,7 @@ class Chat(TelegramObject):
.. versionadded:: 13.4 .. versionadded:: 13.4
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_protected_content (:obj:`bool`): Optional. :obj:`True`, if messages from the chat can't has_protected_content (:obj:`bool`): Optional. :obj:`True`, if messages from the chat can't
@ -517,7 +517,7 @@ class Chat(TelegramObject):
.. versionadded:: 13.9 .. versionadded:: 13.9
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_visible_history (:obj:`bool`): Optional. :obj:`True`, if new chat members will have has_visible_history (:obj:`bool`): Optional. :obj:`True`, if new chat members will have
@ -526,32 +526,32 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
sticker_set_name (:obj:`str`): Optional. For supergroups, name of Group sticker set. sticker_set_name (:obj:`str`): Optional. For supergroups, name of Group sticker set.
Returned only in :meth:`telegram.Bot.get_chat`. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
can_set_sticker_set (:obj:`bool`): Optional. :obj:`True`, if the bot can change group the can_set_sticker_set (:obj:`bool`): Optional. :obj:`True`, if the bot can change group the
sticker set. Returned only in :meth:`telegram.Bot.get_chat`. sticker set. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
linked_chat_id (:obj:`int`): Optional. Unique identifier for the linked chat, i.e. the linked_chat_id (:obj:`int`): Optional. Unique identifier for the linked chat, i.e. the
discussion group identifier for a channel and vice versa; for supergroups and channel discussion group identifier for a channel and vice versa; for supergroups and channel
chats. Returned only in :meth:`telegram.Bot.get_chat`. chats. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
location (:class:`telegram.ChatLocation`): Optional. For supergroups, the location to which location (:class:`telegram.ChatLocation`): Optional. For supergroups, the location to which
the supergroup is connected. Returned only in :meth:`telegram.Bot.get_chat`. the supergroup is connected. Returned only in :meth:`telegram.Bot.get_chat`.
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
join_to_send_messages (:obj:`bool`): Optional. :obj:`True`, if users need to join join_to_send_messages (:obj:`bool`): Optional. :obj:`True`, if users need to join
@ -560,7 +560,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
join_by_request (:obj:`bool`): Optional. :obj:`True`, if all users directly joining the join_by_request (:obj:`bool`): Optional. :obj:`True`, if all users directly joining the
@ -569,7 +569,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_restricted_voice_and_video_messages (:obj:`bool`): Optional. :obj:`True`, if the has_restricted_voice_and_video_messages (:obj:`bool`): Optional. :obj:`True`, if the
@ -578,7 +578,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
is_forum (:obj:`bool`): Optional. :obj:`True`, if the supergroup chat is a forum is_forum (:obj:`bool`): Optional. :obj:`True`, if the supergroup chat is a forum
@ -594,7 +594,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
business_intro (:class:`telegram.BusinessIntro`): Optional. For private chats with business_intro (:class:`telegram.BusinessIntro`): Optional. For private chats with
@ -603,7 +603,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.1 .. versionadded:: 21.1
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
business_location (:class:`telegram.BusinessLocation`): Optional. For private chats with business_location (:class:`telegram.BusinessLocation`): Optional. For private chats with
@ -612,7 +612,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.1 .. versionadded:: 21.1
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
business_opening_hours (:class:`telegram.BusinessOpeningHours`): Optional. For private business_opening_hours (:class:`telegram.BusinessOpeningHours`): Optional. For private
@ -621,7 +621,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.1 .. versionadded:: 21.1
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
available_reactions (Tuple[:class:`telegram.ReactionType`]): Optional. List of available available_reactions (Tuple[:class:`telegram.ReactionType`]): Optional. List of available
@ -631,7 +631,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
accent_color_id (:obj:`int`): Optional. Identifier of the accent_color_id (:obj:`int`): Optional. Identifier of the
@ -642,7 +642,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
background_custom_emoji_id (:obj:`str`): Optional. Custom emoji identifier of emoji chosen background_custom_emoji_id (:obj:`str`): Optional. Custom emoji identifier of emoji chosen
@ -651,7 +651,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
profile_accent_color_id (:obj:`int`): Optional. Identifier of the profile_accent_color_id (:obj:`int`): Optional. Identifier of the
@ -661,7 +661,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
profile_background_custom_emoji_id (:obj:`str`): Optional. Custom emoji identifier of profile_background_custom_emoji_id (:obj:`str`): Optional. Custom emoji identifier of
@ -670,7 +670,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.8 .. versionadded:: 20.8
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
emoji_status_custom_emoji_id (:obj:`str`): Optional. Custom emoji identifier of emoji emoji_status_custom_emoji_id (:obj:`str`): Optional. Custom emoji identifier of emoji
@ -679,7 +679,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
emoji_status_expiration_date (:class:`datetime.datetime`): Optional. Expiration date of emoji_status_expiration_date (:class:`datetime.datetime`): Optional. Expiration date of
@ -689,7 +689,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.5 .. versionadded:: 20.5
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_aggressive_anti_spam_enabled (:obj:`bool`): Optional. :obj:`True`, if aggressive has_aggressive_anti_spam_enabled (:obj:`bool`): Optional. :obj:`True`, if aggressive
@ -698,7 +698,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
has_hidden_members (:obj:`bool`): Optional. :obj:`True`, if non-administrators can only has_hidden_members (:obj:`bool`): Optional. :obj:`True`, if non-administrators can only
@ -707,7 +707,7 @@ class Chat(TelegramObject):
.. versionadded:: 20.0 .. versionadded:: 20.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
unrestrict_boost_count (:obj:`int`): Optional. For supergroups, the minimum number of unrestrict_boost_count (:obj:`int`): Optional. For supergroups, the minimum number of
@ -716,7 +716,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.0 .. versionadded:: 21.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
custom_emoji_sticker_set_name (:obj:`str`): Optional. For supergroups, the name of the custom_emoji_sticker_set_name (:obj:`str`): Optional. For supergroups, the name of the
@ -725,7 +725,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.0 .. versionadded:: 21.0
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
birthdate (:obj:`telegram.Birthdate`): Optional. For private chats, birthdate (:obj:`telegram.Birthdate`): Optional. For private chats,
@ -733,7 +733,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.1 .. versionadded:: 21.1
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
personal_chat (:obj:`telegram.Chat`): Optional. For private chats, the personal channel of personal_chat (:obj:`telegram.Chat`): Optional. For private chats, the personal channel of
@ -741,7 +741,7 @@ class Chat(TelegramObject):
.. versionadded:: 21.1 .. versionadded:: 21.1
.. deprecated:: NEXT.VERSION .. deprecated:: 21.2
In accordance to Bot API 7.3, this attribute will be moved to In accordance to Bot API 7.3, this attribute will be moved to
:class:`telegram.ChatFullInfo`. :class:`telegram.ChatFullInfo`.
@ -911,7 +911,7 @@ class Chat(TelegramObject):
if (val := object.__getattribute__(self, arg)) is not None and val != (): if (val := object.__getattribute__(self, arg)) is not None and val != ():
warn( warn(
PTBDeprecationWarning( PTBDeprecationWarning(
"NEXT.VERSION", "21.2",
f"The argument `{arg}` is deprecated and will only be available via " f"The argument `{arg}` is deprecated and will only be available via "
"`ChatFullInfo` in the future.", "`ChatFullInfo` in the future.",
), ),
@ -926,7 +926,7 @@ class Chat(TelegramObject):
if name in _deprecated_attrs and self.__class__ is Chat: if name in _deprecated_attrs and self.__class__ is Chat:
warn( warn(
PTBDeprecationWarning( PTBDeprecationWarning(
"NEXT.VERSION", "21.2",
f"The attribute `{name}` is deprecated and will only be accessible via " f"The attribute `{name}` is deprecated and will only be accessible via "
"`ChatFullInfo` in the future.", "`ChatFullInfo` in the future.",
), ),

20
telegram/_chatbackground.py
View file

@ -40,7 +40,7 @@ class BackgroundFill(TelegramObject):
Objects of this class are comparable in terms of equality. Two objects of this class are Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`type` is equal. considered equal, if their :attr:`type` is equal.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
type (:obj:`str`): Type of the background fill. Can be one of: type (:obj:`str`): Type of the background fill. Can be one of:
@ -104,7 +104,7 @@ class BackgroundFillSolid(BackgroundFill):
Objects of this class are comparable in terms of equality. Two objects of this class are Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`color` is equal. considered equal, if their :attr:`color` is equal.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
color (:obj:`int`): The color of the background fill in the `RGB24` format. color (:obj:`int`): The color of the background fill in the `RGB24` format.
@ -139,7 +139,7 @@ class BackgroundFillGradient(BackgroundFill):
considered equal, if their :attr:`top_color`, :attr:`bottom_color` considered equal, if their :attr:`top_color`, :attr:`bottom_color`
and :attr:`rotation_angle` are equal. and :attr:`rotation_angle` are equal.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
top_color (:obj:`int`): Top color of the gradient in the `RGB24` format. top_color (:obj:`int`): Top color of the gradient in the `RGB24` format.
@ -186,7 +186,7 @@ class BackgroundFillFreeformGradient(BackgroundFill):
Objects of this class are comparable in terms of equality. Two objects of this class are Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`colors` is equal. considered equal, if their :attr:`colors` is equal.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
colors (Sequence[:obj:`int`]): A list of the 3 or 4 base colors that are used to colors (Sequence[:obj:`int`]): A list of the 3 or 4 base colors that are used to
@ -226,7 +226,7 @@ class BackgroundType(TelegramObject):
Objects of this class are comparable in terms of equality. Two objects of this class are Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`type` is equal. considered equal, if their :attr:`type` is equal.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
type (:obj:`str`): Type of the background. Can be one of: type (:obj:`str`): Type of the background. Can be one of:
@ -300,7 +300,7 @@ class BackgroundTypeFill(BackgroundType):
Objects of this class are comparable in terms of equality. Two objects of this class are Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`fill` and :attr:`dark_theme_dimming` are equal. considered equal, if their :attr:`fill` and :attr:`dark_theme_dimming` are equal.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
fill (:obj:`telegram.BackgroundFill`): The background fill. fill (:obj:`telegram.BackgroundFill`): The background fill.
@ -342,7 +342,7 @@ class BackgroundTypeWallpaper(BackgroundType):
Objects of this class are comparable in terms of equality. Two objects of this class are Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`document` and :attr:`dark_theme_dimming` are equal. considered equal, if their :attr:`document` and :attr:`dark_theme_dimming` are equal.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
document (:obj:`telegram.Document`): Document with the wallpaper document (:obj:`telegram.Document`): Document with the wallpaper
@ -400,7 +400,7 @@ class BackgroundTypePattern(BackgroundType):
Objects of this class are comparable in terms of equality. Two objects of this class are Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`document` and :attr:`fill` and :attr:`intensity` are equal. considered equal, if their :attr:`document` and :attr:`fill` and :attr:`intensity` are equal.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
document (:obj:`telegram.Document`): Document with the pattern. document (:obj:`telegram.Document`): Document with the pattern.
@ -470,7 +470,7 @@ class BackgroundTypeChatTheme(BackgroundType):
Objects of this class are comparable in terms of equality. Two objects of this class are Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`theme_name` is equal. considered equal, if their :attr:`theme_name` is equal.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
theme_name (:obj:`str`): Name of the chat theme, which is usually an emoji. theme_name (:obj:`str`): Name of the chat theme, which is usually an emoji.
@ -504,7 +504,7 @@ class ChatBackground(TelegramObject):
Objects of this class are comparable in terms of equality. Two objects of this class are Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`type` is equal. considered equal, if their :attr:`type` is equal.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
type (:obj:`telegram.BackgroundType`): Type of the background. type (:obj:`telegram.BackgroundType`): Type of the background.

6
telegram/_chatfullinfo.py
View file

@ -48,19 +48,19 @@ class ChatFullInfo(Chat):
.. seealso:: .. seealso::
All arguments and attributes can be found in :class:`telegram.Chat`. All arguments and attributes can be found in :class:`telegram.Chat`.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
max_reaction_count (:obj:`int`): The maximum number of reactions that can be set on a max_reaction_count (:obj:`int`): The maximum number of reactions that can be set on a
message in the chat. message in the chat.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Attributes: Attributes:
max_reaction_count (:obj:`int`): The maximum number of reactions that can be set on a max_reaction_count (:obj:`int`): The maximum number of reactions that can be set on a
message in the chat. message in the chat.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
__slots__ = ("max_reaction_count",) __slots__ = ("max_reaction_count",)

4
telegram/_chatmemberupdated.py
View file

@ -67,7 +67,7 @@ class ChatMemberUpdated(TelegramObject):
sending a direct join request without using an invite link and being approved by sending a direct join request without using an invite link and being approved by
an administrator an administrator
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Attributes: Attributes:
chat (:class:`telegram.Chat`): Chat the user belongs to. chat (:class:`telegram.Chat`): Chat the user belongs to.
@ -89,7 +89,7 @@ class ChatMemberUpdated(TelegramObject):
sending a direct join request without using an invite link and being approved sending a direct join request without using an invite link and being approved
by an administrator by an administrator
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """

2
telegram/_files/sticker.py
View file

@ -235,7 +235,7 @@ class StickerSet(TelegramObject):
.. versionchanged:: 20.5 .. versionchanged:: 20.5
|removed_thumb_note| |removed_thumb_note|
.. versionremoved:: NEXT.VERSION .. versionremoved:: 21.2
Removed the deprecated arguments and attributes ``is_animated`` and ``is_video``. Removed the deprecated arguments and attributes ``is_animated`` and ``is_video``.
Args: Args:

4
telegram/_message.py
View file

@ -559,7 +559,7 @@ class Message(MaybeInaccessibleMessage):
chat_background_set (:obj:`telegram.ChatBackground`, optional): Service message: chat chat_background_set (:obj:`telegram.ChatBackground`, optional): Service message: chat
background set. background set.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Attributes: Attributes:
message_id (:obj:`int`): Unique message identifier inside this chat. message_id (:obj:`int`): Unique message identifier inside this chat.
@ -864,7 +864,7 @@ class Message(MaybeInaccessibleMessage):
chat_background_set (:obj:`telegram.ChatBackground`): Optional. Service message: chat chat_background_set (:obj:`telegram.ChatBackground`): Optional. Service message: chat
background set background set
.. versionadded:: Next.Version .. versionadded:: 21.2
.. |custom_emoji_no_md1_support| replace:: Since custom emoji entities are not supported by .. |custom_emoji_no_md1_support| replace:: Since custom emoji entities are not supported by
:attr:`~telegram.constants.ParseMode.MARKDOWN`, this method now raises a :attr:`~telegram.constants.ParseMode.MARKDOWN`, this method now raises a

18
telegram/_poll.py
View file

@ -43,7 +43,7 @@ class InputPollOption(TelegramObject):
Objects of this class are comparable in terms of equality. Two objects of this class are Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`text` is equal. considered equal, if their :attr:`text` is equal.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
text (:obj:`str`): Option text, text (:obj:`str`): Option text,
@ -118,7 +118,7 @@ class PollOption(TelegramObject):
that appear in the option text. Currently, only custom emoji entities are allowed in that appear in the option text. Currently, only custom emoji entities are allowed in
poll option texts. poll option texts.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Attributes: Attributes:
text (:obj:`str`): Option text, text (:obj:`str`): Option text,
@ -130,7 +130,7 @@ class PollOption(TelegramObject):
poll option texts. poll option texts.
This list is empty if the question does not contain entities. This list is empty if the question does not contain entities.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
@ -174,7 +174,7 @@ class PollOption(TelegramObject):
UTF-16 codepoint pairs, which some versions of Python don't handle automatically. UTF-16 codepoint pairs, which some versions of Python don't handle automatically.
(That is, you can't just slice ``Message.text`` with the offset and length.) (That is, you can't just slice ``Message.text`` with the offset and length.)
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
entity (:class:`telegram.MessageEntity`): The entity to extract the text from. It must entity (:class:`telegram.MessageEntity`): The entity to extract the text from. It must
@ -196,7 +196,7 @@ class PollOption(TelegramObject):
attribute, since it calculates the correct substring from the message text based on attribute, since it calculates the correct substring from the message text based on
UTF-16 codepoints. See :attr:`parse_entity` for more info. UTF-16 codepoints. See :attr:`parse_entity` for more info.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Args: Args:
types (List[:obj:`str`], optional): List of ``MessageEntity`` types as strings. If the types (List[:obj:`str`], optional): List of ``MessageEntity`` types as strings. If the
@ -362,7 +362,7 @@ class Poll(TelegramObject):
that appear in the :attr:`question`. Currently, only custom emoji entities are allowed that appear in the :attr:`question`. Currently, only custom emoji entities are allowed
in poll questions. in poll questions.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Attributes: Attributes:
id (:obj:`str`): Unique poll identifier. id (:obj:`str`): Unique poll identifier.
@ -404,7 +404,7 @@ class Poll(TelegramObject):
in poll questions. in poll questions.
This list is empty if the question does not contain entities. This list is empty if the question does not contain entities.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
@ -544,7 +544,7 @@ class Poll(TelegramObject):
"""Returns the text in :attr:`question` from a given :class:`telegram.MessageEntity` of """Returns the text in :attr:`question` from a given :class:`telegram.MessageEntity` of
:attr:`question_entities`. :attr:`question_entities`.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Note: Note:
This method is present because Telegram calculates the offset and length in This method is present because Telegram calculates the offset and length in
@ -568,7 +568,7 @@ class Poll(TelegramObject):
It contains entities from this polls question filtered by their ``type`` attribute as It contains entities from this polls question filtered by their ``type`` attribute as
the key, and the text that each entity belongs to as the value of the :obj:`dict`. the key, and the text that each entity belongs to as the value of the :obj:`dict`.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Note: Note:
This method should always be used instead of the :attr:`question_entities` This method should always be used instead of the :attr:`question_entities`

4
telegram/_shared.py
View file

@ -44,7 +44,7 @@ class UsersShared(TelegramObject):
The argument :attr:`users` is now considered for the equality comparison instead of The argument :attr:`users` is now considered for the equality comparison instead of
``user_ids``. ``user_ids``.
.. versionremoved:: NEXT.VERSION .. versionremoved:: 21.2
Removed the deprecated argument and attribute ``user_ids``. Removed the deprecated argument and attribute ``user_ids``.
Args: Args:
@ -54,7 +54,7 @@ class UsersShared(TelegramObject):
.. versionadded:: 21.1 .. versionadded:: 21.1
.. versionchanged:: NEXT.VERSION .. versionchanged:: 21.2
This argument is now required. This argument is now required.
Attributes: Attributes:

2
telegram/_utils/warnings.py
View file

@ -45,7 +45,7 @@ def warn(
message (:obj:`str` | :obj:`PTBUserWarning`): Specify the warnings message to pass to message (:obj:`str` | :obj:`PTBUserWarning`): Specify the warnings message to pass to
``warnings.warn()``. ``warnings.warn()``.
.. versionchanged:: NEXT.VERSION .. versionchanged:: 21.2
Now also accepts a :obj:`PTBUserWarning` instance. Now also accepts a :obj:`PTBUserWarning` instance.
category (:obj:`Type[Warning]`, optional): Specify the Warning class to pass to category (:obj:`Type[Warning]`, optional): Specify the Warning class to pass to

2
telegram/_version.py
View file

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

12
telegram/constants.py
View file

@ -831,7 +831,7 @@ class BackgroundTypeLimit(IntEnum):
:class:`telegram.BackgroundTypeWallpaper` and :class:`telegram.BackgroundTypePattern`. :class:`telegram.BackgroundTypeWallpaper` and :class:`telegram.BackgroundTypePattern`.
The enum members of this enumeration are instances of :class:`int` and can be treated as such. The enum members of this enumeration are instances of :class:`int` and can be treated as such.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
__slots__ = () __slots__ = ()
@ -854,7 +854,7 @@ class BackgroundFillLimit(IntEnum):
"""This enum contains limitations for :class:`telegram.BackgroundFillGradient`. """This enum contains limitations for :class:`telegram.BackgroundFillGradient`.
The enum members of this enumeration are instances of :class:`int` and can be treated as such. The enum members of this enumeration are instances of :class:`int` and can be treated as such.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
__slots__ = () __slots__ = ()
@ -1483,7 +1483,7 @@ class LocationLimit(IntEnum):
* :paramref:`~telegram.Bot.send_location.live_period` parameter of * :paramref:`~telegram.Bot.send_location.live_period` parameter of
:meth:`telegram.Bot.send_location` :meth:`telegram.Bot.send_location`
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
MIN_PROXIMITY_ALERT_RADIUS = 1 MIN_PROXIMITY_ALERT_RADIUS = 1
@ -1788,7 +1788,7 @@ class MessageType(StringEnum):
CHAT_BACKGROUND_SET = "chat_background_set" CHAT_BACKGROUND_SET = "chat_background_set"
""":obj:`str`: Messages with :attr:`telegram.Message.chat_background_set`. """:obj:`str`: Messages with :attr:`telegram.Message.chat_background_set`.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
CONNECTED_WEBSITE = "connected_website" CONNECTED_WEBSITE = "connected_website"
""":obj:`str`: Messages with :attr:`telegram.Message.connected_website`.""" """:obj:`str`: Messages with :attr:`telegram.Message.connected_website`."""
@ -2948,7 +2948,7 @@ class BackgroundTypeType(StringEnum):
"""This enum contains the available types of :class:`telegram.BackgroundType`. The enum """This enum contains the available types of :class:`telegram.BackgroundType`. The enum
members of this enumeration are instances of :class:`str` and can be treated as such. members of this enumeration are instances of :class:`str` and can be treated as such.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
__slots__ = () __slots__ = ()
@ -2967,7 +2967,7 @@ class BackgroundFillType(StringEnum):
"""This enum contains the available types of :class:`telegram.BackgroundFill`. The enum """This enum contains the available types of :class:`telegram.BackgroundFill`. The enum
members of this enumeration are instances of :class:`str` and can be treated as such. members of this enumeration are instances of :class:`str` and can be treated as such.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
__slots__ = () __slots__ = ()

2
telegram/ext/_application.py
View file

@ -733,7 +733,7 @@ class Application(Generic[BT, CCT, UD, CD, BD, JQ], AsyncContextManager["Applica
.. versionadded:: 20.5 .. versionadded:: 20.5
.. versionchanged:: NEXT.VERSION .. versionchanged:: 21.2
Added support for calling within :meth:`post_init`. Added support for calling within :meth:`post_init`.
""" """
if self.running: if self.running:

4
telegram/ext/_defaults.py
View file

@ -273,7 +273,7 @@ class Defaults:
""":obj:`str`: Optional. Alias for :attr:`parse_mode`, used for """:obj:`str`: Optional. Alias for :attr:`parse_mode`, used for
the corresponding parameter of :class:`telegram.InputPollOption`. the corresponding parameter of :class:`telegram.InputPollOption`.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
return self._parse_mode return self._parse_mode
@ -288,7 +288,7 @@ class Defaults:
""":obj:`str`: Optional. Alias for :attr:`parse_mode`, used for """:obj:`str`: Optional. Alias for :attr:`parse_mode`, used for
the corresponding parameter of :meth:`telegram.Bot.send_poll`. the corresponding parameter of :meth:`telegram.Bot.send_poll`.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
return self._parse_mode return self._parse_mode

10
telegram/warnings.py
View file

@ -58,18 +58,18 @@ class PTBDeprecationWarning(PTBUserWarning, DeprecationWarning):
Args: Args:
version (:obj:`str`): The version in which the feature was deprecated. version (:obj:`str`): The version in which the feature was deprecated.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
message (:obj:`str`): The message to display. message (:obj:`str`): The message to display.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
Attributes: Attributes:
version (:obj:`str`): The version in which the feature was deprecated. version (:obj:`str`): The version in which the feature was deprecated.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
message (:obj:`str`): The message to display. message (:obj:`str`): The message to display.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
__slots__ = ("message", "version") __slots__ = ("message", "version")
@ -82,6 +82,6 @@ class PTBDeprecationWarning(PTBUserWarning, DeprecationWarning):
"""Returns a string representation of the warning, using :attr:`message` and """Returns a string representation of the warning, using :attr:`message` and
:attr:`version`. :attr:`version`.
.. versionadded:: NEXT.VERSION .. versionadded:: 21.2
""" """
return f"Deprecated since version {self.version}: {self.message}" return f"Deprecated since version {self.version}: {self.message}"