Pytdbot 0.9.2.dev5__tar.gz → 0.9.4__tar.gz

{pytdbot-0.9.2.dev5 → pytdbot-0.9.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Pytdbot
-Version: 0.9.2.dev5
+Version: 0.9.4
 Summary: Easy-to-use asynchronous TDLib wrapper for Python.
 Home-page: https://github.com/pytdbot/client
 Author: AYMEN Mohammed
@@ -30,7 +30,7 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.47-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
+# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.50-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
 
 Pytdbot (Python TDLib) is an asynchronous [**TDLib**](https://github.com/tdlib/td) wrapper for **Telegram** users/bots written in **Python**.
 

{pytdbot-0.9.2.dev5 → pytdbot-0.9.4}/Pytdbot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Pytdbot
-Version: 0.9.2.dev5
+Version: 0.9.4
 Summary: Easy-to-use asynchronous TDLib wrapper for Python.
 Home-page: https://github.com/pytdbot/client
 Author: AYMEN Mohammed
@@ -30,7 +30,7 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.47-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
+# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.50-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
 
 Pytdbot (Python TDLib) is an asynchronous [**TDLib**](https://github.com/tdlib/td) wrapper for **Telegram** users/bots written in **Python**.
 

{pytdbot-0.9.2.dev5 → pytdbot-0.9.4}/README.md

@@ -1,4 +1,4 @@
-# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.47-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
+# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.50-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
 
 Pytdbot (Python TDLib) is an asynchronous [**TDLib**](https://github.com/tdlib/td) wrapper for **Telegram** users/bots written in **Python**.
 

{pytdbot-0.9.2.dev5 → pytdbot-0.9.4}/pytdbot/__init__.py

@@ -13,7 +13,7 @@ __all__ = [
     "Client",
 ]
 
-__version__ = "0.9.2.dev5"
+__version__ = "0.9.4"
 __copyright__ = "Copyright (c) 2022-2025 Pytdbot, AYMENJD"
 __license__ = "MIT License"
 

{pytdbot-0.9.2.dev5 → pytdbot-0.9.4}/pytdbot/client.py

@@ -1,6 +1,6 @@
 import asyncio
 import signal
-from importlib import import_module
+from importlib import import_module, reload as reload_module
 from json import dumps
 from logging import DEBUG, getLogger
 from os.path import join as join_path
@@ -172,12 +172,15 @@ class Client(Decorators, Methods):
         self.is_running = None
         self.me: types.User = None
         self.is_authenticated = False
+        self.is_reloading_plugins = False
         self.is_rabbitmq = True if rabbitmq_url else False
         self.options = {}
+        self.allow_outgoing_message_types: tuple = (types.MessagePaymentRefunded,)
 
         self._check_init_args()
 
         self._handlers = {"initializer": [], "finalizer": []}
+        self._current_handlers = {}
         self._results: Dict[str, asyncio.Future] = {}
         self._workers_tasks = None
         self.__authorization_state = None
@@ -268,6 +271,7 @@ class Client(Decorators, Methods):
         filters: pytdbot.filters.Filter = None,
         position: int = None,
         inner_object: bool = False,
+        is_from_plugin: bool = False,
     ) -> None:
         r"""Add an update handler
 
@@ -287,6 +291,9 @@ class Client(Decorators, Methods):
             inner_object (``bool``, *optional*):
                 Wether to pass an inner object of update or not; for example ``UpdateNewMessage.message``. Default is ``False``
 
+            is_from_plugin (``bool``, *optional*):
+                Wether this handler is from a loaded plugin (this can help reloading plugin during runtime; for development only). Default is ``False``
+
         Raises:
             TypeError
         """
@@ -298,14 +305,38 @@ class Client(Decorators, Methods):
         elif filters is not None and not isinstance(filters, Filter):
             raise TypeError("filters must be instance of pytdbot.filters.Filter")
         else:
-            func = Handler(func, update_type, filters, position, inner_object)
+            handler = Handler(
+                func, update_type, filters, position, inner_object, is_from_plugin
+            )
+
             if update_type not in self._handlers:
                 self._handlers[update_type] = []
+
             if isinstance(position, int):
-                self._handlers[update_type].insert(position, func)
+                self._handlers[update_type].insert(position, handler)
             else:
-                self._handlers[update_type].append(func)
-        self._handlers[update_type].sort(key=lambda x: (x.position is None, x.position))
+                self._handlers[update_type].append(handler)
+
+        self._update_handlers()
+
+    def reload_plugins(self):
+        """Reload all plugins, non-plugin handlers are not ``reloaded``
+        .. note::
+            This is for ``development purposes only`` and should not be used
+            in production environments
+        """
+
+        if self.is_reloading_plugins:
+            return
+
+        self.is_reloading_plugins = True
+        for handlers in self._handlers.values():
+            for handler in handlers.copy():
+                if handler.is_from_plugin:
+                    self.remove_handler(handler.func)
+
+        self._load_plugins(reload_plugins=True)
+        self.is_reloading_plugins = False
 
     def remove_handler(self, func: Callable) -> bool:
         r"""Remove an update handler
@@ -323,13 +354,17 @@ class Client(Decorators, Methods):
 
         if not isinstance(func, Callable):
             raise TypeError("func must be callable")
-        for _, handlers in self._handlers.items():
+
+        removed = False
+        for handlers in self._handlers.values():
             for handler in handlers.copy():
                 if handler.func == func:
                     handlers.remove(handler)
-                    handlers.sort(key=lambda x: (x.position is None, x.position))
-                    return True
-        return False
+                    removed = True
+
+        if removed:
+            self._update_handlers()
+        return removed
 
     async def invoke(
         self,
@@ -554,7 +589,13 @@ class Client(Decorators, Methods):
         if isinstance(self.workers, int) and self.workers < 1:
             raise ValueError("workers must be greater than 0")
 
-    def _load_plugins(self):
+    def _update_handlers(self):
+        self._current_handlers = {
+            k: tuple(sorted(v, key=lambda x: (x.position is None, x.position)))
+            for k, v in self._handlers.items()
+        }
+
+    def _load_plugins(self, reload_plugins: bool = False):
         count = 0
         handlers = 0
         plugin_paths = sorted(Path(self.plugins.folder).rglob("*.py"))
@@ -578,6 +619,8 @@ class Client(Decorators, Methods):
 
             try:
                 module = import_module(module_path)
+                if reload_plugins:
+                    reload_module(module)
             except Exception:
                 self.logger.exception(f"Failed to import plugin {module_path}")
                 continue
@@ -600,6 +643,7 @@ class Client(Decorators, Methods):
                         handler.filter,
                         handler.position,
                         handler.inner_object,
+                        True,
                     )
                     handlers += 1
                     plugin_handlers_count += 1
@@ -665,7 +709,7 @@ class Client(Decorators, Methods):
     async def __run_initializers(self, update):
         inner_object = self.get_inner_object(update)
 
-        for initializer in self._handlers["initializer"]:
+        for initializer in self._current_handlers["initializer"]:
             try:
                 handler_value = inner_object if initializer.inner_object else update
 
@@ -687,7 +731,7 @@ class Client(Decorators, Methods):
     async def __run_handlers(self, update):
         inner_object = self.get_inner_object(update)
 
-        for handler in self._handlers[update.getType()]:
+        for handler in self._current_handlers[update.getType()]:
             try:
                 handler_value = inner_object if handler.inner_object else update
 
@@ -708,7 +752,7 @@ class Client(Decorators, Methods):
     async def __run_finalizers(self, update):
         inner_object = self.get_inner_object(update)
 
-        for finalizer in self._handlers["finalizer"]:
+        for finalizer in self._current_handlers["finalizer"]:
             try:
                 handler_value = inner_object if finalizer.inner_object else update
 
@@ -728,10 +772,13 @@ class Client(Decorators, Methods):
                 self.logger.exception(f"Finalizer {finalizer} failed")
 
     async def _handle_update(self, update):
-        if update.getType() in self._handlers:
+        if update.getType() in self._current_handlers:
             if (
                 not self.user_bot
                 and isinstance(update, types.UpdateNewMessage)
+                and not isinstance(
+                    update.message.content, self.allow_outgoing_message_types
+                )
                 and update.message.is_outgoing
             ):
                 return

{pytdbot-0.9.2.dev5 → pytdbot-0.9.4}/pytdbot/client_manager.py

@@ -189,7 +189,7 @@ class ClientManager:
                 await self.delete_client(client_id, close_client=True)
 
         # Send dummy request to wake up receiver
-        self.send(1, {"@type": "getOption", "name": "version"})
+        self.send(0, {"@type": "getOption", "name": "version"})
 
         await self.__receiver_task
 

{pytdbot-0.9.2.dev5 → pytdbot-0.9.4}/pytdbot/handlers/decorators.py

@@ -1,8 +1,9 @@
 import logging
+from asyncio import iscoroutinefunction
+from typing import Callable
+
 import pytdbot
 
-from typing import Callable
-from asyncio import iscoroutinefunction
 from .handler import Handler
 from .td_updates import Updates
 

{pytdbot-0.9.2.dev5 → pytdbot-0.9.4}/pytdbot/handlers/handler.py

@@ -1,7 +1,9 @@
 from typing import Callable
-from ..filters import Filter
+
 import pytdbot
 
+from ..filters import Filter
+
 
 class Handler:
     r"""A handler class."""
@@ -13,18 +15,20 @@ class Handler:
         filter: Filter = None,
         position: int = None,
         inner_object: bool = False,
+        is_from_plugin: bool = False,
     ) -> None:
         self.func = func
         self.update_type = update_type
         self.filter = filter
         self.position = position
         self.inner_object = inner_object
+        self.is_from_plugin = is_from_plugin
 
     def __call__(self, client: "pytdbot.Client", update: "pytdbot.types.Update"):
         return self.func(client, update)
 
     def __str__(self) -> str:
-        return f"Handler(func={self.func}, update_type={self.update_type}, filter={self.filter}, position={self.position}, inner_object={self.inner_object})"
+        return f"Handler(func={self.func}, update_type={self.update_type}, filter={self.filter}, position={self.position}, inner_object={self.inner_object}, is_from_plugin={self.is_from_plugin})"
 
     def __repr__(self) -> str:
         return str(self)

{pytdbot-0.9.2.dev5 → pytdbot-0.9.4}/pytdbot/handlers/td_updates.py

@@ -1947,6 +1947,82 @@ class Updates:
 
         return decorator
 
+    def on_updateDirectMessagesChatTopic(
+        self: "pytdbot.Client" = None,
+        filters: "pytdbot.filters.Filter" = None,
+        position: int = None,
+    ) -> Callable:
+        r"""Basic information about a topic in a channel direct messages chat administered by the current user has changed\. This update is guaranteed to come before the topic identifier is returned to the application
+
+        Parameters:
+            filters (:class:`pytdbot.filters.Filter`, *optional*):
+                An update filter
+
+            position (``int``, *optional*):
+                The function position in handlers list. Default is ``None`` (append)
+
+        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(
+                        "updateDirectMessagesChatTopic", func, filters, position
+                    )
+                else:
+                    raise TypeError("Handler must be async")
+            elif isinstance(self, pytdbot.filters.Filter):
+                func._handler = Handler(
+                    func, "updateDirectMessagesChatTopic", self, position
+                )
+            else:
+                func._handler = Handler(
+                    func, "updateDirectMessagesChatTopic", filters, position
+                )
+            return func
+
+        return decorator
+
+    def on_updateTopicMessageCount(
+        self: "pytdbot.Client" = None,
+        filters: "pytdbot.filters.Filter" = None,
+        position: int = None,
+    ) -> Callable:
+        r"""Number of messages in a topic has changed; for Saved Messages and channel direct messages chat topics only
+
+        Parameters:
+            filters (:class:`pytdbot.filters.Filter`, *optional*):
+                An update filter
+
+            position (``int``, *optional*):
+                The function position in handlers list. Default is ``None`` (append)
+
+        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("updateTopicMessageCount", func, filters, position)
+                else:
+                    raise TypeError("Handler must be async")
+            elif isinstance(self, pytdbot.filters.Filter):
+                func._handler = Handler(func, "updateTopicMessageCount", self, position)
+            else:
+                func._handler = Handler(
+                    func, "updateTopicMessageCount", filters, position
+                )
+            return func
+
+        return decorator
+
     def on_updateQuickReplyShortcut(
         self: "pytdbot.Client" = None,
         filters: "pytdbot.filters.Filter" = None,
@@ -3256,6 +3332,86 @@ class Updates:
 
         return decorator
 
+    def on_updateGroupCallParticipants(
+        self: "pytdbot.Client" = None,
+        filters: "pytdbot.filters.Filter" = None,
+        position: int = None,
+    ) -> Callable:
+        r"""The list of group call participants that can send and receive encrypted call data has changed; for group calls not bound to a chat only
+
+        Parameters:
+            filters (:class:`pytdbot.filters.Filter`, *optional*):
+                An update filter
+
+            position (``int``, *optional*):
+                The function position in handlers list. Default is ``None`` (append)
+
+        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(
+                        "updateGroupCallParticipants", func, filters, position
+                    )
+                else:
+                    raise TypeError("Handler must be async")
+            elif isinstance(self, pytdbot.filters.Filter):
+                func._handler = Handler(
+                    func, "updateGroupCallParticipants", self, position
+                )
+            else:
+                func._handler = Handler(
+                    func, "updateGroupCallParticipants", filters, position
+                )
+            return func
+
+        return decorator
+
+    def on_updateGroupCallVerificationState(
+        self: "pytdbot.Client" = None,
+        filters: "pytdbot.filters.Filter" = None,
+        position: int = None,
+    ) -> Callable:
+        r"""The verification state of an encrypted group call has changed; for group calls not bound to a chat only
+
+        Parameters:
+            filters (:class:`pytdbot.filters.Filter`, *optional*):
+                An update filter
+
+            position (``int``, *optional*):
+                The function position in handlers list. Default is ``None`` (append)
+
+        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(
+                        "updateGroupCallVerificationState", func, filters, position
+                    )
+                else:
+                    raise TypeError("Handler must be async")
+            elif isinstance(self, pytdbot.filters.Filter):
+                func._handler = Handler(
+                    func, "updateGroupCallVerificationState", self, position
+                )
+            else:
+                func._handler = Handler(
+                    func, "updateGroupCallVerificationState", filters, position
+                )
+            return func
+
+        return decorator
+
     def on_updateNewCallSignalingData(
         self: "pytdbot.Client" = None,
         filters: "pytdbot.filters.Filter" = None,
@@ -3480,12 +3636,12 @@ class Updates:
 
         return decorator
 
-    def on_updateStorySendSucceeded(
+    def on_updateStoryPostSucceeded(
         self: "pytdbot.Client" = None,
         filters: "pytdbot.filters.Filter" = None,
         position: int = None,
     ) -> Callable:
-        r"""A story has been successfully sent
+        r"""A story has been successfully posted
 
         Parameters:
             filters (:class:`pytdbot.filters.Filter`, *optional*):
@@ -3504,28 +3660,28 @@ class Updates:
             elif isinstance(self, pytdbot.Client):
                 if iscoroutinefunction(func):
                     self.add_handler(
-                        "updateStorySendSucceeded", func, filters, position
+                        "updateStoryPostSucceeded", func, filters, position
                     )
                 else:
                     raise TypeError("Handler must be async")
             elif isinstance(self, pytdbot.filters.Filter):
                 func._handler = Handler(
-                    func, "updateStorySendSucceeded", self, position
+                    func, "updateStoryPostSucceeded", self, position
                 )
             else:
                 func._handler = Handler(
-                    func, "updateStorySendSucceeded", filters, position
+                    func, "updateStoryPostSucceeded", filters, position
                 )
             return func
 
         return decorator
 
-    def on_updateStorySendFailed(
+    def on_updateStoryPostFailed(
         self: "pytdbot.Client" = None,
         filters: "pytdbot.filters.Filter" = None,
         position: int = None,
     ) -> Callable:
-        r"""A story failed to send\. If the story sending is canceled, then updateStoryDeleted will be received instead of this update
+        r"""A story failed to post\. If the story posting is canceled, then updateStoryDeleted will be received instead of this update
 
         Parameters:
             filters (:class:`pytdbot.filters.Filter`, *optional*):
@@ -3543,14 +3699,14 @@ class Updates:
                 return func
             elif isinstance(self, pytdbot.Client):
                 if iscoroutinefunction(func):
-                    self.add_handler("updateStorySendFailed", func, filters, position)
+                    self.add_handler("updateStoryPostFailed", func, filters, position)
                 else:
                     raise TypeError("Handler must be async")
             elif isinstance(self, pytdbot.filters.Filter):
-                func._handler = Handler(func, "updateStorySendFailed", self, position)
+                func._handler = Handler(func, "updateStoryPostFailed", self, position)
             else:
                 func._handler = Handler(
-                    func, "updateStorySendFailed", filters, position
+                    func, "updateStoryPostFailed", filters, position
                 )
             return func
 

{pytdbot-0.9.2.dev5 → pytdbot-0.9.4}/pytdbot/methods/methods.py

@@ -1,7 +1,7 @@
-import pytdbot
-
 from typing import List, Union
 
+import pytdbot
+
 from ..types import (
     ChatTypeSupergroup,
     Error,
@@ -37,7 +37,6 @@ from ..types import (
     TextParseModeHTML,
     TextParseModeMarkdown,
 )
-
 from .td_functions import TDLibFunctions