Merge remote-tracking branch 'KurimuzonAkuma/dev' into dev

# Conflicts:
#	pyproject.toml
#	pyrogram/methods/auth/send_code.py
#	pyrogram/parser/markdown.py
#	pyrogram/types/messages_and_media/paid_media_info.py

Author: SychO3

compiler/docs/compiler.py

@@ -544,13 +544,14 @@ def get_title_list(s: str) -> list:
             disconnect
             initialize
             terminate
-            send_code
-            resend_code
+            send_phone_number_code
+            resend_phone_number_code
             sign_in
             sign_in_bot
             sign_up
             get_password_hint
             check_password
+            change_phone_number
             send_recovery_code
             recover_password
             accept_terms_of_service
@@ -949,6 +950,10 @@ def get_title_list(s: str) -> list:
         Authorization
             ActiveSession
             ActiveSessions
+            FirebaseAuthenticationSettings
+            FirebaseAuthenticationSettingsAndroid
+            FirebaseAuthenticationSettingsIos
+            PhoneNumberAuthenticationSettings
             SentCode
             TermsOfService
         """
@@ -1226,6 +1231,7 @@ def get_title_list(s: str) -> list:
             PaidReactionPrivacy
             ParseMode
             PhoneCallDiscardReason
+            PhoneNumberCodeType
             PollType
             PrivacyKey
             ProfileColor

compiler/errors/source/400_BAD_REQUEST.tsv

@@ -482,9 +482,11 @@ SMS_CODE_CREATE_FAILED	An error occurred while creating the SMS code.
 SRP_A_INVALID	The specified inputCheckPasswordSRP.A value is invalid.
 SRP_ID_INVALID	Invalid SRP ID provided.
 SRP_PASSWORD_CHANGED	The password has changed.
+STARGIFT_ALREADY_BURNED	The provided gift is already burned.
 STARGIFT_ALREADY_CONVERTED	The provided star gift already converted to stars.
 STARGIFT_ALREADY_TRANSFERRED	The provided star gift is already transferred.
 STARGIFT_ALREADY_UPGRADED	This star gift was already upgraded before.
+STARGIFT_ATTRIBUTE_INVALID	The provided gift attribute is invalid.
 STARGIFT_CONVERT_TOO_OLD	This gift can no longer be converted into stars.
 STARGIFT_EXPORT_UNAVAILABLE	This gift is not available for export yet.
 STARGIFT_INVALID	The passed [inputInvoiceStarGift](https://core.telegram.org/constructor/inputInvoiceStarGift) is invalid.
@@ -610,6 +612,7 @@ USER_BOT_REQUIRED	This method can only be called by a bot.
 USER_CHANNELS_TOO_MUCH	One of the users you tried to add is already in too many channels/supergroups.
 USER_CREATOR	The user id being used is invalid or not known yet. Make sure you meet the user before interacting with it.
 USER_GIFT_UNAVAILABLE	Gifts are not available in the current region ([stars_gifts_enabled](https://core.telegram.org/api/config#stars-gifts-enabled) is equal to false).
+USER_HANDLE_MISMATCH	The user handle mismatch.
 USER_ID_INVALID	The provided user id is invalid.
 USER_INVALID	The provided user is invalid.
 USER_IS_BLOCKED	You were blocked by this user.

pyrogram/client.py

@@ -501,7 +501,7 @@ async def authorize(self) -> User:
                     else:
                         self.phone_number = value
 
-                sent_code = await self.send_code(self.phone_number)
+                sent_code = await self.send_phone_number_code(self.phone_number)
             except BadRequest as e:
                 print(e.MESSAGE)
                 self.phone_number = None

pyrogram/enums/__init__.py

@@ -37,6 +37,7 @@
 from .parse_mode import ParseMode
 from .payment_form_type import PaymentFormType
 from .phone_call_discard_reason import PhoneCallDiscardReason
+from .phone_number_code_type import PhoneNumberCodeType
 from .poll_type import PollType
 from .privacy_key import PrivacyKey
 from .privacy_rule_type import PrivacyRuleType
@@ -80,6 +81,7 @@
     'ParseMode',
     'PaymentFormType',
     'PhoneCallDiscardReason',
+    'PhoneNumberCodeType',
     'PollType',
     'PrivacyKey',
     'PrivacyRuleType',

pyrogram/enums/phone_number_code_type.py

@@ -0,0 +1,34 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  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 PhoneNumberCodeType(AutoName):
+    """Describes type of the request for which a code is sent to a phone number"""
+
+    AUTHENTICATION = auto()
+    "Default authentication process."
+
+    CHANGE = auto()
+    "Checks ownership of a new phone number to change the user's authentication phone number. For official Android and iOS applications only."
+
+    VERIFY = auto()
+    "Verifies ownership of a phone number to be added to the user's Telegram Passport."

pyrogram/methods/auth/__init__.py

@@ -17,6 +17,7 @@
 #  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
 from .accept_terms_of_service import AcceptTermsOfService
+from .change_phone_number import ChangePhoneNumber
 from .check_password import CheckPassword
 from .connect import Connect
 from .disconnect import Disconnect
@@ -25,10 +26,10 @@
 from .initialize import Initialize
 from .log_out import LogOut
 from .recover_password import RecoverPassword
-from .resend_code import ResendCode
+from .resend_phone_number_code import ResendPhoneNumberCode
 from .reset_session import ResetSession
 from .reset_sessions import ResetSessions
-from .send_code import SendCode
+from .send_phone_number_code import SendPhoneNumberCode
 from .send_recovery_code import SendRecoveryCode
 from .sign_in import SignIn
 from .sign_in_bot import SignInBot
@@ -38,6 +39,7 @@
 
 class Auth(
     AcceptTermsOfService,
+    ChangePhoneNumber,
     CheckPassword,
     Connect,
     Disconnect,
@@ -46,10 +48,10 @@ class Auth(
     Initialize,
     LogOut,
     RecoverPassword,
-    ResendCode,
+    ResendPhoneNumberCode,
     ResetSession,
     ResetSessions,
-    SendCode,
+    SendPhoneNumberCode,
     SendRecoveryCode,
     SignIn,
     SignInBot,

pyrogram/methods/auth/change_phone_number.py

@@ -0,0 +1,59 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  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/>.
+
+import logging
+import re
+
+import pyrogram
+from pyrogram import raw, types
+
+log = logging.getLogger(__name__)
+
+
+class ChangePhoneNumber:
+    async def change_phone_number(
+        self: "pyrogram.Client", phone_number: str, phone_code_hash: str, phone_code: str
+    ) -> "types.User":
+        """Change a user phone number in Telegram with a valid confirmation code.
+
+        .. include:: /_includes/usable-by/users.rst
+
+        Parameters:
+            phone_number (``str``):
+                Phone number in international format (includes the country prefix).
+
+            phone_code_hash (``str``):
+                Code identifier taken from the result of :meth:`~pyrogram.Client.send_phone_number_code`.
+
+            phone_code (``str``):
+                The valid confirmation code you received from SMS in your phone number.
+
+        Returns:
+            :obj:`~pyrogram.types.User`: On success, in case the change completed, the user is returned.
+        """
+        phone_number = re.sub(r"\D", "", phone_number)
+
+        r = await self.invoke(
+            raw.functions.account.ChangePhone(
+                phone_number=phone_number,
+                phone_code_hash=phone_code_hash,
+                phone_code=phone_code
+            )
+        )
+
+        return types.User._parse(self, r)

pyrogram/methods/auth/resend_code.py …methods/auth/resend_phone_number_code.pypyrogram/methods/auth/resend_code.py renamed to pyrogram/methods/auth/resend_phone_number_code.py pyrogram/methods/auth/resend_code.py renamed to pyrogram/methods/auth/resend_phone_number_code.py

@@ -17,24 +17,22 @@
 #  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
 import logging
+import re
 
 import pyrogram
-from pyrogram import raw
-from pyrogram import types
+from pyrogram import raw, types
 
 log = logging.getLogger(__name__)
 
 
-class ResendCode:
-    async def resend_code(
-        self: "pyrogram.Client",
-        phone_number: str,
-        phone_code_hash: str
+class ResendPhoneNumberCode:
+    async def resend_phone_number_code(
+        self: "pyrogram.Client", phone_number: str, phone_code_hash: str
     ) -> "types.SentCode":
         """Re-send the confirmation code using a different type.
 
         The type of the code to be re-sent is specified in the *next_type* attribute of the
-        :obj:`~pyrogram.types.SentCode` object returned by :meth:`send_code`.
+        :obj:`~pyrogram.types.SentCode` object returned by :meth:`send_phone_number_code`.
 
         .. include:: /_includes/usable-by/users.rst
 
@@ -52,13 +50,14 @@ async def resend_code(
         Raises:
             BadRequest: In case the arguments are invalid.
         """
-        phone_number = phone_number.strip(" +")
+        phone_number = re.sub(r"\D", "", phone_number)
 
         r = await self.invoke(
             raw.functions.auth.ResendCode(
-                phone_number=phone_number,
-                phone_code_hash=phone_code_hash
+                phone_number=phone_number, phone_code_hash=phone_code_hash
             )
         )
 
         return types.SentCode._parse(r)
+
+    resend_code = resend_phone_number_code