Update methods and types to Layer 223,

except Web Login and Text Entity

Author: SpEcHiDe

compiler/docs/compiler.py

@@ -317,6 +317,7 @@ def get_title_list(s: str) -> list:
             restrict_chat_member
             promote_chat_member
             set_administrator_title
+            set_chat_member_tag
             set_chat_permissions
             set_chat_photo
             delete_chat_photo
@@ -356,6 +357,7 @@ def get_title_list(s: str) -> list:
             get_send_as_chats
             set_send_as_chat
             set_chat_protected_content
+            process_chat_protected_content_disable_request
             get_created_chats
             transfer_chat_ownership
         """,

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

@@ -32,12 +32,23 @@ Changes in this Fork
 =====================
 
 +------------------------+
-| Scheme layer used: 222 |
+| Scheme layer used: 223 |
 +------------------------+
 
+
+- Added the field ``can_edit_tag`` to the class :obj:`~pyrogram.types.ChatPermissions`.
+- Added the field ``tag`` to the class :obj:`~pyrogram.types.ChatMember`.
+- Added the field ``can_manage_tags`` to the class :obj:`~pyrogram.types.ChatPrivileges`.
+- Added the methods :meth:`~pyrogram.Client.set_chat_member_tag` and :meth:`~pyrogram.Client.process_chat_protected_content_disable_request`. Updated the method :meth:`~pyyrogram.Client.set_chat_protected_content` to return the appropriate service message, if available.
+- Added the field ``sender_tag`` to the class :obj:`~pyrogram.types.Message`.
 - Add ``location`` in :obj:`~pyrogram.types.Chat` and add missing parameters in :meth:`~pyrogram.Client.create_supergroup`.
 - fix: :meth:`~pyrogram.Client.get_media_group` concurrent logic (contributed by @Alekzum).
 - properly implement in_memory arg in client to support session string. (contributed by @anonymousx97 in `#222 <https://github.com/KurimuzonAkuma/kurigram/pull/222>`__).
+- View `new and changed <https://telegramplayground.github.io/TG-APIs/TL/diff/tdlib.html?from=222&to=223>`__ `raw API methods <https://telegramplayground.github.io/TG-APIs/TL/diff/tdesktop.html?from=222&to=223>`__.
+
++------------------------+
+| Scheme layer used: 222 |
++------------------------+
 
 - Added the field ``first_profile_audio`` to the class :obj:`~pyrogram.types.Chat` and the methods :meth:`~pyrogram.Client.get_chat_audios`, :meth:`~pyrogram.Client.get_chat_audios_count`, :meth:`~pyrogram.Client.add_profile_audio`, :meth:`~pyrogram.Client.remove_profile_audio`, :meth:`~pyrogram.Client.set_profile_audio_position`.
 - Removed the methods :meth:`~pyrogram.Client.get_received_gifts`, :meth:`~pyrogram.Client.sell_gift`, :meth:`~pyrogram.Client.send_gift`, :meth:`~pyrogram.Client.toggle_gift_is_saved` and the :obj:`~pyrogram.types.ReceivedGift`.

pyrogram/enums/chat_event_action.py

@@ -162,5 +162,10 @@ class ChatEventAction(AutoName):
     ``old_topic_info`` Information about the old pinned topic; may be null
     ``new_topic_info`` Information about the new pinned topic; may be null"""
 
+    CHAT_MEMBER_TAG_CHANGED = auto()
+    """A chat member tag has been changed.
+    ```old_member_tag``` - Information about the old chat member tag
+    ```new_member_tag``` - Information about the new chat member tag"""
+
     UNKNOWN = auto()
     "Unknown chat event action"

pyrogram/methods/chats/create_supergroup.py

