feat: Bot API 10.0

Author: KurimuzonAkuma

compiler/docs/compiler.py

@@ -266,6 +266,7 @@ def get_title_list(s: str) -> list:
             get_messages
             get_scheduled_messages
             get_stickers
+            get_user_personal_chat_messages
             get_web_app_link_url
             get_web_app_url
             mark_checklist_tasks_as_done
@@ -328,7 +329,8 @@ def get_title_list(s: str) -> list:
             set_administrator_title
             set_chat_photo
             delete_chat_photo
-            delete_chat_reactions_by_sender
+            delete_message_reaction
+            delete_all_message_reactions
             set_chat_title
             set_chat_description
             set_chat_direct_messages_group
@@ -512,8 +514,11 @@ def get_title_list(s: str) -> list:
         Bots
             get_inline_bot_results
             send_inline_bot_result
+            get_managed_bot_access_settings
+            set_managed_bot_access_settings
             send_invoice
             answer_callback_query
+            answer_guest_query
             answer_inline_query
             request_callback_answer
             send_game
@@ -716,6 +721,7 @@ def get_title_list(s: str) -> list:
             MessageOriginUser
             MessageOrigin
             Photo
+            LivePhoto
             PollOptionAdded
             PollOptionDeleted
             Thumbnail
@@ -864,6 +870,7 @@ def get_title_list(s: str) -> list:
             ReplyKeyboardMarkup
             KeyboardButton
             ReplyKeyboardRemove
+            SentGuestMessage
             InlineKeyboardMarkup
             InlineKeyboardButton
             LoginUrl
@@ -896,6 +903,7 @@ def get_title_list(s: str) -> list:
         """,
         bot_commands="""
         Bot commands
+            BotAccessSettings
             BotCommand
             BotCommandScope
             BotCommandScopeDefault
@@ -924,12 +932,18 @@ def get_title_list(s: str) -> list:
             InputMediaAnimation
             InputMediaAudio
             InputMediaDocument
+            InputMediaLocation
+            InputMediaVenue
             InputMediaPhoto
+            InputMediaLivePhoto
             InputMediaVideo
             InputMediaSticker
             InputMessageContent
             InputPhoneContact
             InputPollOption
+            InputPollMedia
+            InputPollOptionMedia
+            InputPollOption
             InputPrivacyRule
             InputPrivacyRuleAllowAll
             InputPrivacyRuleAllowBots

pyrogram/dispatcher.py

@@ -80,6 +80,7 @@
     UpdateNewChannelMessage,
     UpdateNewMessage,
     UpdateNewScheduledMessage,
+    UpdateBotGuestChatQuery,
     UpdateStory,
     UpdateUserStatus,
 )
@@ -88,7 +89,7 @@
 
 
 class Dispatcher:
-    NEW_MESSAGE_UPDATES = (UpdateNewMessage, UpdateNewChannelMessage, UpdateNewScheduledMessage)
+    NEW_MESSAGE_UPDATES = (UpdateNewMessage, UpdateNewChannelMessage, UpdateNewScheduledMessage, UpdateBotGuestChatQuery)
     EDIT_MESSAGE_UPDATES = (UpdateEditMessage, UpdateEditChannelMessage)
     DELETE_MESSAGES_UPDATES = (UpdateDeleteMessages, UpdateDeleteChannelMessages)
     CALLBACK_QUERY_UPDATES = (UpdateBotCallbackQuery, UpdateInlineBotCallbackQuery, UpdateBusinessBotCallbackQuery)
@@ -121,8 +122,6 @@ def __init__(self, client: "pyrogram.Client"):
         self.groups = OrderedDict()
 
         async def message_parser(update, users, chats):
