Add send_game

jsmnbom · jsmnbom · commit 151a441af77a · 2016-10-03T20:40:17.000+02:00
diff --git a/telegram/bot.py b/telegram/bot.py
@@ -741,6 +741,57 @@ def sendContact(self, chat_id, phone_number, first_name, last_name=None, **kwarg
 
         return url, data
 
+    @log
+    @message
+    def sendGame(self,
+                 chat_id,
+                 game_short_name,
+                 parse_mode=None,
+                 disable_web_page_preview=None,
+                 **kwargs):
+        """Use this method to send game messages.
+
+        Args:
+            chat_id (str): Unique identifier for the target chat or
+                username of the target channel (in the format
+                @channelusername).
+            game_short_name (str): Short name of the game, serves as the unique
+                identifier for the game.
+            **kwargs (dict): Arbitrary keyword arguments.
+
+        Keyword Args:
+            disable_notification (Optional[bool]): Sends the message silently.
+                iOS users will not receive a notification, Android users will
+                receive a notification with no sound.
+            reply_to_message_id (Optional[int]): If the message is a reply,
+                ID of the original message.
+            reply_markup (Optional[:class:`telegram.ReplyMarkup`]): Additional
+                interface options. A JSON-serialized object for an inline
+                keyboard, custom reply keyboard, instructions to hide reply
+                keyboard or to force a reply from the user.
+            timeout (Optional[float]): If this value is specified, use it as
+                the definitive timeout (in seconds) for urlopen() operations.
+
+        Returns:
+            :class:`telegram.Message`: On success, the sent message is
+            returned.
+
+        Raises:
+            :class:`telegram.TelegramError`
+
+        """
+
+        url = '{0}/sendMessage'.format(self.base_url)
+
+        data = {'chat_id': chat_id, 'game_short_name': game_short_name}
+
+        if parse_mode:
+            data['parse_mode'] = parse_mode
+        if disable_web_page_preview:
+            data['disable_web_page_preview'] = disable_web_page_preview
+
+        return url, data
+
     @log
     @message
     def sendChatAction(self, chat_id, action, **kwargs):
@@ -1481,7 +1532,7 @@ def __reduce__(self):
         return (self.__class__, (self.token, self.base_url.replace(self.token, ''),
                                  self.base_file_url.replace(self.token, '')))
 
-    # snake_case (PEP8) aliases
+# snake_case (PEP8) aliases
 
     get_me = getMe
     send_message = sendMessage
@@ -1495,6 +1546,7 @@ def __reduce__(self):
     send_location = sendLocation
     send_venue = sendVenue
     send_contact = sendContact
+    send_game = sendGame
     send_chat_action = sendChatAction
     answer_inline_query = answerInlineQuery
     get_user_profile_photos = getUserProfilePhotos
diff --git a/telegram/message.py b/telegram/message.py
@@ -24,7 +24,7 @@
 from time import mktime
 
 from telegram import (Audio, Contact, Document, Chat, Location, PhotoSize, Sticker, TelegramObject,
-                      User, Video, Voice, Venue, MessageEntity)
+                      User, Video, Voice, Venue, MessageEntity, Game)
 
 
 class Message(TelegramObject):
@@ -45,6 +45,7 @@ class Message(TelegramObject):
         text (str):
         audio (:class:`telegram.Audio`):
         document (:class:`telegram.Document`):
+        game (:class:`telegram.Game`):
         photo (List[:class:`telegram.PhotoSize`]):
         sticker (:class:`telegram.Sticker`):
         video (:class:`telegram.Video`):
@@ -86,6 +87,7 @@ class Message(TelegramObject):
         text (Optional[str]):
         audio (Optional[:class:`telegram.Audio`]):
         document (Optional[:class:`telegram.Document`]):
+        game (Optional[:class:`telegram.Game`]):
         photo (Optional[List[:class:`telegram.PhotoSize`]]):
         sticker (Optional[:class:`telegram.Sticker`]):
         video (Optional[:class:`telegram.Video`]):
@@ -173,6 +175,7 @@ def de_json(data, bot):
         data['edit_date'] = Message._fromtimestamp(data.get('edit_date'))
         data['audio'] = Audio.de_json(data.get('audio'), bot)
         data['document'] = Document.de_json(data.get('document'), bot)
+        data['game'] = Game.de_json(data.get('game'), bot)
         data['photo'] = PhotoSize.de_list(data.get('photo'), bot)
         data['sticker'] = Sticker.de_json(data.get('sticker'), bot)
         data['video'] = Video.de_json(data.get('video'), bot)
