Update Types, according to TDLib

Author: SpEcHiDe

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

@@ -19,6 +19,14 @@ Breaking Changes
 Changes in this Fork
 =====================
 
++------------------------+
+| Scheme layer used: 194 |
++------------------------+
+
+- Added the field ``subscription_expiration_date`` in the :obj:`~pyrogram.types.SuccessfulPayment`.
+- Added the parameter ``subscription_period`` in the :meth:`~pyrogram.Client.create_invoice_link`.
+- View `new and changed <https://telegramplayground.github.io/TG-APIs/TL/diff/tdlib.html?from=192&to=194>`__ `raw API methods <https://telegramplayground.github.io/TG-APIs/TL/diff/tdesktop.html?from=192&to=194>`__.
+
 +------------------------+
 | Scheme layer used: 192 |
 +------------------------+

pyrogram/methods/business/create_invoice_link.py

@@ -17,6 +17,7 @@
 #  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
 import logging
+from datetime import datetime
 from typing import List, Optional, Union
 
 import pyrogram
@@ -34,6 +35,7 @@ async def create_invoice_link(
         currency: str,
         prices: List["types.LabeledPrice"],
         provider_token: str = None,
+        subscription_period: datetime = None,
         max_tip_amount: int = None,
         suggested_tip_amounts: List[int] = None,
         start_parameter: str = None,
@@ -73,6 +75,9 @@ async def create_invoice_link(
             provider_token (``str``, *optional*):
                 Payment provider token, obtained via `@BotFather <https://t.me/botfather>`_. Pass an empty string for payments in `Telegram Stars <https://t.me/BotNews/90>`_.
 
+            subscription_period (:py:obj:`~datetime.datetime`, *optional*):
+                The number of seconds the subscription will be active for before the next payment. The currency must be set to “XTR” (Telegram Stars) if the parameter is used. Currently, it must always be 2592000 (30 days) if specified.
+
             max_tip_amount (``int``, *optional*):
                 The maximum accepted amount for tips in the smallest units of the currency (integer, **not** float/double). For example, for a maximum tip of ``US$ 1.45`` pass ``max_tip_amount = 145``. See the exp parameter in `currencies.json <https://core.telegram.org/bots/payments/currencies.json>`_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in `Telegram Stars <https://t.me/BotNews/90>`_.
 
@@ -148,7 +153,8 @@ async def create_invoice_link(
                     shipping_address_requested=need_shipping_address,
                     flexible=is_flexible,
                     phone_to_provider=send_phone_number_to_provider,
-                    email_to_provider=send_email_to_provider
+                    email_to_provider=send_email_to_provider,
+                    subscription_period=utils.datetime_to_timestamp(subscription_period)
                 ),
                 payload=payload.encode() if isinstance(payload, str) else payload,
                 provider=provider_token,

pyrogram/methods/business/get_available_gifts.py

@@ -27,7 +27,7 @@ async def get_available_gifts(
     ) -> List["types.Gift"]:
         """Get all gifts that can be sent to other users.
 
-        .. include:: /_includes/usable-by/users.rst
+        .. include:: /_includes/usable-by/users-bots.rst
 
         Returns:
             List of :obj:`~pyrogram.types.Gift`: On success, a list of star gifts is returned.

pyrogram/methods/business/get_business_connection.py

@@ -16,7 +16,6 @@
 #  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 datetime import datetime
 from typing import Union, List
 
 import pyrogram

pyrogram/methods/business/send_gift.py

@@ -44,10 +44,10 @@ async def send_gift(
                 For a contact that exists in your Telegram address book you can use his phone number (str).
 
             gift_id (``int``):
-                Unique identifier of the gift to send.
+                Identifier of the gift.
 
             text (``str``, *optional*):
-                Text of the message to be sent. 0-``gift_text_length_max`` characters.
+                Text that will be shown along with the gift. 0-``gift_text_length_max`` characters.
 
             parse_mode (:obj:`~pyrogram.enums.ParseMode`, *optional*):
                 By default, texts are parsed using both Markdown and HTML styles.
@@ -58,7 +58,7 @@ async def send_gift(
                 Only Bold, Italic, Underline, Strikethrough, Spoiler, and CustomEmoji entities are allowed.
 
             is_private (``bool``, *optional*):
-                Pass True to show the current user as sender and gift text only to the gift receiver; otherwise, everyone will be able to see them.
+                For users only: Pass True to show the current user as sender and gift text only to the gift receiver; otherwise, everyone will be able to see them.
 
         Returns:
             ``bool``: On success, True is returned.

pyrogram/methods/business/send_invoice.py

@@ -91,7 +91,7 @@ async def send_invoice(
                 Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in `Telegram Stars <https://t.me/BotNews/90>`_.
 
             message_thread_id (``int``, *optional*):
-                If the message is in a thread, ID of the original message.
+                Unique identifier for the target message thread (topic) of the forum; for forum supergroups only.
 
             provider_token (``str``, *optional*):
                 Payment provider token, obtained via `@BotFather <https://t.me/botfather>`_. Pass an empty string for payments in `Telegram Stars <https://t.me/BotNews/90>`_.

pyrogram/methods/chat_topics/close_forum_topic.py

@@ -16,8 +16,7 @@
 #  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 datetime import datetime
-from typing import Union, List
+from typing import Union
 
 import pyrogram
 from pyrogram import types, utils, raw

pyrogram/methods/chat_topics/create_forum_topic.py

@@ -16,8 +16,7 @@
 #  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 datetime import datetime
-from typing import Union, List
+from typing import Union
 
 import pyrogram
 from pyrogram import types, utils, raw

pyrogram/methods/chat_topics/delete_forum_topic.py

@@ -16,8 +16,7 @@
 #  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 datetime import datetime
-from typing import Union, List
+from typing import Union
 
 import pyrogram
 from pyrogram import types, utils, raw

pyrogram/methods/chat_topics/edit_forum_topic.py

@@ -16,8 +16,7 @@
 #  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 datetime import datetime
-from typing import Union, List
+from typing import Union
 
 import pyrogram
 from pyrogram import types, utils, raw