-            connection_id = getattr(update, "connection_id", None)
-
             return (
                 await pyrogram.types.Message._parse(
                     self.client,
@@ -131,7 +130,7 @@ async def message_parser(update, users, chats):
                     chats,
                     is_scheduled=isinstance(update, UpdateNewScheduledMessage),
                     replies=0 if getattr(update, "connection_id", None) else 1,
-                    business_connection_id=connection_id,
+                    business_connection_id=getattr(update, "connection_id", None),
                     raw_reply_to_message=getattr(update, "reply_to_message", None)
                 ),
                 MessageHandler

pyrogram/enums/message_media_type.py

@@ -36,6 +36,9 @@ class MessageMediaType(AutoName):
     PHOTO = auto()
     "Photo media"
 
+    LIVE_PHOTO = auto()
+    "Live photo media"
+
     STICKER = auto()
     "Sticker media"
 

pyrogram/filters.py

@@ -18,17 +18,17 @@
 
 import inspect
 import re
-from typing import Callable, Union, List, Pattern, Optional
+from typing import Callable, List, Optional, Pattern, Union
 
 import pyrogram
 from pyrogram import enums
 from pyrogram.types import (
-    Message,
     CallbackQuery,
     ChosenInlineResult,
+    InlineKeyboardMarkup,
     InlineQuery,
+    Message,
     PreCheckoutQuery,
-    InlineKeyboardMarkup,
     ReplyKeyboardMarkup,
     Update,
 )
@@ -894,6 +894,17 @@ async def media_filter(_, __, m: Message):
 """
 
 
+# endregion
+
+# region guest_message_filter
+async def guest_message_filter(_, __, m: Message):
+    return bool(m.guest_query_id)
+
+
+guest_message = create(guest_message_filter)
+"""Filter messages that has been sent by a guest bot."""
+
+
 # endregion
 
 # region scheduled_filter

pyrogram/methods/bots/__init__.py

@@ -17,6 +17,7 @@
 #  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
 from .answer_callback_query import AnswerCallbackQuery
+from .answer_guest_query import AnswerGuestQuery
 from .answer_inline_query import AnswerInlineQuery
 from .answer_pre_checkout_query import AnswerPreCheckoutQuery
 from .answer_shipping_query import AnswerShippingQuery
@@ -36,6 +37,7 @@
 from .get_chat_menu_button import GetChatMenuButton
 from .get_game_high_scores import GetGameHighScores
 from .get_inline_bot_results import GetInlineBotResults
+from .get_managed_bot_access_settings import GetManagedBotAccessSettings
 from .get_owned_bots import GetOwnedBots
 from .refund_star_payment import RefundStarPayment
 from .request_callback_answer import RequestCallbackAnswer
@@ -49,15 +51,18 @@
 from .set_bot_name import SetBotName
 from .set_chat_menu_button import SetChatMenuButton
 from .set_game_score import SetGameScore
+from .set_managed_bot_access_settings import SetManagedBotAccessSettings
 
 
 class Bots(
     AnswerCallbackQuery,
+    AnswerGuestQuery,
     AnswerInlineQuery,
     AnswerPreCheckoutQuery,
     AnswerShippingQuery,
     CreateInvoiceLink,
     GetInlineBotResults,
+    GetManagedBotAccessSettings,
     GetOwnedBots,
     RefundStarPayment,
     RequestCallbackAnswer,
@@ -84,6 +89,7 @@ class Bots(
     GetChatMenuButton,
     AnswerWebAppQuery,
     CheckBotUsername,
-    CreateBot
+    CreateBot,
+    SetManagedBotAccessSettings
 ):
     pass

pyrogram/methods/bots/answer_guest_query.py

@@ -0,0 +1,62 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import Iterable
+
+import pyrogram
+from pyrogram import raw, types
+
+
+class AnswerGuestQuery:
+    async def answer_guest_query(
+        self: "pyrogram.Client", guest_query_id: str, result: "types.InlineQueryResult"
+    ):
+        """Use this method to reply to a received guest message.
+
+        .. include:: /_includes/usable-by/bots.rst
+
+        Parameters:
+            guest_query_id (``str``):
+                Unique identifier for the answered query.
+
+            result (:obj:`~pyrogram.types.InlineQueryResult`):
+                A result for the guest query.
+
+        Returns:
+            :obj:`~pyrogram.types.SentGuestMessage`: On success, a :obj:`~pyrogram.types.SentGuestMessage` object is returned.
+
+        Example:
+            .. code-block:: python
+
+                from pyrogram.types import InlineQueryResultArticle, InputTextMessageContent
+
+                await app.answer_guest_query(
+                    guest_query_id,
+                    results=[
+                        InlineQueryResultArticle(
+                            "Title",
+                            InputTextMessageContent("Message content"))])
+        """
+        r = await self.invoke(
+            raw.functions.messages.SetBotGuestChatResult(
+                query_id=int(guest_query_id),
+                result=await result.write(self),
+            )
+        )
+
+        return types.SentGuestMessage._parse(r)

…chats/delete_chat_reactions_by_sender.py …/bots/get_managed_bot_access_settings.pypyrogram/methods/chats/delete_chat_reactions_by_sender.py renamed to pyrogram/methods/bots/get_managed_bot_access_settings.py pyrogram/methods/chats/delete_chat_reactions_by_sender.py renamed to pyrogram/methods/bots/get_managed_bot_access_settings.py

@@ -19,33 +19,29 @@
 from typing import Union
 
 import pyrogram
-from pyrogram import raw
+from pyrogram import raw, types
 
 
-class DeleteChatReactionsBySender:
-    async def delete_chat_reactions_by_sender(
+class GetManagedBotAccessSettings:
+    async def get_managed_bot_access_settings(
         self: "pyrogram.Client",
-        chat_id: Union[int, str],
-        sender_id: Union[int, str],
-    ) -> bool:
-        """Delete all reactions sent by a certain user in a chat.
+        user_id: Union[int, str],
+    ) -> "types.BotAccessSettings":
+        """Use this method to get the access settings of a managed bot.
 
-        .. include:: /_includes/usable-by/users.rst
+        .. include:: /_includes/usable-by/users-bots.rst
 
         Parameters:
-            chat_id (``int`` | ``str``):
-                Unique identifier (int) or username (str) of the target chat.
-
-            sender_id (``int`` | ``str``):
-                Unique identifier (int) or username (str) of the user whose reactions will be deleted.
+            user_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the managed bot whose access settings will be returned.
 
         Returns:
-            ``bool``: True on success, False otherwise.
+            :obj:`~pyrogram.types.BotAccessSettings`: On success, bot token is returned.
         """
