Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

API 7.3: ChatFullInfo, Readmes #4242

Merged
merged 9 commits into from
May 12, 2024
Merged

API 7.3: ChatFullInfo, Readmes #4242

Show file tree
Hide file tree
Changes from 8 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
ac9543b
Add the ChatFullInfo class and adjust tests
harshil21 May 8, 2024
0ebe6e8
Bump bot api version number
harshil21 May 8, 2024
6a5b3b8
Review: Make ChatFullInfo a subclass of Chat
harshil21 May 10, 2024
92f9edd
Update test_official to add Chat attributes to exception
harshil21 May 10, 2024
32b91d8
Revert unintentional change to readme_raw.rst
harshil21 May 10, 2024
c67c213
fix doc build
harshil21 May 10, 2024
6858efa
forgot to add back one test
harshil21 May 10, 2024
1dcd0cb
Review: warn depr args on Chat creation & sort CFI args
harshil21 May 11, 2024
ff632a7
Use `is` for comparison instead of `==`
harshil21 May 12, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
:target: https://pypi.org/project/python-telegram-bot/
:alt: Supported Python versions

.. image:: https://img.shields.io/badge/Bot%20API-7.2-blue?logo=telegram
.. image:: https://img.shields.io/badge/Bot%20API-7.3-blue?logo=telegram
:target: https://core.telegram.org/bots/api-changelog
:alt: Supported Bot API versions

Expand Down Expand Up @@ -89,7 +89,7 @@ Installing both ``python-telegram-bot`` and ``python-telegram-bot-raw`` in conju
Telegram API support
====================

All types and methods of the Telegram Bot API **7.2** are supported.
All types and methods of the Telegram Bot API **7.3** are supported.

Installing
==========
Expand Down
4 changes: 2 additions & 2 deletions README_RAW.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
:target: https://pypi.org/project/python-telegram-bot-raw/
:alt: Supported Python versions

.. image:: https://img.shields.io/badge/Bot%20API-7.2-blue?logo=telegram
.. image:: https://img.shields.io/badge/Bot%20API-7.3-blue?logo=telegram
:target: https://core.telegram.org/bots/api-changelog
:alt: Supported Bot API versions

Expand Down Expand Up @@ -85,7 +85,7 @@ Installing both ``python-telegram-bot`` and ``python-telegram-bot-raw`` in conju
Telegram API support
====================

All types and methods of the Telegram Bot API **7.2** are supported.
All types and methods of the Telegram Bot API **7.3** are supported.

Installing
==========
Expand Down
1 change: 1 addition & 0 deletions docs/source/telegram.at-tree.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@ Available Types
telegram.chatboostsourcegiveaway
telegram.chatboostsourcepremium
telegram.chatboostupdated
telegram.chatfullinfo
telegram.chatinvitelink
telegram.chatjoinrequest
telegram.chatlocation
Expand Down
6 changes: 6 additions & 0 deletions docs/source/telegram.chatfullinfo.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
ChatFullInfo
============

.. autoclass:: telegram.ChatFullInfo
:members:
:show-inheritance:
2 changes: 2 additions & 0 deletions telegram/__init__.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@
"ChatBoostSourceGiveaway",
"ChatBoostSourcePremium",
"ChatBoostUpdated",
"ChatFullInfo",
"ChatInviteLink",
"ChatJoinRequest",
"ChatLocation",
Expand Down Expand Up @@ -269,6 +270,7 @@
ChatBoostUpdated,
UserChatBoosts,
)
from ._chatfullinfo import ChatFullInfo
from ._chatinvitelink import ChatInviteLink
from ._chatjoinrequest import ChatJoinRequest
from ._chatlocation import ChatLocation
Expand Down
11 changes: 7 additions & 4 deletions telegram/_bot.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,9 +58,9 @@
from telegram._botdescription import BotDescription, BotShortDescription
from telegram._botname import BotName
from telegram._business import BusinessConnection
from telegram._chat import Chat
from telegram._chatadministratorrights import ChatAdministratorRights
from telegram._chatboost import UserChatBoosts
from telegram._chatfullinfo import ChatFullInfo
from telegram._chatinvitelink import ChatInviteLink
from telegram._chatmember import ChatMember
from telegram._chatpermissions import ChatPermissions
Expand Down Expand Up @@ -4434,16 +4434,19 @@ async def get_chat(
connect_timeout: ODVInput[float] = DEFAULT_NONE,
pool_timeout: ODVInput[float] = DEFAULT_NONE,
api_kwargs: Optional[JSONDict] = None,
) -> Chat:
) -> ChatFullInfo:
"""
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.).

.. versionchanged:: NEXT.VERSION
In accordance to Bot API 7.3, this method now returns a :class:`telegram.ChatFullInfo`.

Args:
chat_id (:obj:`int` | :obj:`str`): |chat_id_channel|

Returns:
:class:`telegram.Chat`
:class:`telegram.ChatFullInfo`

Raises:
:class:`telegram.error.TelegramError`
Expand All @@ -4461,7 +4464,7 @@ async def get_chat(
api_kwargs=api_kwargs,
)

return Chat.de_json(result, self) # type: ignore[return-value]
return ChatFullInfo.de_json(result, self) # type: ignore[return-value]

async def get_chat_administrators(
self,
Expand Down