Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions README.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
dummy change for chango debug

.. image:: https://raw.githubusercontent.com/python-telegram-bot/logos/master/logo-text/png/ptb-logo-text_768.png
:align: center
:target: https://python-telegram-bot.org
Expand Down
5 changes: 5 additions & 0 deletions changes/22.6_2026-01-24/5108.CUt49oxmPxDZ3BPhDDCAm5.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
other = "Bump Version to v22.6"
[[pull_requests]]
uid = "5108"
author_uids = ["Bibo-Joshi"]
closes_threads = []
24 changes: 12 additions & 12 deletions src/telegram/_bot.py
Original file line number Diff line number Diff line change
Expand Up @@ -1219,7 +1219,7 @@ async def send_message_draft(
"""Use this method to stream a partial message to a user while the message is being
generated; supported only for bots with forum topic mode enabled.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Args:
chat_id (:obj:`int`): Unique identifier for the target private chat.
Expand Down Expand Up @@ -1366,7 +1366,7 @@ async def forward_message(
message_effect_id (:obj:`str`, optional): Unique identifier of the message effect to be
added to the message; only available when forwarding to private chats

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Returns:
:class:`telegram.Message`: On success, the sent Message is returned.
Expand Down Expand Up @@ -8484,7 +8484,7 @@ async def copy_message(
message_effect_id (:obj:`str`, optional): Unique identifier of the message effect to be
added to the message; only available when copying to private chats

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Keyword Args:
allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
Expand Down Expand Up @@ -9942,7 +9942,7 @@ async def get_business_account_gifts(
exclude_unsaved: bool | None = None,
exclude_saved: bool | None = None,
exclude_unlimited: bool | None = None,
# tags: deprecated NEXT.VERSION; bot api 9.3
# tags: deprecated 22.6; bot api 9.3
exclude_limited: bool | None = None,
exclude_unique: bool | None = None,
sort_by_price: bool | None = None,
Expand Down Expand Up @@ -9975,25 +9975,25 @@ async def get_business_account_gifts(
exclude_limited (:obj:`bool`, optional): Pass :obj:`True` to exclude gifts that can be
purchased a limited number of times.

.. deprecated:: NEXT.VERSION
.. deprecated:: 22.6
Bot API 9.3 deprecated this parameter in favor of
:paramref:`exclude_limited_upgradabale` and
:paramref:`exclude_limited_non_upgradable`.
exclude_limited_upgradable (:obj:`bool`, optional): Pass :obj:`True` to exclude gifts
that can be purchased a limited number of times and can be upgraded to unique.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
exclude_limited_non_upgradable (:obj:`bool`, optional): Pass :obj:`True` to exclude
gifts that can be purchased a limited number of times and can't be upgraded to
unique

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
exclude_unique (:obj:`bool`, optional): Pass :obj:`True` to exclude unique gifts.
exclude_from_blockchain (:obj:`bool`, optional): Pass :obj:`True` to exclude gifts
that were assigned from the TON blockchain and can't be resold or transferred in
Telegram.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
sort_by_price (:obj:`bool`, optional): Pass :obj:`True` to sort results by gift price
instead of send date. Sorting is applied before pagination.
offset (:obj:`str`, optional): Offset of the first entry to return as received from
Expand All @@ -10012,7 +10012,7 @@ async def get_business_account_gifts(
if exclude_limited is not None:
self._warn(
PTBDeprecationWarning(
version="NEXT.VERSION",
version="22.6",
message=build_deprecation_warning_message(
deprecated_name="exclude_limited",
new_name="exclude_limited_(non_)upgradable",
Expand Down Expand Up @@ -11717,7 +11717,7 @@ async def repost_story(
:attr:`~telegram.BusinessBotRight.can_manage_stories` business bot right for both
business accounts.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Args:
business_connection_id (:obj:`str`): Unique identifier of the business
Expand Down Expand Up @@ -11782,7 +11782,7 @@ async def get_user_gifts(
) -> OwnedGifts:
"""Returns the gifts owned and hosted by a user.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

user_id (:obj:`int`): Unique identifier of the user
exclude_unlimited (:obj:`bool`, optional): Pass :obj:`True` to exclude gifts that can be
Expand Down Expand Up @@ -11854,7 +11854,7 @@ async def get_chat_gifts(
) -> OwnedGifts:
"""Use this method to get gifts owned by a chat.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Args:
chat_id (:obj:`int` | :obj:`str`): |chat_id_channel|
Expand Down
4 changes: 2 additions & 2 deletions src/telegram/_chat.py
Original file line number Diff line number Diff line change
Expand Up @@ -3925,7 +3925,7 @@ async def repost_story(

For the documentation of the arguments, please see :meth:`telegram.Bot.repost_story`.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Returns:
:class:`Story`: On success, :class:`Story` is returned.
Expand Down Expand Up @@ -3971,7 +3971,7 @@ async def get_gifts(
For the documentation of the arguments, please see
:meth:`telegram.Bot.get_chat_gifts`.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Returns:
:class:`telegram.OwnedGifts`: On success, returns the gifts owned by the chat.
Expand Down
12 changes: 6 additions & 6 deletions src/telegram/_chatfullinfo.py
Original file line number Diff line number Diff line change
Expand Up @@ -237,16 +237,16 @@ class ChatFullInfo(_ChatBase):
rating (:class:`telegram.UserRating`, optional): For private chats, the rating of the user
if any.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
unique_gift_colors (:class:`telegram.UniqueGiftColors`, optional): The color scheme based
on a unique gift that must be used for the chat's name, message replies and link
previews

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
paid_message_star_count (:obj:`int`, optional): The number of Telegram Stars a general user
have to pay to send a message to the chat

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Attributes:
id (:obj:`int`): Unique identifier for this chat.
Expand Down Expand Up @@ -422,16 +422,16 @@ class ChatFullInfo(_ChatBase):
rating (:class:`telegram.UserRating`): Optional. For private chats, the rating of the user
if any.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
unique_gift_colors (:class:`telegram.UniqueGiftColors`): Optional. The color scheme based
on a unique gift that must be used for the chat's name, message replies and link
previews

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
paid_message_star_count (:obj:`int`): Optional. The number of Telegram Stars a general user
have to pay to send a message to the chat

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

.. _accent colors: https://core.telegram.org/bots/api#accent-colors
.. _topics: https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups
Expand Down
4 changes: 2 additions & 2 deletions src/telegram/_checklists.py
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ class ChecklistTask(TelegramObject):
completed_by_chat (:class:`telegram.Chat`, optional): Chat that completed the task; omitted
if the task wasn't completed by a chat

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
completion_date (:class:`datetime.datetime`, optional): Point in time when
the task was completed; :attr:`~telegram.constants.ZERO_DATE` if the task wasn't
completed
Expand All @@ -72,7 +72,7 @@ class ChecklistTask(TelegramObject):
completed_by_chat (:class:`telegram.Chat`): Optional. Chat that completed the task; omitted
if the task wasn't completed by a chat

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
completion_date (:class:`datetime.datetime`): Optional. Point in time when
the task was completed; :attr:`~telegram.constants.ZERO_DATE` if the task wasn't
completed
Expand Down
8 changes: 4 additions & 4 deletions src/telegram/_forumtopic.py
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ class ForumTopic(TelegramObject):
is_name_implicit (:obj:`bool`, optional): :obj:`True`, if the name of the topic wasn't
specified explicitly by its creator and likely needs to be changed by the bot.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Attributes:
message_thread_id (:obj:`int`): Unique identifier of the forum topic
Expand All @@ -52,7 +52,7 @@ class ForumTopic(TelegramObject):
is_name_implicit (:obj:`bool`): Optional. :obj:`True`, if the name of the topic wasn't
specified explicitly by its creator and likely needs to be changed by the bot.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
"""

__slots__ = (
Expand Down Expand Up @@ -103,7 +103,7 @@ class ForumTopicCreated(TelegramObject):
is_name_implicit (:obj:`bool`, optional): :obj:`True`, if the name of the topic wasn't
specified explicitly by its creator and likely needs to be changed by the bot.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Attributes:
name (:obj:`str`): Name of the topic
Expand All @@ -113,7 +113,7 @@ class ForumTopicCreated(TelegramObject):
is_name_implicit (:obj:`bool`): Optional. :obj:`True`, if the name of the topic wasn't
specified explicitly by its creator and likely needs to be changed by the bot.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
"""

__slots__ = ("icon_color", "icon_custom_emoji_id", "is_name_implicit", "name")
Expand Down
40 changes: 20 additions & 20 deletions src/telegram/_gifts.py
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ class GiftBackground(TelegramObject):
considered equal if their :attr:`center_color`, :attr:`edge_color` and :attr:`text_color` are
equal.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Args:
center_color (:obj:`int`): Center color of the background in RGB format.
Expand Down Expand Up @@ -111,26 +111,26 @@ class Gift(TelegramObject):
personal_total_count (:obj:`int`, optional): The total number of gifts of this type that
can be sent by the bot; for limited gifts only.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
personal_remaining_count (:obj:`int`, optional): The number of remaining gifts of this type
that can be sent by the bot; for limited gifts only.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
background (:class:`GiftBackground`, optional): Background of the gift.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
is_premium (:obj:`bool`, optional): :obj:`True`, if the gift can only be purchased by
Telegram Premium subscribers.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
has_colors (:obj:`bool`, optional): :obj:`True`, if the gift can be used (after being
upgraded) to customize a user's appearance.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
unique_gift_variant_count (:obj:`int`, optional): The total number of different unique
gifts that can be obtained by upgrading the gift.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Attributes:
id (:obj:`str`): Unique identifier of the gift.
Expand All @@ -152,26 +152,26 @@ class Gift(TelegramObject):
personal_total_count (:obj:`int`): Optional. The total number of gifts of this type that
can be sent by the bot; for limited gifts only.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
personal_remaining_count (:obj:`int`): Optional. The number of remaining gifts of this type
that can be sent by the bot; for limited gifts only.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
background (:class:`GiftBackground`): Optional. Background of the gift.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
is_premium (:obj:`bool`): Optional. :obj:`True`, if the gift can only be purchased by
Telegram Premium subscribers.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
has_colors (:obj:`bool`): Optional. :obj:`True`, if the gift can be used (after being
upgraded) to customize a user's appearance.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
unique_gift_variant_count (:obj:`int`): Optional. The total number of different unique
gifts that can be obtained by upgrading the gift.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

"""

Expand Down Expand Up @@ -306,11 +306,11 @@ class GiftInfo(TelegramObject):
is_upgrade_separate (:obj:`bool`, optional): :obj:`True`, if the gift's upgrade was
purchased after the gift was sent.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
unique_gift_number (:obj:`int`, optional): Unique number reserved for this gift when
upgraded. See the number field in :class:`~telegram.UniqueGift`.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Attributes:
gift (:class:`Gift`): Information about the gift.
Expand All @@ -331,11 +331,11 @@ class GiftInfo(TelegramObject):
is_upgrade_separate (:obj:`bool`): Optional. :obj:`True`, if the gift's upgrade was
purchased after the gift was sent.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
unique_gift_number (:obj:`int`): Optional. Unique number reserved for this gift when
upgraded. See the number field in :class:`~telegram.UniqueGift`.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

"""

Expand Down Expand Up @@ -458,7 +458,7 @@ class AcceptedGiftTypes(TelegramObject):
:attr:`unique_gifts`, :attr:`premium_subscription` and :attr:`gifts_from_channels` are equal.

.. versionadded:: 22.1
.. versionchanged:: NEXT.VERSION
.. versionchanged:: 22.6
:attr:`gifts_from_channels` is now considered for equality checks.

Args:
Expand All @@ -471,7 +471,7 @@ class AcceptedGiftTypes(TelegramObject):
gifts_from_channels (:obj:`bool`): :obj:`True`, if transfers of unique gifts from channels
are accepted

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Attributes:
unlimited_gifts (:class:`bool`): :obj:`True`, if unlimited regular gifts are accepted.
Expand All @@ -483,7 +483,7 @@ class AcceptedGiftTypes(TelegramObject):
gifts_from_channels (:obj:`bool`): :obj:`True`, if transfers of unique gifts from channels
are accepted

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

"""

Expand Down
6 changes: 3 additions & 3 deletions src/telegram/_message.py
Original file line number Diff line number Diff line change
Expand Up @@ -561,7 +561,7 @@ class Message(MaybeInaccessibleMessage):
gift_upgrade_sent (:class:`telegram.GiftInfo`, optional): Service message: upgrade of a
gift was purchased after the gift was sent

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
giveaway_created (:class:`telegram.GiveawayCreated`, optional): Service message: a
scheduled giveaway was created

Expand Down Expand Up @@ -964,7 +964,7 @@ class Message(MaybeInaccessibleMessage):
gift_upgrade_sent (:class:`telegram.GiftInfo`): Optional. Service message: upgrade of a
gift was purchased after the gift was sent

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6
giveaway_created (:class:`telegram.GiveawayCreated`): Optional. Service message: a
scheduled giveaway was created

Expand Down Expand Up @@ -2117,7 +2117,7 @@ async def reply_text_draft(
Note:
|reply_same_thread|

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.6

Returns:
:obj:`bool`: On success, :obj:`True` is returned.
Expand Down
Loading
Loading