Merge branch 'dev' into mc

Author: SpEcHiDe

compiler/docs/compiler.py

@@ -210,6 +210,9 @@ def get_title_list(s: str) -> list:
             get_chat_history_count
             read_chat_history
             get_messages
+            get_chat_pinned_message
+            get_callback_query_message
+            get_replied_message
             view_messages
             get_discussion_message
             get_discussion_replies

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

@@ -18,9 +18,9 @@ Breaking Changes in this Fork
 ==============================
 
 - In :meth:`~pyrogram.Client.download_media`, if the message is a :obj:`~pyrogram.types.PaidMediaInfo` with more than one ``paid_media`` **and** ``idx`` was not specified, then a list of paths or binary file-like objects is returned.
-- Make :meth:`~pyrogram.Client.get_messages` accept only keyword-only arguments. `48d4230 <https://github.com/TelegramPlayGround/pyrogram/commit/48d42304f3ee51034d515919320634935e6b2c83>`__
-- PR `#115 <https://github.com/TelegramPlayGround/pyrogram/pull/115>`__ This `change <https://github.com/pyrogram/pyrogram/pull/966#issuecomment-1108858881>`__ breaks some usages with offset-naive and offset-aware datetimes.
-- PR from upstream: `#1411 <https://github.com/pyrogram/pyrogram/pull/1411>`__ without attribution.
+- PR `#115 <https://github.com/TelegramPlayGround/pyrogram/pull/115>`_ This `change <https://github.com/pyrogram/pyrogram/pull/966#issuecomment-1108858881>`_ breaks some usages with offset-naive and offset-aware datetimes.
+- PR from upstream: `#1411 <https://github.com/pyrogram/pyrogram/pull/1411>`_ without attribution.
+
 
 Changes in this Fork
 =====================
@@ -36,8 +36,8 @@ Changes in this Fork
 +------------------------+
 
 - Updated :doc:`Text Formatting <../../topics/text-formatting>` documentation.
+- Splitted the :meth:`~pyrogram.Client.get_messages` into :meth:`~pyrogram.Client.get_chat_pinned_message`, :meth:`~pyrogram.Client.get_callback_query_message`, and :meth:`~pyrogram.Client.get_replied_message`.
 - Added ``message.content`` property.
-- Added the parameter ``pinned`` and made the parameter ``chat_id`` optional in :meth:`~pyrogram.Client.get_messages`. **NOTE**: Please be aware about using the correct :doc:`Message Identifiers <../../topics/message-identifiers>`, when using this method.
 - Added the ``cover`` and ``start_timestamp`` parameters in :meth:`~pyrogram.Client.send_video` and :obj:`~pyrogram.types.InputPaidMediaVideo`.
 - Added the ``video_start_timestamp`` and renamed the ``send_copy`` and ``remove_caption`` parameters in :meth:`~pyrogram.Client.forward_messages` and :meth:`~pyrogram.types.Message.forward`.
 - Added the ``gift_count`` to the :obj:`~pyrogram.types.Chat`.

pyrogram/methods/chat_topics/get_forum_topic.py

@@ -17,7 +17,8 @@
 #  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
 import logging
-from typing import Union, Iterable
+from collections.abc import Iterable
+from typing import Union
 
 import pyrogram
 from pyrogram import raw
@@ -59,7 +60,8 @@ async def get_forum_topic(
         Raises:
             ValueError: In case of invalid arguments.
         """
-        is_iterable = not isinstance(message_thread_ids, int)
+
+        is_iterable = isinstance(message_thread_ids, Iterable)
         ids = list(message_thread_ids) if is_iterable else [message_thread_ids]
 
         r = await self.invoke(

pyrogram/methods/chats/get_send_as_chats.py

@@ -16,17 +16,17 @@
 #  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
+from typing import Optional, Union
 
 import pyrogram
-from pyrogram import raw
-from pyrogram import types
+from pyrogram import raw, types
 
 
 class GetSendAsChats:
     async def get_send_as_chats(
         self: "pyrogram.Client",
         chat_id: Union[int, str],
+        for_paid_reactions: Optional[bool] = None
     ) -> list["types.Chat"]:
         """Get the list of "send_as" chats available.
 
@@ -36,6 +36,9 @@ async def get_send_as_chats(
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
 
+            for_paid_reactions (``bool``, *optional*):
+                Pass True to get the list of available send_as chats for paid reactions.
+
         Returns:
             List of :obj:`~pyrogram.types.Chat`: The list of chats.
 
@@ -49,6 +52,7 @@ async def get_send_as_chats(
         r = await self.invoke(
             raw.functions.channels.GetSendAs(
                 peer=await self.resolve_peer(chat_id),
+                for_paid_reactions=for_paid_reactions
             )
         )
 
@@ -58,9 +62,10 @@ async def get_send_as_chats(
         send_as_chats = types.List()
 
         for p in r.peers:
-            if isinstance(p, raw.types.PeerUser):
-                send_as_chats.append(types.Chat._parse_chat(self, users[p.user_id]))
+            # TODO
+            if isinstance(p.peer, raw.types.PeerUser):
+                send_as_chats.append(types.Chat._parse_chat(self, users[p.peer.user_id]))
             else:
-                send_as_chats.append(types.Chat._parse_chat(self, chats[p.channel_id]))
+                send_as_chats.append(types.Chat._parse_chat(self, chats[p.peer.channel_id]))
 
         return send_as_chats

pyrogram/methods/messages/copy_message.py

@@ -36,6 +36,8 @@ async def copy_message(
         parse_mode: Optional["enums.ParseMode"] = None,
         caption_entities: list["types.MessageEntity"] = None,
         show_caption_above_media: bool = None,
+        video_cover: Optional[Union[str, "io.BytesIO"]] = None,
+        video_start_timestamp: int = None,
         disable_notification: bool = None,
         reply_parameters: "types.ReplyParameters" = None,
         reply_markup: Union[
@@ -89,6 +91,12 @@ async def copy_message(
             show_caption_above_media (``bool``, *optional*):
                 Pass True, if the caption must be shown above the message media. Ignored if a new caption isn't specified.
 
+            video_cover (``str`` | :obj:`io.BytesIO`, *optional*):
+                New cover for the copied video in the message. Pass None to skip cover uploading and use the existing cover.
+            
+            video_start_timestamp (``int``, *optional*):
+                New start timestamp, from which the video playing must start, in seconds for the copied video in the message.
+
             disable_notification (``bool``, *optional*):
                 Sends the message silently.
                 Users will receive a notification with no sound.
@@ -154,6 +162,8 @@ async def copy_message(
             parse_mode=parse_mode,
             caption_entities=caption_entities,
             show_caption_above_media=show_caption_above_media,
+            video_cover=video_cover,
+            video_start_timestamp=video_start_timestamp,
             disable_notification=disable_notification,
             reply_parameters=reply_parameters,
             reply_markup=reply_markup,

pyrogram/methods/messages/forward_messages.py

@@ -16,8 +16,9 @@
 #  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 collections.abc import Iterable
 from datetime import datetime
-from typing import Union, Iterable
+from typing import Union
 
 import pyrogram
 from pyrogram import raw, utils
@@ -104,7 +105,7 @@ async def forward_messages(
                 await app.forward_messages(to_chat, from_chat, [1, 2, 3])
         """
 
-        is_iterable = not isinstance(message_ids, int)
+        is_iterable = isinstance(message_ids, Iterable)
         message_ids = list(message_ids) if is_iterable else [message_ids]
 
         r = await self.invoke(