Add new_video_start_timestamp in forward_messages and the bound method.

Renamed some of the parameters in forward_messages and the bound method.

Author: SpEcHiDe

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

@@ -26,6 +26,7 @@ Changes in this Fork
 | Scheme layer used: 198 |
 +------------------------+
 
+- Added the ``new_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`.
 - Added the :meth:`~pyrogram.Client.get_similar_bots`.
 - Changed types in :obj:`~pyrogram.types.UpgradedGift`, :obj:`~pyrogram.types.UserGift`.
@@ -395,7 +396,7 @@ Changes in this Fork
 - Replaced the parameter ``disable_web_page_preview`` with :obj:`~pyrogram.types.LinkPreviewOptions` in the methods :meth:`~pyrogram.Client.send_message` and :meth:`~pyrogram.Client.edit_message_text`.
 - Replaced the field ``disable_web_page_preview`` with :obj:`~pyrogram.types.LinkPreviewOptions` in the class :obj:`~pyrogram.types.InputTextMessageContent`.
 - Added missing parameters to :meth:`~pyrogram.Client.forward_messages`.
-- Added the class :obj:`~pyrogram.types.ReplyParameters` and replaced parameters ``reply_to_message_id`` in the methods :meth:`~pyrogram.Client.copy_message`, :meth:`~pyrogram.Client.forward_messages`, :meth:`~pyrogram.Client.send_message`, :meth:`~pyrogram.Client.send_photo`, :meth:`~pyrogram.Client.send_video`, :meth:`~pyrogram.Client.send_animation`, :meth:`~pyrogram.Client.send_audio`, :meth:`~pyrogram.Client.send_document`, :meth:`~pyrogram.Client.send_sticker`, :meth:`~pyrogram.Client.send_video_note`, :meth:`~pyrogram.Client.send_voice`, :meth:`~pyrogram.Client.send_location`, :meth:`~pyrogram.Client.send_venue`, :meth:`~pyrogram.Client.send_contact`, :meth:`~pyrogram.Client.send_poll`, :meth:`~pyrogram.Client.send_dice`, :meth:`~pyrogram.Client.send_game`, :meth:`~pyrogram.Client.send_media_group`, :meth:`~pyrogram.Client.copy_media_group`, :meth:`~pyrogram.Client.send_inline_bot_result`, :meth:`~pyrogram.Client.send_cached_media`, and the corresponding reply_* methods with the field ``reply_parameters`` of type :obj:`~pyrogram.types.ReplyParameters`.
+- Added the class :obj:`~pyrogram.types.ReplyParameters` and replaced parameters ``reply_to_message_id`` in the methods :meth:`~pyrogram.Client.copy_message`, :meth:`~pyrogram.Client.send_message`, :meth:`~pyrogram.Client.send_photo`, :meth:`~pyrogram.Client.send_video`, :meth:`~pyrogram.Client.send_animation`, :meth:`~pyrogram.Client.send_audio`, :meth:`~pyrogram.Client.send_document`, :meth:`~pyrogram.Client.send_sticker`, :meth:`~pyrogram.Client.send_video_note`, :meth:`~pyrogram.Client.send_voice`, :meth:`~pyrogram.Client.send_location`, :meth:`~pyrogram.Client.send_venue`, :meth:`~pyrogram.Client.send_contact`, :meth:`~pyrogram.Client.send_poll`, :meth:`~pyrogram.Client.send_dice`, :meth:`~pyrogram.Client.send_game`, :meth:`~pyrogram.Client.send_media_group`, :meth:`~pyrogram.Client.copy_media_group`, :meth:`~pyrogram.Client.send_inline_bot_result`, :meth:`~pyrogram.Client.send_cached_media`, and the corresponding reply_* methods with the field ``reply_parameters`` of type :obj:`~pyrogram.types.ReplyParameters`.
 - Bug fixes for sending ``ttl_seconds`` and ``has_spoiler``.
 
 +------------------------+

pyrogram/methods/messages/forward_messages.py

@@ -34,8 +34,9 @@ async def forward_messages(
         disable_notification: bool = None,
         protect_content: bool = None,
         allow_paid_broadcast: bool = None,
-        drop_author: bool = None,
-        drop_media_captions: bool = None,
+        send_copy: bool = None,
+        remove_caption: bool = None,
+        new_video_start_timestamp: int = None,
         send_as: Union[int, str] = None,
         schedule_date: datetime = None
     ) -> Union["types.Message", list["types.Message"]]:
@@ -70,11 +71,14 @@ async def forward_messages(
             allow_paid_broadcast (``bool``, *optional*):
                 Pass True to allow the message to ignore regular broadcast limits for a fee; for bots only
 
-            drop_author (``bool``, *optional*):
-                Whether to forward messages without quoting the original author.
+            send_copy (``bool``, *optional*):
+                Pass True to copy content of the messages without reference to the original sender.
 
-            drop_media_captions (``bool``, *optional*):
-                Whether to strip captions from media.
+            remove_caption (``bool``, *optional*):
+                Pass True to remove media captions of message copies.
+
+            new_video_start_timestamp (``int``, *optional*):
+                The new video start timestamp. Pass time to replace video start timestamp in the forwarded message.
 
             send_as (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the chat or channel to send the message as.
@@ -110,16 +114,15 @@ async def forward_messages(
                 id=message_ids,
                 silent=disable_notification or None,
                 # TODO
-                # TODO
-                drop_author=drop_author,
-                drop_media_captions=drop_media_captions,
+                video_timestamp=new_video_start_timestamp,
+                drop_author=send_copy,
+                drop_media_captions=remove_caption,
                 noforwards=protect_content,
                 allow_paid_floodskip=allow_paid_broadcast,
                 random_id=[self.rnd_id() for _ in message_ids],
                 send_as=await self.resolve_peer(send_as) if send_as else None,
                 schedule_date=utils.datetime_to_timestamp(schedule_date),
                 top_msg_id=message_thread_id
-                # TODO
             )
         )
 

pyrogram/types/messages_and_media/message.py

@@ -4571,8 +4571,9 @@ async def forward(
         disable_notification: bool = None,
         protect_content: bool = None,
         allow_paid_broadcast: bool = None,
-        drop_author: bool = None,
-        drop_media_captions: bool = None,
+        send_copy: bool = None,
+        remove_caption: bool = None,
+        new_video_start_timestamp: int = None,
         send_as: Union[int, str] = None,
         schedule_date: datetime = None
     ) -> Union["types.Message", list["types.Message"]]:
@@ -4612,11 +4613,14 @@ async def forward(
             allow_paid_broadcast (``bool``, *optional*):
                 Pass True to allow the message to ignore regular broadcast limits for a fee; for bots only
 
-            drop_author (``bool``, *optional*):
-                Whether to forward messages without quoting the original author.
+            send_copy (``bool``, *optional*):
+                Pass True to copy content of the messages without reference to the original sender.
 
-            drop_media_captions (``bool``, *optional*):
-                Whether to strip captions from media.
+            remove_caption (``bool``, *optional*):
+                Pass True to remove media captions of message copies.
+
+            new_video_start_timestamp (``int``, *optional*):
+                The new video start timestamp. Pass time to replace video start timestamp in the forwarded message.
 
             send_as (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the chat or channel to send the message as.
@@ -4642,8 +4646,9 @@ async def forward(
             disable_notification=disable_notification,
             protect_content=protect_content,
             allow_paid_broadcast=allow_paid_broadcast,
-            drop_author=drop_author,
-            drop_media_captions=drop_media_captions,
+            send_copy=send_copy,
+            remove_caption=remove_caption,
+            new_video_start_timestamp=new_video_start_timestamp,
             send_as=send_as,
             schedule_date=schedule_date
         )