Add send_game and set_game_score methods

docs/source/pyrogram/Client.rst

@@ -67,6 +67,8 @@ Messages
     vote_poll
     retract_vote
     download_media
+    send_game
+    set_game_score
 
 Chats
 -----

docs/source/pyrogram/Types.rst

@@ -57,6 +57,7 @@ Bots
     InlineKeyboardButton
     ForceReply
     CallbackQuery
+    Game
 
 Input Media
 -----------
@@ -182,6 +183,9 @@ Input Media
 .. autoclass:: CallbackQuery
     :members:
 
+.. autoclass:: Game
+    :members:
+
 ..  Input Media
     -----------
 

pyrogram/client/methods/messages/__init__.py

@@ -33,6 +33,7 @@ from .send_audio import SendAudio
 from .send_chat_action import SendChatAction
 from .send_contact import SendContact
 from .send_document import SendDocument
+from .send_game import SendGame
 from .send_location import SendLocation
 from .send_media_group import SendMediaGroup
 from .send_message import SendMessage
@@ -44,6 +45,7 @@ from .send_video import SendVideo
 from .send_video_note import SendVideoNote
 from .send_voice import SendVoice
 from .vote_poll import VotePoll
+from .set_game_score import SetGameScore
 
 
 class Messages(
@@ -74,6 +76,8 @@ class Messages(
     ClosePoll,
     RetractVote,
     DownloadMedia,
-    IterHistory
+    IterHistory,
+    SendGame,
+    SetGameScore
 ):
     pass

pyrogram/client/methods/messages/send_game.py

@@ -0,0 +1,87 @@
+# Pyrogram - Telegram MTProto API Client Library for Python
+# Copyright (C) 2017-2019 Dan Tès <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 Union
+
+import pyrogram
+from pyrogram.api import functions, types
+from ...ext import BaseClient
+
+
+class SendGame(BaseClient):
+    def send_game(self,
+                  chat_id: Union[int, str],
+                  game_short_name: str,
+                  disable_notification: bool = None,
+                  reply_to_message_id: int = None,
+                  reply_markup: Union["pyrogram.InlineKeyboardMarkup",
+                                      "pyrogram.ReplyKeyboardMarkup",
+                                      "pyrogram.ReplyKeyboardRemove",
+                                      "pyrogram.ForceReply"] = None) -> "pyrogram.Message":
+        """Use this method to send a game.
+
+        Args:
+            chat_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target chat.
+                For your personal cloud (Saved Messages) you can simply use "me" or "self".
+                For a contact that exists in your Telegram address book you can use his phone number (str).
+
+            game_short_name (``str``):
+                Short name of the game, serves as the unique identifier for the game. Set up your games via Botfather.
+
+            disable_notification (``bool``, *optional*):
+                Sends the message silently.
+                Users will receive a notification with no sound.
+
+            reply_to_message_id (``int``, *optional*):
+                If the message is a reply, ID of the original message.
+
+            reply_markup (:obj:`InlineKeyboardMarkup`, *optional*):
+                An object for an inline keyboard. If empty, one ‘Play game_title’ button will be shown automatically.
+                If not empty, the first button must launch the game.
+
+        Returns:
+            On success, the sent :obj:`Message` is returned.
+
+        Raises:
+            :class:`Error <pyrogram.Error>` in case of a Telegram RPC error.
+        """
+        r = self.send(
+            functions.messages.SendMedia(
+                peer=self.resolve_peer(chat_id),
+                media=types.InputMediaGame(
+                    id=types.InputGameShortName(
+                        bot_id=types.InputUserSelf(),
+                        short_name=game_short_name
+                    ),
+                ),
+                message="",
+                silent=disable_notification or None,
+                reply_to_msg_id=reply_to_message_id,
+                random_id=self.rnd_id(),
+                reply_markup=reply_markup.write() if reply_markup else None
+            )
+        )
+
+        for i in r.updates:
+            if isinstance(i, (types.UpdateNewMessage, types.UpdateNewChannelMessage)):
+                return pyrogram.Message._parse(
+                    self, i.message,
+                    {i.id: i for i in r.users},
+                    {i.id: i for i in r.chats}
+                )

pyrogram/client/methods/messages/set_game_score.py

@@ -0,0 +1,90 @@
+# Pyrogram - Telegram MTProto API Client Library for Python
+# Copyright (C) 2017-2019 Dan Tès <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 Union
+
+import pyrogram
+from pyrogram.api import functions, types
+from ...ext import BaseClient
+
+
+class SetGameScore(BaseClient):
+    def set_game_score(self,
+                       user_id: Union[int, str],
+                       score: int,
+                       force: bool = None,
+                       disable_edit_message: bool = None,
+                       chat_id: Union[int, str] = None,
+                       message_id: int = None):
+        # inline_message_id: str = None):  TODO Add inline_message_id
+        """Use this method to set the score of the specified user in a game.
+
+        Args:
+            user_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target chat.
+                For your personal cloud (Saved Messages) you can simply use "me" or "self".
+                For a contact that exists in your Telegram address book you can use his phone number (str).
+
+            score (``int``):
+                New score, must be non-negative.
+
+            force (``bool``, *optional*):
+                Pass True, if the high score is allowed to decrease.
+                This can be useful when fixing mistakes or banning cheaters.
+
+            disable_edit_message (``bool``, *optional*):
+                Pass True, if the game message should not be automatically edited to include the current scoreboard.
+
+            chat_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target chat.
+                For your personal cloud (Saved Messages) you can simply use "me" or "self".
+                For a contact that exists in your Telegram address book you can use his phone number (str).
+                Required if inline_message_id is not specified.
+
+            message_id (``int``, *optional*):
+                Identifier of the sent message.
+                Required if inline_message_id is not specified.
+
+        Returns:
+            On success, if the message was sent by the bot, returns the edited :obj:`Message <pyrogram.Message>`,
+            otherwise returns True.
+
+        Raises:
+            :class:`Error <pyrogram.Error>` in case of a Telegram RPC error.
+            :class:`BotScoreNotModified` if the new score is not greater than the user's current score in the chat and force is False.
+        """
+        r = self.send(
+            functions.messages.SetGameScore(
+                peer=self.resolve_peer(chat_id),
+                score=score,
+                id=message_id,
+                user_id=self.resolve_peer(user_id),
+                force=force or None,
+                edit_message=not disable_edit_message or None
+            )
+        )
+
+        for i in r.updates:
+            if isinstance(i, (types.UpdateEditMessage, types.UpdateEditChannelMessage)):
+                return pyrogram.Message._parse(
+                    self, i.message,
+                    {i.id: i for i in r.users},
+                    {i.id: i for i in r.chats}
+                )
+
+        return True