Pyrofork: Add support for t.me/<username> link in resolve_peer method

Signed-off-by: wulan17 <wulan17@nusantararom.org>

pyrogram/methods/advanced/resolve_peer.py

@@ -47,7 +47,7 @@ async def resolve_peer(
         Parameters:
             peer_id (``int`` | ``str``):
                 The peer id you want to extract the InputPeer from.
-                Can be a direct id (int), a username (str) or a phone number (str).
+                Can be a direct id (int), a username (str) or a phone number (str) or *t.me/<username>* link.
 
         Returns:
             ``InputPeer``: On success, the resolved peer id is returned in form of an InputPeer object.
@@ -66,6 +66,7 @@ async def resolve_peer(
                     return raw.types.InputPeerSelf()
 
                 peer_id = re.sub(r"[@+\s]", "", peer_id.lower())
+                peer_id = re.sub(r"https://t.me/", "", peer_id.lower())
 
                 try:
                     int(peer_id)

pyrogram/methods/bots/get_chat_menu_button.py

@@ -35,6 +35,7 @@ async def get_chat_menu_button(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use user profile/chat public link in form of *t.me/<username>* (str).
                 If not specified, default bot's menu button will be returned.
         """
 

pyrogram/methods/bots/get_game_high_scores.py

@@ -39,6 +39,7 @@ async def get_game_high_scores(
                 Unique identifier (int) or username (str) of the target chat.
                 For your personal cloud (Saved Messages) you can simply use "me" or "self".
                 For a contact that exists in your Telegram address book you can use his phone number (str).
+                You can also use user profile link in form of *t.me/<username>* (str).
 
             chat_id (``int`` | ``str``, *optional*):
                 Unique identifier (int) or username (str) of the target chat.

pyrogram/methods/bots/get_inline_bot_results.py

@@ -41,6 +41,7 @@ async def get_inline_bot_results(
             bot (``int`` | ``str``):
                 Unique identifier of the inline bot you want to get results from. You can specify
                 a @username (str) or a bot ID (int).
+                You can also use bot profile link in form of *t.me/<username>* (str).
 
             query (``str``, *optional*):
                 Text of the query (up to 512 characters).

pyrogram/methods/bots/request_callback_answer.py

@@ -40,6 +40,7 @@ async def request_callback_answer(
                 Unique identifier (int) or username (str) of the target chat.
                 For your personal cloud (Saved Messages) you can simply use "me" or "self".
                 For a contact that exists in your Telegram address book you can use his phone number (str).
+                You can also use user profile/chat public link in form of *t.me/<username>* (str).
 
             message_id (``int``):
                 The message id the inline keyboard is attached on.

pyrogram/methods/bots/send_game.py

@@ -49,6 +49,7 @@ async def send_game(
                 Unique identifier (int) or username (str) of the target chat.
                 For your personal cloud (Saved Messages) you can simply use "me" or "self".
                 For a contact that exists in your Telegram address book you can use his phone number (str).
+                You can also use user profile/chat public link in form of *t.me/<username>* (str).
 
             game_short_name (``str``):
                 Short name of the game, serves as the unique identifier for the game. Set up your games via Botfather.

pyrogram/methods/bots/send_inline_bot_result.py

@@ -46,6 +46,7 @@ async def send_inline_bot_result(
                 Unique identifier (int) or username (str) of the target chat.
                 For your personal cloud (Saved Messages) you can simply use "me" or "self".
                 For a contact that exists in your Telegram address book you can use his phone number (str).
+                You can also use user profile/chat public link in form of *t.me/<username>* (str).
 
             query_id (``int``):
                 Unique identifier for the answered query.

pyrogram/methods/bots/set_game_score.py

@@ -43,6 +43,7 @@ async def set_game_score(
                 Unique identifier (int) or username (str) of the target chat.
                 For your personal cloud (Saved Messages) you can simply use "me" or "self".
                 For a contact that exists in your Telegram address book you can use his phone number (str).
+                You can also use user profile link in form of *t.me/<username>* (str).
 
             score (``int``):
                 New score, must be non-negative.

pyrogram/methods/chats/add_chat_members.py

@@ -35,12 +35,13 @@ async def add_chat_members(
 
         Parameters:
             chat_id (``int`` | ``str``):
-                The group, supergroup or channel id
+                The group, supergroup or channel id or chat/channel public link
 
             user_ids (``int`` | ``str`` | List of ``int`` or ``str``):
                 Users to add in the chat
                 You can pass an ID (int), username (str) or phone number (str).
                 Multiple users can be added by passing a list of IDs, usernames or phone numbers.
+                You can also use user profile link in form of *t.me/<username>* (str).
 
             forward_limit (``int``, *optional*):
                 How many of the latest messages you want to forward to the new members. Pass 0 to forward none of them.

pyrogram/methods/chats/archive_chats.py

@@ -35,6 +35,7 @@ async def archive_chats(
             chat_ids (``int`` | ``str`` | List[``int``, ``str``]):
                 Unique identifier (int) or username (str) of the target chat.
                 You can also pass a list of ids (int) or usernames (str).
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             ``bool``: On success, True is returned.

pyrogram/methods/chats/ban_chat_member.py

@@ -46,10 +46,12 @@ async def ban_chat_member(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             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).
+                You can also use user profile link in form of *t.me/<username>* (str).
 
             until_date (:py:obj:`~datetime.datetime`, *optional*):
                 Date when the user will be unbanned.

pyrogram/methods/chats/close_forum_topic.py

@@ -34,6 +34,7 @@ async def close_forum_topic(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             topic_id (``int``):
                 Unique identifier (int) of the target forum topic.

pyrogram/methods/chats/close_general_topic.py

@@ -33,6 +33,7 @@ async def close_general_topic(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             `bool`: On success, a True is returned.

pyrogram/methods/chats/create_forum_topic.py

@@ -36,6 +36,7 @@ async def create_forum_topic(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             title (``str``):
                 The forum topic title.

pyrogram/methods/chats/delete_channel.py

@@ -34,6 +34,7 @@ async def delete_channel(
         Parameters:
             chat_id (``int`` | ``str``):
                 The id of the channel to be deleted.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             ``bool``: On success, True is returned.

pyrogram/methods/chats/delete_chat_photo.py

@@ -36,6 +36,7 @@ async def delete_chat_photo(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             ``bool``: True on success.

pyrogram/methods/chats/delete_forum_topic.py

@@ -34,6 +34,7 @@ async def delete_forum_topic(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             topic_id (``int``):
                 Unique identifier (int) of the target forum topic.

pyrogram/methods/chats/delete_supergroup.py

@@ -34,6 +34,7 @@ async def delete_supergroup(
         Parameters:
             chat_id (``int`` | ``str``):
                 The id of the supergroup to be deleted.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             ``bool``: On success, True is returned.

pyrogram/methods/chats/delete_user_history.py

@@ -35,9 +35,11 @@ async def delete_user_history(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             user_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the user whose messages will be deleted.
+                You can also use user profile link in form of *t.me/<username>* (str).
 
         Returns:
             ``bool``: True on success, False otherwise.

pyrogram/methods/chats/edit_forum_topic.py

@@ -36,6 +36,7 @@ async def edit_forum_topic(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             topic_id (``int``):
                 Unique identifier (int) of the target forum topic.

pyrogram/methods/chats/edit_general_topic.py

@@ -34,6 +34,7 @@ async def edit_general_topic(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             title (``str``):
                 The general forum topic title.

pyrogram/methods/chats/get_chat.py

@@ -39,8 +39,9 @@ async def get_chat(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
-                Unique identifier for the target chat in form of a *t.me/joinchat/* link, identifier (int) or username
-                of the target channel/supergroup (in the format @username).
+                Unique identifier for the target chat in form of a *t.me/joinchat/* or *t.me/<username>* link link,
+                identifier (int) or username of the target channel/supergroup (in the format @username).
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             :obj:`~pyrogram.types.Chat` | :obj:`~pyrogram.types.ChatPreview`: On success, if you've already joined the chat, a chat object is returned,

pyrogram/methods/chats/get_chat_event_log.py

@@ -43,6 +43,7 @@ async def get_chat_event_log(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             query (``str``, *optional*):
                 Search query to filter events based on text.

pyrogram/methods/chats/get_chat_member.py

@@ -37,11 +37,13 @@ async def get_chat_member(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             user_id (``int`` | ``str``)::
                 Unique identifier (int) or username (str) of the target user.
                 For you yourself you can simply use "me" or "self".
                 For a contact that exists in your Telegram address book you can use his phone number (str).
+                You can also use user profile link in form of *t.me/<username>* (str).
 
         Returns:
             :obj:`~pyrogram.types.ChatMember`: On success, a chat member is returned.

pyrogram/methods/chats/get_chat_members.py

@@ -75,6 +75,7 @@ async def get_chat_members(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             query (``str``, *optional*):
                 Query string to filter members based on their display names and usernames.

pyrogram/methods/chats/get_chat_members_count.py

@@ -34,6 +34,7 @@ async def get_chat_members_count(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             ``int``: On success, the chat members count is returned.

pyrogram/methods/chats/get_chat_online_count.py

@@ -34,6 +34,7 @@ async def get_chat_online_count(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             ``int``: On success, the chat members online count is returned.

pyrogram/methods/chats/get_forum_topics.py

@@ -41,6 +41,7 @@ async def get_forum_topics(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             limit (``int``, *optional*):
                 Limits the number of topics to be retrieved.

pyrogram/methods/chats/get_forum_topics_by_id.py

@@ -41,6 +41,7 @@ async def get_forum_topics_by_id(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             topic_ids (``int`` | Iterable of ``int``, *optional*):
                 Pass a single topic identifier or an iterable of topic ids (as integers) to get the information of the

pyrogram/methods/chats/get_send_as_chats.py

@@ -35,6 +35,7 @@ async def get_send_as_chats(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             List[:obj:`~pyrogram.types.Chat`]: The list of chats.

pyrogram/methods/chats/hide_general_topic.py

@@ -33,6 +33,7 @@ async def hide_general_topic(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             `bool`: On success, a True is returned.

pyrogram/methods/chats/join_chat.py

@@ -34,8 +34,8 @@ async def join_chat(
 
         Parameters:
             chat_id (``int`` | ``str``):
-                Unique identifier for the target chat in form of a *t.me/joinchat/* link, a username of the target
-                channel/supergroup (in the format @username) or a chat id of a linked chat (channel or supergroup).
+                Unique identifier for the target chat in form of a *t.me/joinchat/* or *t.me/<username>* link,
+                a username of the target channel/supergroup (in the format @username) or a chat id of a linked chat (channel or supergroup).
 
         Returns:
             :obj:`~pyrogram.types.Chat`: On success, a chat object is returned.

pyrogram/methods/chats/leave_chat.py

@@ -36,6 +36,7 @@ async def leave_chat(
             chat_id (``int`` | ``str``):
                 Unique identifier for the target chat or username of the target channel/supergroup
                 (in the format @username).
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             delete (``bool``, *optional*):
                 Deletes the group chat dialog after leaving (for simple group chats, not supergroups).

pyrogram/methods/chats/mark_chat_unread.py

@@ -34,6 +34,7 @@ async def mark_chat_unread(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             ``bool``: On success, True is returned.

pyrogram/methods/chats/pin_chat_message.py

@@ -39,6 +39,7 @@ async def pin_chat_message(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             message_id (``int``):
                 Identifier of a message to pin.

pyrogram/methods/chats/promote_chat_member.py

@@ -40,10 +40,12 @@ async def promote_chat_member(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             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).
+                You can also use user profile link in form of *t.me/<username>* (str).
 
             privileges (:obj:`~pyrogram.types.ChatPrivileges`, *optional*):
                 New user privileges.

pyrogram/methods/chats/reopen_forum_topic.py

@@ -34,6 +34,7 @@ async def reopen_forum_topic(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             topic_id (``int``):
                 Unique identifier (int) of the target forum topic.

pyrogram/methods/chats/reopen_general_topic.py

@@ -33,6 +33,7 @@ async def reopen_general_topic(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
         Returns:
             `bool`: On success, a True is returned.

pyrogram/methods/chats/restrict_chat_member.py

@@ -43,10 +43,12 @@ async def restrict_chat_member(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             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).
+                You can also use user profile link in form of *t.me/<username>* (str).
 
             permissions (:obj:`~pyrogram.types.ChatPermissions`):
                 New user permissions.

pyrogram/methods/chats/set_administrator_title.py

@@ -39,10 +39,12 @@ async def set_administrator_title(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             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).
+                You can also use user profile link in form of *t.me/<username>* (str).
 
             title (``str``, *optional*):
                 A custom title that will be shown to all members instead of "Owner" or "Admin".

pyrogram/methods/chats/set_chat_description.py

@@ -36,6 +36,7 @@ async def set_chat_description(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             description (``str``):
                 New chat description, 0-255 characters.

pyrogram/methods/chats/set_chat_permissions.py

@@ -40,6 +40,7 @@ async def set_chat_permissions(
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
+                You can also use chat public link in form of *t.me/<username>* (str).
 
             permissions (:obj:`~pyrogram.types.ChatPermissions`):
                 New default chat permissions.