bugs squashed commit message (#163)

* Add media in ExternalReplyInfo
* Add MessageOriginType as enum instead of str, 
As opposed to writing hard-coded values which are prone to errors, enumerations will help to deal with these values in a type-safe way and also enable code completion so that can be sure to apply only a valid value among the expected ones.
* (fix): typings (KurimuzonAkuma/kurigram@9009474)
* (chore): Update documentation (#161)
* Add 1 unknown error
* Make User.block/unblock/get_common_chats async
Fix examples (KurimuzonAkuma/kurigram@f7f83de)
* Fix docs (KurimuzonAkuma/kurigram@f98b927)
* Raise instead of log in copy_message
* Fix for TextQuote parsing (#162)

---------

Co-authored-by: KurimuzonAkuma <[email protected]>

Author: SpEcHiDe

compiler/docs/compiler.py

@@ -874,6 +874,7 @@ def get_title_list(s: str) -> list:
             ClientPlatform
             MessageEntityType
             MessageMediaType
+            MessageOriginType
             MessageServiceType
             MessagesFilter
             ParseMode

compiler/errors/source/400_BAD_REQUEST.tsv

@@ -455,6 +455,7 @@ STARREF_HASH_REVOKED	The specified affiliate link was already revoked.
 STARREF_MONTHS_TOO_LOW	The ``duration_months`` parameter must be between 0 and 36
 STARREF_PERMILLE_INVALID	The specified commission_permille is invalid: the minimum and maximum values for this parameter are contained in the [starref_min_commission_permille](https://core.telegram.org/api/config#starref-min-commission-permille) and [starref_max_commission_permille](https://core.telegram.org/api/config#starref-max-commission-permille) client configuration parameters.
 STARREF_PERMILLE_TOO_LOW	The specified commission_permille is too low: the minimum and maximum values for this parameter are contained in the [starref_min_commission_permille](https://core.telegram.org/api/config#starref-min-commission-permille) and [starref_max_commission_permille](https://core.telegram.org/api/config#starref-max-commission-permille) client configuration parameters.
+STARS_AMOUNT_INVALID	The specified ``paid_stars`` amount is invalid.
 STARS_INVOICE_INVALID	The specified Telegram Star invoice is invalid.
 STARS_PAYMENT_REQUIRED	To import this chat invite link, you must first [pay for the associated Telegram Star subscription](https://core.telegram.org/api/subscriptions#channel-subscriptions).
 START_PARAM_EMPTY	The start parameter is empty.

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

@@ -20,6 +20,7 @@ If you found any issue or have any suggestions, feel free to make `an issue <htt
 Breaking Changes in this Fork
 ==============================
 
+- In :meth:`~pyrogram.Client.copy_message`, ``ValueError`` is raised instead of ``logging`` it.
 - 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.
 - 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.
@@ -33,6 +34,10 @@ Changes in this Fork
 | Scheme layer used: 200 |
 +------------------------+
 
+- Add ``media`` in :obj:`~pyrogram.types.ExternalReplyInfo`.
+- Add :obj:`~pyrogram.enums.MessageOriginType` as enum instead of str, and updated the appropriate filters.
+- Document about `the issue #161 <https://github.com/TelegramPlayGround/pyrogram/issues/161>`__.
+- Make `User.block/unblock/get_common_chats async <https://github.com/KurimuzonAkuma/pyrogram/commit/7cab86a9eee4bd57ac96a1713f9bd37a7fc0ac09>`__, `Fix examples <https://github.com/KurimuzonAkuma/pyrogram/commit/f7f83de4331d6358332dbd0458755e28d59ec0f0>`__ and `Fix docs <https://github.com/KurimuzonAkuma/pyrogram/commit/f98b92765634f862310b21783b186fce66877a24>`__.
 - Try to return the service message (when applicable) in the method :meth:`~pyrogram.Client.set_chat_title`.
 - Added :meth:`~pyrogram.Client.delete_chat_history`.
 - Rename ``UserGift`` to :obj:`~pyrogram.types.ReceivedGift`, ``get_user_gifts`` to :meth:`~pyrogram.Client.get_received_gifts` and the corresponding fields appropriately.

pyrogram/enums/__init__.py

@@ -24,6 +24,7 @@
 from .chat_type import ChatType
 from .message_entity_type import MessageEntityType
 from .message_media_type import MessageMediaType
+from .message_origin_type import MessageOriginType
 from .message_service_type import MessageServiceType
 from .messages_filter import MessagesFilter
 from .next_code_type import NextCodeType
@@ -43,7 +44,8 @@
     'ChatMembersFilter', 
     'ChatType', 
     'MessageEntityType', 
-    'MessageMediaType', 
+    'MessageMediaType',
+    'MessageOriginType',
     'MessageServiceType', 
     'MessagesFilter', 
     'NextCodeType', 

pyrogram/enums/message_origin_type.py

@@ -0,0 +1,40 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present <https://github.com/KurimuzonAkuma>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  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 enum import auto
+
+from .auto_name import AutoName
+
+
+class MessageOriginType(AutoName):
+    """Message origin type enumeration used in :obj:`~pyrogram.types.MessageOrigin`."""
+
+    CHANNEL = auto()
+    "The message was originally a post in a channel"
+
+    CHAT = auto()
+    "The message was originally sent on behalf of a chat"
+
+    HIDDEN_USER = auto()
+    "The message was originally sent by a user, which is hidden by their privacy settings"
+
+    IMPORT_INFO = auto()
+    "The message was imported with `importMessages <https://t.me/telegram/142>`_"
+
+    USER = auto()
+    "The message was originally sent by a known user"

pyrogram/filters.py

@@ -903,7 +903,7 @@ async def from_scheduled_filter(_, __, m: Message) -> bool:
 async def linked_channel_filter(_, __, m: Message) -> bool:
     return bool(
         m.forward_origin and
-        m.forward_origin.type == "channel" and
+        m.forward_origin.type == enums.MessageOriginType.CHANNEL and
         m.forward_origin.chat == m.sender_chat
     )
 

pyrogram/methods/messages/copy_message.py

@@ -130,6 +130,10 @@ async def copy_message(
         Returns:
             :obj:`~pyrogram.types.Message`: On success, the copied message is returned.
 
+        Raises:
+            RPCError: In case of a Telegram RPC error.
+            ValueError: In case if an invalid message_id was provided.
+
         Example:
             .. code-block:: python
 

pyrogram/parser/markdown.py

@@ -18,7 +18,7 @@
 
 import html
 import re
-from typing import Optional
+from typing import Optional, Union
 
 import pyrogram
 from pyrogram.enums import MessageEntityType
@@ -74,7 +74,7 @@ def __init__(self, client: Optional["pyrogram.Client"]):
 
     @staticmethod
     def escape_and_create_quotes(text: str, strict: bool):
-        text_lines: list[str | None] = text.splitlines()
+        text_lines: list[Union[str, None]] = text.splitlines()
 
         # Indexes of Already escaped lines
         html_escaped_list: list[int] = []

pyrogram/types/input_message_content/external_reply_info.py

@@ -99,6 +99,12 @@ class ExternalReplyInfo(Object):
 
         venue (:obj:`~pyrogram.types.Venue`, *optional*):
             Message is a venue, information about the venue.
+        
+        media (:obj:`~pyrogram.enums.MessageMediaType`, *optional*):
+            The external reply is a media message.
+            This field will contain the enumeration type of the media message.
+            You can use ``media = getattr(external_reply, external_reply.media.value)`` to access the media message.
+
     """
 
     def __init__(
@@ -129,6 +135,7 @@ def __init__(
         location: "types.Location" = None,
         poll: "types.Poll" = None,
         venue: "types.Venue" = None,
+        media: "enums.MessageMediaType" = None,
     ):
         super().__init__(client)
 
@@ -156,6 +163,7 @@ def __init__(
         self.location = location
         self.poll = poll
         self.venue = venue
+        self.media = media
 
     @staticmethod
     async def _parse(
@@ -336,7 +344,8 @@ async def _parse(
                 invoice=invoice,
                 location=location,
                 poll=poll,
-                venue=venue
+                venue=venue,
+                media=media_type
             )
 
 

pyrogram/types/message_origin/message_import_info.py

@@ -21,7 +21,7 @@
 from .message_origin import MessageOrigin
 
 import pyrogram
-from pyrogram import types
+from pyrogram import types, enums
 
 
 class MessageImportInfo(MessageOrigin):
@@ -43,7 +43,7 @@ def __init__(
         sender_user_name: str = None
     ):
         super().__init__(
-            type="import_info",
+            type=enums.MessageOriginType.IMPORT_INFO,
             date=date
         )