-
-        return await self.invoke(
-            raw.functions.messages.DeleteParticipantReactions(
-                peer=await self.resolve_peer(chat_id),
-                participant=await self.resolve_peer(sender_id),
+        r = await self.invoke(
+            raw.functions.bots.GetAccessSettings(
+                bot=await self.resolve_peer(user_id),
             )
         )
+
+        return types.BotAccessSettings._parse(self, r)

pyrogram/methods/bots/set_managed_bot_access_settings.py

@@ -0,0 +1,60 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import List, Optional, Union
+
+import pyrogram
+from pyrogram import raw
+
+
+class SetManagedBotAccessSettings:
+    async def set_managed_bot_access_settings(
+        self: "pyrogram.Client",
+        user_id: Union[int, str],
+        is_access_restricted: bool,
+        added_user_ids: Optional[List[Union[int, str]]] = None,
+    ) -> bool:
+        """Use this method to get the access settings of a managed bot.
+
+        .. include:: /_includes/usable-by/users-bots.rst
+
+        Parameters:
+            user_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the managed bot whose access settings will be changed.
+
+            is_access_restricted (``bool``):
+                Pass True, if only selected users can access the bot.
+                The bot's owner can always access it.
+
+            added_user_ids (List of ``int`` | ``str``, *optional*):
+                List of up to 10 identifiers of users who will have access to the bot in addition to its owner.
+                Ignored if is_access_restricted is False.
+
+        Returns:
+            ``bool``: On success, True is returned.
+        """
+        if is_access_restricted is False:
+            added_user_ids = None
+
+        return await self.invoke(
+            raw.functions.bots.EditAccessSettings(
+                bot=await self.resolve_peer(user_id),
+                restricted=is_access_restricted,
+                add_users=[await self.resolve_peer(i) for i in added_user_ids] if added_user_ids is not None else None,
+            )
+        )