Add ability to send sticker

Added and documented the following methods:

* botogram.Bot.send_sticker
* botogram.User.send_sticker
* botogram.Chat.send_sticker
* botogram.Message.reply_with_sticker

Author: Pietro Albini

botogram/frozenbot.py

@@ -215,6 +215,7 @@ def _call(self, func, component=None, **available):
     objects.Chat.send_video,
     objects.Chat.send_file,
     objects.Chat.send_location,
+    objects.Chat.send_sticker,
 ]
 
 for _proxy in _proxied_sends:

botogram/objects/mixins.py

@@ -124,6 +124,14 @@ def send_location(self, latitude, longitude, reply_to=None, extra=None):
 
         self._api.call("sendLocation", args)
 
+    @_require_api
+    def send_sticker(self, sticker, reply_to=None, extra=None):
+        """Send a sticker"""
+        args = self._get_call_args(reply_to, extra)
+
+        files = {"sticker": open(sticker, "rb")}
+        self._api.call("sendSticker", args, files)
+
 
 class MessageMixin:
     """Add some methods for messages"""
@@ -177,6 +185,11 @@ def reply_with_location(self, latitude, longitude, extra=None):
         """Reply with a geographic location to the current chat"""
         self.chat.send_location(latitude, longitude, self.message_id, extra)
 
+    @_require_api
+    def reply_with_sticker(self, sticker, extra=None):
+        """Reply with a sticker to the current message"""
+        self.chat.send_sticker(sticker, self.message_id, extra)
+
 
 class FileMixin:
     """Add some methods for files"""

docs/api/bot.rst

@@ -453,3 +453,25 @@ components.
       :param float longitude: The longitude of the location
       :param int reply_to: The ID of the :py:class:`~botogram.Message` this one is replying to
       :param object extra: An extra reply interface object to attach
+
+   .. py:method:: send_sticker(sticker, [reply_to=None, extra=None])
+
+      This method sends a sticker to a specific chat chat (in webp format). The
+      chat must be identified by its ID, and Telegram applies some restrictions
+      on the chats allowed to receive your locations: only users who sent you a
+      message in the past are allowed, and also the group chats your bot is
+      currently in.
+
+      If the sticker you're sending is in reply to another message, set
+      *reply_to* to the ID of the other :py:class:`~botogram.Message`. *extra*
+      is an optional object which specifies additional reply interface options
+      on the recipient's end, and can be one of the following types:
+
+      * :py:class:`botogram.ReplyKeyboardMarkup`
+      * :py:class:`botogram.ReplyKeyboardHide`
+      * :py:class:`botogram.ForceReply`
+
+      :param int chat: The ID of the chat which should receive the location
+      :param str sticker: The path to the webp-formatted sticker
+      :param int reply_to: The ID of the :py:class:`~botogram.Message` this one is replying to
+      :param object extra: An extra reply interface object to attach

docs/api/telegram.rst

@@ -220,6 +220,22 @@ about its business.
       :param int reply_to: The ID of the :py:class:`~botogram.Message` this one is replying to
       :param object extra: An extra reply interface object to attach
 
+   .. py:method:: send_sticker(sticker, [reply_to=None, extra=None])
+
+      Send the sticker to the user (in webp format). If the sticker you're
+      sending is in reply to another message, set *reply_to* to the ID of the
+      other :py:class:`~botogram.Message`. *extra* is an optional object which
+      specifies additional reply interface options on the recipient's end, and
+      can be one of the following types:
+
+      * :py:class:`botogram.ReplyKeyboardMarkup`
+      * :py:class:`botogram.ReplyKeyboardHide`
+      * :py:class:`botogram.ForceReply`
+
+      :param str sticker: The path to the webp-formatted sticker
+      :param int reply_to: The ID of the :py:class:`~botogram.Message` this one is replying to
+      :param object extra: An extra reply interface object to attach
+
 
 .. py:class:: botogram.Chat
 
@@ -403,6 +419,22 @@ about its business.
       :param int reply_to: The ID of the :py:class:`~botogram.Message` this one is replying to
       :param object extra: An extra reply interface object to attach
 
+   .. py:method:: send_sticker(sticker, [reply_to=None, extra=None])
+
+      Send the sticker to the chat (in webp format). If the sticker you're
+      sending is in reply to another message, set *reply_to* to the ID of the
+      other :py:class:`~botogram.Message`. *extra* is an optional object which
+      specifies additional reply interface options on the recipient's end, and
+      can be one of the following types:
+
+      * :py:class:`botogram.ReplyKeyboardMarkup`
+      * :py:class:`botogram.ReplyKeyboardHide`
+      * :py:class:`botogram.ForceReply`
+
+      :param str sticker: The path to the webp-formatted sticker
+      :param int reply_to: The ID of the :py:class:`~botogram.Message` this one is replying to
+      :param object extra: An extra reply interface object to attach
+
 
 .. py:class:: botogram.Message
 
@@ -708,6 +740,19 @@ about its business.
       :param float longitude: The longitude of the location
       :param object extra: An extra reply interface object to attach
 
+   .. py:method:: reply_with_sticker(sticker, [reply_to=None, extra=None])
+
+      Reply with the sticker (in webp format) to the chat. *extra* is an
+      optional object which specifies additional reply interface options on the
+      recipient's end, and can be one of the following types:
+
+      * :py:class:`botogram.ReplyKeyboardMarkup`
+      * :py:class:`botogram.ReplyKeyboardHide`
+      * :py:class:`botogram.ForceReply`
+
+      :param str sticker: The path to the webp-formatted sticker
+      :param object extra: An extra reply interface object to attach
+
 
 .. py:class:: botogram.Photo
 

docs/changelog.rst

@@ -26,6 +26,13 @@ botogram 1.0, and warnings are in place to notify you where to change what.
 New features
 ------------
 
+* Added the ability to send stickers
+
+   * New method :py:meth:`botogram.User.send_sticker`
+   * New method :py:meth:`botogram.Chat.send_sticker`
+   * New method :py:meth:`botogram.Bot.send_sticker`
+   * New method :py:meth:`botogram.Message.reply_with_sticker`
+
 * Added the :py:attr:`botogram.User.name` computed attribute
 * Added the :py:attr:`botogram.Chat.name` computed attribute
 * Added the :py:attr:`botogram.User.avatar` attribute