Pytdbot 0.10.0.dev9__py3-none-any.whl → 0.10.1.dev0__py3-none-any.whl

pytdbot/__init__.py

@@ -13,7 +13,7 @@ __all__ = [
     "Client",
 ]
 
-__version__ = "0.10.0.dev9"
+__version__ = "0.10.1.dev0"
 __copyright__ = "Copyright (c) 2022-2026 Pytdbot, AYMENJD"
 __license__ = "MIT License"
 

pytdbot/handlers/td_updates.py

@@ -4203,13 +4203,13 @@ class Updates:
 
         return decorator
 
-    def on_updatePendingTextMessage(
+    def on_updatePendingMessage(
         self: pytdbot.Client | None = None,
         filters: pytdbot.filters.Filter | None = None,
         position: int | None = None,
         timeout: float | None = None,
     ) -> Callable:
-        r"""A new pending text message was received in a chat with a bot\. The message must be shown in the chat for at most getOption\(\"pending\_text\_message\_period\"\) seconds, replace any other pending message with the same draft\_id, and be deleted whenever any incoming message from the bot in the message thread is received
+        r"""A new pending text or rich message was received in a chat with a bot\. The message must be shown in the chat for at most getOption\(\"pending\_text\_message\_period\"\) seconds, replace any other pending message with the same draft\_id, and be deleted whenever any incoming message from the bot in the message thread is received
 
         Parameters:
             filters (:class:`pytdbot.filters.Filter`, *optional*):
@@ -4231,7 +4231,7 @@ class Updates:
             elif isinstance(self, pytdbot.Client):
                 if iscoroutinefunction(func):
                     self.add_handler(
-                        update_type="updatePendingTextMessage",
+                        update_type="updatePendingMessage",
                         func=func,
                         filters=filters,
                         position=position,
@@ -4243,7 +4243,7 @@ class Updates:
             elif isinstance(self, pytdbot.filters.Filter):
                 func._handler = Handler(
                     func=func,
-                    update_type="updatePendingTextMessage",
+                    update_type="updatePendingMessage",
                     filter=self,
                     position=position,
                     inner_object=False,
@@ -4252,7 +4252,7 @@ class Updates:
             else:
                 func._handler = Handler(
                     func=func,
-                    update_type="updatePendingTextMessage",
+                    update_type="updatePendingMessage",
                     filter=filters,
                     position=position,
                     inner_object=False,
@@ -6327,6 +6327,65 @@ class Updates:
 
         return decorator
 
+    def on_updateChatJoinResult(
+        self: pytdbot.Client | None = None,
+        filters: pytdbot.filters.Filter | None = None,
+        position: int | None = None,
+        timeout: float | None = None,
+    ) -> Callable:
+        r"""A join request from the user was completed
+
+        Parameters:
+            filters (:class:`pytdbot.filters.Filter`, *optional*):
+                An update filter
+
+            position (``int``, *optional*):
+                The function position in handlers list. Default is ``None`` (append)
+
+            timeout (``float``, *optional*):
+                Max execution time for the handler before it timeout. Default is ``None``
+
+        Raises:
+            :py:class:`TypeError`
+        """
+
+        def decorator(func: Callable) -> Callable:
+            if hasattr(func, "_handler"):
+                return func
+            elif isinstance(self, pytdbot.Client):
+                if iscoroutinefunction(func):
+                    self.add_handler(
+                        update_type="updateChatJoinResult",
+                        func=func,
+                        filters=filters,
+                        position=position,
+                        inner_object=False,
+                        timeout=timeout,
+                    )
+                else:
+                    raise TypeError("Handler must be async")
+            elif isinstance(self, pytdbot.filters.Filter):
+                func._handler = Handler(
+                    func=func,
+                    update_type="updateChatJoinResult",
+                    filter=self,
+                    position=position,
+                    inner_object=False,
+                    timeout=timeout,
+                )
+            else:
+                func._handler = Handler(
+                    func=func,
+                    update_type="updateChatJoinResult",
+                    filter=filters,
+                    position=position,
+                    inner_object=False,
+                    timeout=timeout,
+                )
+            return func
+
+        return decorator
+
     def on_updateStory(
         self: pytdbot.Client | None = None,
         filters: pytdbot.filters.Filter | None = None,
@@ -7507,6 +7566,65 @@ class Updates:
 
         return decorator
 
+    def on_updateWebBrowserSettings(
+        self: pytdbot.Client | None = None,
+        filters: pytdbot.filters.Filter | None = None,
+        position: int | None = None,
+        timeout: float | None = None,
+    ) -> Callable:
+        r"""Web browser settings have been updated
+
+        Parameters:
+            filters (:class:`pytdbot.filters.Filter`, *optional*):
+                An update filter
+
+            position (``int``, *optional*):
+                The function position in handlers list. Default is ``None`` (append)
+
+            timeout (``float``, *optional*):
+                Max execution time for the handler before it timeout. Default is ``None``
+
+        Raises:
+            :py:class:`TypeError`
+        """
+
+        def decorator(func: Callable) -> Callable:
+            if hasattr(func, "_handler"):
+                return func
+            elif isinstance(self, pytdbot.Client):
+                if iscoroutinefunction(func):
+                    self.add_handler(
+                        update_type="updateWebBrowserSettings",
+                        func=func,
+                        filters=filters,
+                        position=position,
+                        inner_object=False,
+                        timeout=timeout,
+                    )
+                else:
+                    raise TypeError("Handler must be async")
+            elif isinstance(self, pytdbot.filters.Filter):
+                func._handler = Handler(
+                    func=func,
+                    update_type="updateWebBrowserSettings",
+                    filter=self,
+                    position=position,
+                    inner_object=False,
+                    timeout=timeout,
+                )
+            else:
+                func._handler = Handler(
+                    func=func,
+                    update_type="updateWebBrowserSettings",
+                    filter=filters,
+                    position=position,
+                    inner_object=False,
+                    timeout=timeout,
+                )
+            return func
+
+        return decorator
+
     def on_updateLanguagePackStrings(
         self: pytdbot.Client | None = None,
         filters: pytdbot.filters.Filter | None = None,

pytdbot/methods/methods.py

@@ -3,6 +3,9 @@ from ..types import (
     Error,
     FormattedText,
     HttpUrl,
+    InputAnimation,
+    InputAudio,
+    InputDocument,
     InputFile,
     InputFileRemote,
     InputMessageAnimation,
@@ -14,13 +17,17 @@ from ..types import (
     InputMessagePhoto,
     InputMessageReplyTo,
     InputMessageReplyToMessage,
+    InputMessageRichMessage,
     InputMessageSticker,
     InputMessageText,
     InputMessageVideo,
     InputMessageVideoNote,
     InputMessageVoiceNote,
+    InputPhoto,
+    InputRichMessage,
     InputTextQuote,
     InputThumbnail,
+    InputVideo,
     Invoice,
     LabeledPricePart,
     LinkPreviewOptions,
@@ -35,6 +42,8 @@ from ..types import (
     ReplyMarkupInlineKeyboard,
     ReplyMarkupRemoveKeyboard,
     ReplyMarkupShowKeyboard,
+    RichMessageSourceHtml,
+    RichMessageSourceMarkdown,
     TextEntity,
     TextParseModeHTML,
     TextParseModeMarkdown,
@@ -309,6 +318,109 @@ class Methods(TDLibFunctions):
             reply_markup=reply_markup,
         )
 
+    async def sendRichMessage(
+        self,
+        chat_id: int,
+        *,
+        markdown: str = None,
+        html: str = None,
+        is_rtl: bool = False,
+        detect_automatic_blocks: bool = False,
+        clear_draft: bool = False,
+        disable_notification: bool = False,
+        protect_content: bool = False,
+        allow_paid_broadcast: bool = False,
+        topic_id: MessageTopic = None,
+        quote: InputTextQuote = None,
+        reply_to: InputMessageReplyTo = None,
+        reply_to_message_id: int = 0,
+        reply_markup: (
+            ReplyMarkupInlineKeyboard
+            | ReplyMarkupShowKeyboard
+            | ReplyMarkupForceReply
+            | ReplyMarkupRemoveKeyboard
+        ) = None,
+    ) -> Error | Message:
+        r"""Send rich message to chat; either markdown or html must be provided
+
+        Parameters:
+            chat_id (``int``):
+                Target chat
+
+            markdown (``str``, *optional*):
+                Markdown-formatted text of the message
+
+            html (``str``, *optional*):
+                HTML-formatted text of the message
+
+            is_rtl (``bool``, *optional*):
+                Pass true if the message must be shown from right to left. Default is ``False``
+
+            detect_automatic_blocks (``bool``, *optional*):
+                Pass true to enable detection of URLs, email addresses and other automatic blocks. Default is ``False``
+
+            disable_notification (``bool``, *optional*):
+                If True, disable notification for the message. Default is ``None``
+
+            clear_draft (``bool``, *optional*):
+                True, if a chat message draft must be deleted. Default is ``False``
+
+            protect_content (``bool``, *optional*):
+                If True, the content of the message must be protected from forwarding and saving
+
+            allow_paid_broadcast (``bool``, *optional*):
+                Pass true to allow the message to ignore regular broadcast limits for a small fee; for bots only. Default is ``False``
+
+            topic_id (:class:`~pytdbot.types.MessageTopic`, *optional*):
+                Topic in which the message will be sent; pass null if none
+
+            quote (:class:`~pytdbot.types.InputTextQuote`, *optional*):
+                Chosen quote from the replied message; may be null if none
+
+            reply_to (:class:`~pytdbot.types.InputMessageReplyTo`, *optional*):
+                Information about the message or the story this message is replying to; may be null if none
+
+            reply_to_message_id (``int``, *optional*):
+                Identifier of the message to reply. Ignored if ``reply_to`` is specified
+
+            reply_markup (:class:`~pytdbot.types.ReplyMarkupInlineKeyboard` | :class:`~pytdbot.types.ReplyMarkupShowKeyboard` | :class:`~pytdbot.types.ReplyMarkupForceReply` | :class:`~pytdbot.types.ReplyMarkupRemoveKeyboard`, *optional*):
+                The message reply markup
+
+        Returns:
+            :class:`~pytdbot.types.Message`
+        """
+
+        if not markdown and not html:
+            raise ValueError("Either markdown or html must be provided")
+
+        if markdown and html:
+            raise ValueError("Only one of markdown or html can be provided")
+
+        if markdown:
+            source = RichMessageSourceMarkdown(text=markdown)
+        else:
+            source = RichMessageSourceHtml(text=html)
+
+        return await self.sendMessageWithContent(
+            chat_id=chat_id,
+            content=InputMessageRichMessage(
+                message=InputRichMessage(
+                    source=source,
+                    is_rtl=is_rtl,
+                    detect_automatic_blocks=detect_automatic_blocks,
+                ),
+                clear_draft=clear_draft,
+            ),
+            disable_notification=disable_notification,
+            protect_content=protect_content,
+            allow_paid_broadcast=allow_paid_broadcast,
+            topic_id=topic_id,
+            quote=quote,
+            reply_to=reply_to,
+            reply_to_message_id=reply_to_message_id,
+            reply_markup=reply_markup,
+        )
+
     async def sendAnimation(
         self,
         chat_id: int,
@@ -418,12 +530,14 @@ class Methods(TDLibFunctions):
         return await self.sendMessageWithContent(
             chat_id=chat_id,
             content=InputMessageAnimation(
-                animation=animation,
-                thumbnail=thumbnail,
-                added_sticker_file_ids=added_sticker_file_ids,
-                duration=duration,
-                width=width,
-                height=height,
+                animation=InputAnimation(
+                    animation=animation,
+                    thumbnail=thumbnail,
+                    added_sticker_file_ids=added_sticker_file_ids,
+                    duration=duration,
+                    width=width,
+                    height=height,
+                ),
                 caption=caption,
                 has_spoiler=has_spoiler,
             ),
@@ -539,11 +653,13 @@ class Methods(TDLibFunctions):
         return await self.sendMessageWithContent(
             chat_id=chat_id,
             content=InputMessageAudio(
-                audio=audio,
-                album_cover_thumbnail=album_cover_thumbnail,
-                title=title,
-                performer=performer,
-                duration=duration,
+                audio=InputAudio(
+                    audio=audio,
+                    album_cover_thumbnail=album_cover_thumbnail,
+                    title=title,
+                    performer=performer,
+                    duration=duration,
+                ),
                 caption=caption,
             ),
             disable_notification=disable_notification,
@@ -649,9 +765,11 @@ class Methods(TDLibFunctions):
         return await self.sendMessageWithContent(
             chat_id=chat_id,
             content=InputMessageDocument(
-                document=document,
-                thumbnail=thumbnail,
-                disable_content_type_detection=disable_content_type_detection,
+                document=InputDocument(
+                    document=document,
+                    thumbnail=thumbnail,
+                    disable_content_type_detection=disable_content_type_detection,
+                ),
                 caption=caption,
             ),
             disable_notification=disable_notification,
@@ -872,12 +990,14 @@ class Methods(TDLibFunctions):
         return await self.sendMessageWithContent(
             chat_id=chat_id,
             content=InputMessagePhoto(
-                photo=photo,
-                thumbnail=thumbnail,
-                added_sticker_file_ids=added_sticker_file_ids,
+                photo=InputPhoto(
+                    photo=photo,
+                    thumbnail=thumbnail,
+                    added_sticker_file_ids=added_sticker_file_ids,
+                    width=width,
+                    height=height,
+                ),
                 self_destruct_type=self_destruct_type,
-                width=width,
-                height=height,
                 caption=caption,
                 has_spoiler=has_spoiler,
             ),
@@ -1008,13 +1128,15 @@ class Methods(TDLibFunctions):
         return await self.sendMessageWithContent(
             chat_id=chat_id,
             content=InputMessageVideo(
-                video=video,
-                thumbnail=thumbnail,
-                added_sticker_file_ids=added_sticker_file_ids,
-                duration=duration,
-                width=width,
-                height=height,
-                supports_streaming=supports_streaming,
+                video=InputVideo(
+                    video=video,
+                    thumbnail=thumbnail,
+                    added_sticker_file_ids=added_sticker_file_ids,
+                    duration=duration,
+                    width=width,
+                    height=height,
+                    supports_streaming=supports_streaming,
+                ),
                 caption=caption,
                 self_destruct_type=self_destruct_type,
                 has_spoiler=has_spoiler,
@@ -1401,7 +1523,7 @@ class Methods(TDLibFunctions):
                 return parse
             caption = parse
         else:
-            caption = FormattedText(id=new_caption)
+            caption = FormattedText(text=new_caption)
 
         return await self.sendMessageWithContent(
             chat_id=chat_id,