Add Message.forward_from_message_id and Message.channel_post_author

Author: pietroalbini

botogram/objects/messages.py

@@ -334,6 +334,7 @@ def from_(self):
         "entities": ParsedText,
         "forward_from": User,
         "forward_from_chat": Chat,
+        "forward_from_message_id": int,
         "forward_date": int,
         "reply_to_message": _itself,
         "text": str,
@@ -394,6 +395,16 @@ def forward_from(self):
         if self._forward_from is not None:
             return self._forward_from
 
+    @property
+    def channel_post_author(self):
+        """Get the author of the channel post"""
+        if self.chat.type == "channel":
+            return self.sender
+
+        if self._forward_from_chat is not None:
+            if self.forward_from.type == "channel":
+                return self._forward_from
+
     @property
     @utils.deprecated("Message.new_chat_participant", "1.0",
                       "Rename property to Message.new_chat_member")

docs/api/telegram.rst

@@ -1130,6 +1130,13 @@ about its business.
 
          The value can also be an instance of :py:class:`~botogram.Chat`.
 
+   .. py:attribute:: forward_from_message_id
+
+      The ID of the original message that was forwarded. This is currently only
+      available for channel posts.
+
+      .. versionadded:: 0.4
+
    .. py:attribute:: forward_date
 
       The integer date (in Unix time) of when the original message was sent,
@@ -1229,6 +1236,14 @@ about its business.
 
       *This attribute can be None if the message isn't a venue.*
 
+   .. py:attribute:: channel_post_author
+
+      The author of the message. This only works if the message is a channel
+      post and it's signed by the author, even if the message is forwarded.
+      Otherwise it's *None*.
+
+      .. versionadded:: 0.4
+
    .. py:attribute:: new_chat_member
 
       A :py:class:`~botogram.User` object representing a new member of a group

docs/changelog/0.4.rst

@@ -60,6 +60,11 @@ New features
 
   * New method :py:meth:`botogram.Message.edit_attach`
 
+* Added new attributes on the :py:class:`~botogram.Message` object:
+
+  * New attribute :py:attr:`botogram.Message.channel_post_author`
+  * New attribute :py:attr:`botogram.Message.forward_from_message_id`
+
 Performance improvements
 ------------------------