@@ -55,7 +55,7 @@ async def create_supergroup(
                 Pass True to create a supergroup for `importing messages <https://core.telegram.org/api/import>`__. 
 
             location (:obj:`~pyrogram.types.ChatLocation`, *optional*):
-                Chat location if a location-basAlekzumed supergroup is being created; pass None to create an ordinary supergroup chat.
+                Chat location if a location-based supergroup is being created; pass None to create an ordinary supergroup chat.
 
         Returns:
             :obj:`~pyrogram.types.Chat`: On success, a chat object is returned.

pyrogram/methods/chats/set_administrator_title.py

@@ -55,6 +55,7 @@ async def set_administrator_title(
             .. code-block:: python
 
                 await app.set_administrator_title(chat_id, user_id, "Admin Title")
+
         """
         chat_id = await self.resolve_peer(chat_id)
         user_id = await self.resolve_peer(user_id)
@@ -83,3 +84,51 @@ async def set_administrator_title(
         )
 
         return True
+
+
+    async def set_chat_member_tag(
+        self: "pyrogram.Client",
+        chat_id: Union[int, str],
+        user_id: Union[int, str],
+        tag: str,
+    ) -> bool:
+        """Set a tag or custom title for a regular member in a group or a supergroup.
+
+        .. include:: /_includes/usable-by/users-bots.rst
+
+        The client must be an administrator in the chat (for basic groups and supergroups only) for this to work and must have the ``can_manage_tags`` administrator right.
+
+        Parameters:
+            chat_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target chat.
+
+            user_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target user.
+                For a contact that exists in your Telegram address book you can use his phone number (str).
+
+            tag (``str``, *optional*):
+                The new tag of the member in the chat.
+                0-16 characters without emoji.
+                Pass None or "" (empty string) to remove the custom title.
+
+        Returns:
+            ``bool``: True on success.
+
+        Example:
+            .. code-block:: python
+
+                await app.set_chat_member_tag(chat_id, user_id, "Member Tag")
+
+        """
+        chat_id = await self.resolve_peer(chat_id)
+        user_id = await self.resolve_peer(user_id)
+
+        await self.invoke(
+            raw.functions.messages.EditChatParticipantRank(
+                peer=chat_id,
+                participant=user_id,
+                rank=title
+            )
+        )
+
+        return True

pyrogram/methods/chats/set_chat_protected_content.py

@@ -19,19 +19,24 @@
 from typing import Union
 
 import pyrogram
-from pyrogram import raw
+from pyrogram import raw, types
 
 
 class SetChatProtectedContent:
     async def set_chat_protected_content(
         self: "pyrogram.Client",
         chat_id: Union[int, str],
         enabled: bool
-    ) -> bool:
+    ) -> Union["types.Message", bool]:
         """Set the chat protected content setting.
 
         .. include:: /_includes/usable-by/users.rst
 
+        Changes the ability of users to save, forward, or copy chat content.
+        
+        Requires owner privileges in basic groups, supergroups and channels.
+        Requires Telegram Premium to enable protected content in private chats. Not available in Saved Messages and private chats with bots or support accounts.
+
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
@@ -40,14 +45,73 @@ async def set_chat_protected_content(
                 Pass True to enable the protected content setting, False to disable.
 
         Returns:
-            ``bool``: On success, True is returned.
-        """
+            :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.
 
-        await self.invoke(
+        Raises:
+            RPCError: In case of a Telegram RPCError.
+
+        """
+        r = await self.invoke(
             raw.functions.messages.ToggleNoForwards(
                 peer=await self.resolve_peer(chat_id),
                 enabled=enabled
             )
         )
+        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
+                )
+        return True
+
+
+    async def process_chat_protected_content_disable_request(
+        self: "pyrogram.Client",
+        chat_id: Union[int, str],
+        request_message_id: int,
+        enabled: bool
+    ) -> Union["types.Message", bool]:
+        """Processes request to disable ``has_protected_content`` in a chat.
+
+        .. include:: /_includes/usable-by/users.rst
+
+        Parameters:
+            chat_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target chat.
+
+            request_message_id (``int``):
+                Identifier of the message with the request. The message must be incoming and has content of the type TODO.
 
+            enabled (``bool``):
+                Pass True to approve the request; pass False to reject the request.
+
+        Returns:
+            :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 RPCError.
+        
+        """
+        r = await self.invoke(
+            raw.functions.messages.ToggleNoForwards(
+                peer=await self.resolve_peer(chat_id),
+                enabled=enabled,
+                request_msg_id=request_message_id
+            )
+        )
+        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
+                )
         return True

pyrogram/types/messages_and_media/message.py

@@ -84,6 +84,11 @@ class Message(Object, Update):
         sender_business_bot (:obj:`~pyrogram.types.User`, *optional*):
             The bot that actually sent the message on behalf of the business account. Available only for outgoing messages sent on behalf of the connected business account.
 
+        sender_tag (``str``, *optional*):
+            Tag of the sender of the message in the supergroup at the time the message was sent.
+            May be empty if none or unknown.
+            For messages sent by basic groups or supergroup administrators, the current custom title or tag must be used instead.
+
         date (:py:obj:`~datetime.datetime`, *optional*):
             Date the message was sent.
 
@@ -464,6 +469,7 @@ def __init__(
         sender_chat: "types.Chat" = None,
         sender_boost_count: int = None,
         sender_business_bot: "types.User" = None,
+        sender_tag: str = None,
         date: datetime = None,
         business_connection_id: str = None,
         chat: "types.Chat" = None,
@@ -685,6 +691,7 @@ def __init__(
         self.general_forum_topic_unhidden = general_forum_topic_unhidden
         self.custom_action = custom_action
         self.sender_business_bot = sender_business_bot
+        self.sender_tag = sender_tag
         self.business_connection_id = business_connection_id
         self.successful_payment = successful_payment
         self.paid_media = paid_media
@@ -1452,6 +1459,7 @@ async def _parse(
                 message.reply_to
             )
             parsed_message.sender_boost_count = getattr(message, "from_boosts_applied", None)
+            parsed_message.sender_tag = getattr(message, "from_rank", None)
 
             if getattr(message, "via_business_bot_id", None):
                 parsed_message.sender_business_bot = types.User._parse(client, users.get(message.via_business_bot_id, None))

pyrogram/types/user_and_chats/chat_event.py

@@ -169,6 +169,9 @@ class ChatEvent(Object):
         old_topic_info, new_topic_info (:obj:`~pyrogram.types.ForumTopic`, *optional*):
             Affected forum topic info of the chat.
 
+        old_member_tag, new_member_tag (``str``, *optional*):
+            Affected tag of the chat member.
+
     """
 
     def __init__(
@@ -247,6 +250,9 @@ def __init__(
 
         old_topic_info: "types.ForumTopic" = None,
         new_topic_info: "types.ForumTopic" = None,
+
+        old_member_tag: str = None,
+        new_member_tag: str = None,
     ):
         super().__init__()
 
@@ -325,6 +331,9 @@ def __init__(
         self.old_topic_info = old_topic_info
         self.new_topic_info = new_topic_info
 
+        self.old_member_tag = old_member_tag
+        self.new_member_tag = new_member_tag
+
 
     @staticmethod
     async def _parse(
@@ -409,6 +418,9 @@ async def _parse(
         old_topic_info: Optional["types.ForumTopic"] = None
         new_topic_info: Optional["types.ForumTopic"] = None
 
+        old_member_tag: Optional[str] = None
+        new_member_tag: Optional[str] = None
+
         if isinstance(action, raw.types.ChannelAdminLogEventActionChangeAbout):
             old_description = action.prev_value
             new_description = action.new_value
@@ -625,6 +637,11 @@ async def _parse(
             )
             action = enums.ChatEventAction.CHAT_FORUM_TOPIC_PINNED
 
+        elif isinstance(action, raw.typs.ChannelAdminLogEventActionParticipantEditRank):
+            old_member_tag = action.prev_rank
+            new_member_tag = action.new_rank
+            action = enums.ChatEventAction.CHAT_MEMBER_TAG_CHANGED
+
         else:
             action = f"{enums.ChatEventAction.UNKNOWN}-{action.QUALNAME}"
 
@@ -703,4 +720,7 @@ async def _parse(
 
             old_topic_info=old_topic_info,
             new_topic_info=new_topic_info,
+
+            old_member_tag=old_member_tag,
+            new_member_tag=new_member_tag,
         )

pyrogram/types/user_and_chats/chat_event_filter.py

@@ -78,6 +78,9 @@ class ChatEventFilter(Object):
             True, if subscription extensions need to be returned.
             Defaults to False.
 
+        member_tag_changes (``bool``, *optional*):
+            True, if member tag and custom title change events need to be returned.
+
     """
 
     def __init__(
@@ -95,6 +98,7 @@ def __init__(
         video_chats: bool = False,
         forum_changes: bool = False,
         subscription_extensions: bool = False,
+        member_tag_changes: bool = False,
     ):
         super().__init__()
 
@@ -111,6 +115,7 @@ def __init__(
         self.video_chats = video_chats
         self.forum_changes = forum_changes
         self.subscription_extensions = subscription_extensions
+        self.member_tag_changes = member_tag_changes
 
     def write(self) -> "raw.base.ChannelAdminLogEventsFilter":
         join = False
@@ -131,6 +136,7 @@ def write(self) -> "raw.base.ChannelAdminLogEventsFilter":
         invites = False
         forum_changes = False
         subscription_extensions = False
+        member_tag_changes = False
 
         if self.new_restrictions:
             ban = True
@@ -175,6 +181,9 @@ def write(self) -> "raw.base.ChannelAdminLogEventsFilter":
 
         if self.subscription_extensions:
             subscription_extensions = True
+        
+        if self.member_tag_changes:
+            member_tag_changes = True
 
         return raw.types.ChannelAdminLogEventsFilter(
             join=join,
@@ -193,7 +202,8 @@ def write(self) -> "raw.base.ChannelAdminLogEventsFilter":
             delete=delete,
             group_call=group_call,
             invites=invites,
-            # send
+            send=False,
             forums=forum_changes,
             sub_extend=subscription_extensions,
+            edit_rank=member_tag_changes,
         )