Try to return the service message (when applicable) in the set_chat_photo

- Documentation Fixes

Author: SpEcHiDe

compiler/errors/source/406_NOT_ACCEPTABLE.tsv

@@ -23,4 +23,4 @@ TOPIC_CLOSED	This topic was closed, you can't send messages to it anymore.
 TOPIC_DELETED	The specified topic was deleted.
 USERPIC_PRIVACY_REQUIRED	You need to disable privacy settings for your profile picture in order to make your geolocation public.
 USERPIC_UPLOAD_REQUIRED	You must have a profile picture to publish your geolocation.
-USER_RESTRICTED	You're spamreported, you can't create channels or chats.
+USER_RESTRICTED	You're spamreported, you can't create channels or chats.

docs/source/releases/changes-in-this-fork.rst

@@ -14,6 +14,8 @@ If you found any issue or have any suggestions, feel free to make `an issue <htt
 | Scheme layer used: 186 |
 +------------------------+
 
+- Try to return the service message (when applicable) in the methods :meth:`~pyrogram.Client.set_chat_photo`, :meth:`~pyrogram.types.Chat.set_photo`.
+- Added the methods :meth:`~pyrogram.Client.get_payment_form` and :meth:`~pyrogram.Client.send_payment_form` `#89 <https://github.com/TelegramPlayGround/pyrogram/pull/89>`__.
 - Added the fields ``expired_member_count``, ``subscription_period`` and ``subscription_price`` to the class :obj:`~pyrogram.types.ChatInviteLink`.
 - Added the field ``can_enable_paid_reaction`` to the class :obj:`~pyrogram.types.Chat`.
 - Added ``link`` property to :obj:`~pyrogram.types.Story` and fixed the ``link`` property in :obj:`~pyrogram.types.Message`.

pyrogram/methods/chats/set_chat_photo.py

@@ -20,8 +20,7 @@
 from typing import Union, BinaryIO
 
 import pyrogram
-from pyrogram import raw
-from pyrogram import utils
+from pyrogram import raw, types, utils
 from pyrogram.file_id import FileType
 
 
@@ -33,7 +32,7 @@ async def set_chat_photo(
         photo: Union[str, BinaryIO] = None,
         video: Union[str, BinaryIO] = None,
         video_start_ts: float = None,
-    ) -> bool:
+    ) -> Union["types.Message", bool]:
         """Set a new chat photo or video (H.264/MPEG-4 AVC video, max 5 seconds).
 
         The ``photo`` and ``video`` arguments are mutually exclusive.
@@ -61,7 +60,8 @@ async def set_chat_photo(
                 The timestamp in seconds of the video frame to use as photo profile preview.
 
         Returns:
-            ``bool``: True on success.
+            :obj:`~pyrogram.types.Message` | ``bool``: On success, a service message will be returned (when applicable),
+            otherwise, in case a message object couldn't be returned, True is returned.
 
         Raises:
             ValueError: if a chat_id belongs to user.
@@ -102,14 +102,14 @@ async def set_chat_photo(
             )
 
         if isinstance(peer, raw.types.InputPeerChat):
-            await self.invoke(
+            r = await self.invoke(
                 raw.functions.messages.EditChatPhoto(
                     chat_id=peer.chat_id,
                     photo=photo,
                 )
             )
         elif isinstance(peer, raw.types.InputPeerChannel):
-            await self.invoke(
+            r = await self.invoke(
                 raw.functions.channels.EditPhoto(
                     channel=peer,
                     photo=photo
@@ -118,4 +118,14 @@ async def set_chat_photo(
         else:
             raise ValueError(f'The chat_id "{chat_id}" belongs to a user')
 
-        return True
+        for i in r.updates:
+            if isinstance(i, (raw.types.UpdateNewMessage, raw.types.UpdateNewChannelMessage)):
+                return await types.Message._parse(
+                    self,
+                    i.message,
+                    {i.id: i for i in r.users},
+                    {i.id: i for i in r.chats},
+                    replies=self.fetch_replies
+                )
+        else:
+            return True

pyrogram/types/user_and_chats/chat.py

@@ -859,7 +859,7 @@ async def set_photo(
         photo: Union[str, BinaryIO] = None,
         video: Union[str, BinaryIO] = None,
         video_start_ts: float = None,
-    ) -> bool:
+    ) -> Union["types.Message", bool]:
         """Bound method *set_photo* of :obj:`~pyrogram.types.Chat`.
 
         Use as a shortcut for:
@@ -902,7 +902,8 @@ async def set_photo(
                 The timestamp in seconds of the video frame to use as photo profile preview.
 
         Returns:
-            ``bool``: True on success.
+            :obj:`~pyrogram.types.Message` | ``bool``: On success, a service message will be returned (when applicable),
+            otherwise, in case a message object couldn't be returned, True is returned.
 
         Raises:
             RPCError: In case of a Telegram RPC error.