Pytdbot 0.9.0.dev2__tar.gz → 0.9.0.dev4__tar.gz

{Pytdbot-0.9.0.dev2 → Pytdbot-0.9.0.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Pytdbot
-Version: 0.9.0.dev2
+Version: 0.9.0.dev4
 Summary: Easy-to-use asynchronous TDLib wrapper for Python.
 Home-page: https://github.com/pytdbot/client
 Author: AYMEN Mohammed
@@ -14,7 +14,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
-# 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.39-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)
+# 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.40-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)
 
 Pytdbot (Python TDLib) is an asynchronous [**TDLib**](https://github.com/tdlib/td) wrapper for **Telegram** users/bots written in **Python**.  
 

{Pytdbot-0.9.0.dev2 → Pytdbot-0.9.0.dev4}/Pytdbot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Pytdbot
-Version: 0.9.0.dev2
+Version: 0.9.0.dev4
 Summary: Easy-to-use asynchronous TDLib wrapper for Python.
 Home-page: https://github.com/pytdbot/client
 Author: AYMEN Mohammed
@@ -14,7 +14,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
-# 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.39-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)
+# 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.40-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)
 
 Pytdbot (Python TDLib) is an asynchronous [**TDLib**](https://github.com/tdlib/td) wrapper for **Telegram** users/bots written in **Python**.  
 

{Pytdbot-0.9.0.dev2 → Pytdbot-0.9.0.dev4}/Pytdbot.egg-info/SOURCES.txt

@@ -34,4 +34,5 @@ pytdbot/utils/escape.py
 pytdbot/utils/json_utils.py
 pytdbot/utils/obj_encoder.py
 pytdbot/utils/strings.py
-pytdbot/utils/text_format.py
+pytdbot/utils/text_format.py
+pytdbot/utils/webapps.py

{Pytdbot-0.9.0.dev2 → Pytdbot-0.9.0.dev4}/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.39-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)
+# 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.40-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)
 
 Pytdbot (Python TDLib) is an asynchronous [**TDLib**](https://github.com/tdlib/td) wrapper for **Telegram** users/bots written in **Python**.  
 

{Pytdbot-0.9.0.dev2 → Pytdbot-0.9.0.dev4}/pytdbot/__init__.py

@@ -4,7 +4,7 @@ from .client import Client
 
 __all__ = ["types", "utils", "filters", "exception", "TdJson", "Client"]
 
-__version__ = "0.9.0dev2"
+__version__ = "0.9.0dev4"
 __copyright__ = "Copyright (c) 2022-2024 AYMEN Mohammed ~ https://github.com/AYMENJD"
 __license__ = "MIT License"
 

{Pytdbot-0.9.0.dev2 → Pytdbot-0.9.0.dev4}/pytdbot/client.py

@@ -36,7 +36,7 @@ from .utils import (
 class Client(Decorators, Methods):
     r"""Pytdbot, a TDLib client
 
-    Args:
+    Parameters:
         token (``str``, *optional*):
             Bot token
 
@@ -231,7 +231,7 @@ class Client(Decorators, Methods):
     async def start(self, login: bool = True) -> None:
         r"""Start pytdbot client
 
-        Args:
+        Parameters:
             login (``bool``, *optional*):
                 Login after start. Default is ``True``
         """
@@ -302,7 +302,7 @@ class Client(Decorators, Methods):
     ) -> None:
         r"""Add an update handler
 
-        Args:
+        Parameters:
             update_type (``str``):
                 An update type
 
@@ -341,7 +341,7 @@ class Client(Decorators, Methods):
     def remove_handler(self, func: Callable) -> bool:
         r"""Remove an update handler
 
-        Args:
+        Parameters:
             func (``Callable``):
                 A callable function
 
@@ -380,7 +380,7 @@ class Client(Decorators, Methods):
                     if not isinstance(res, types.Error):
                         print(res)
 
-        Args:
+        Parameters:
             request (``dict``):
                 The request to be sent
 
@@ -463,7 +463,7 @@ class Client(Decorators, Methods):
                     if not isinstance(res, types.Error):
                         print(res)
 
-        Args:
+        Parameters:
             method (``str``):
                 TDLib method name
 
@@ -491,7 +491,7 @@ class Client(Decorators, Methods):
 
                 client.run()
 
-        Args:
+        Parameters:
             login (``bool``, *optional*):
                 Login after start. Default is ``True``
         """
@@ -595,7 +595,7 @@ class Client(Decorators, Methods):
     def get_retry_after_time(self, error_message: str) -> int:
         r"""Get the retry after time from flood wait error message
 
-        Args:
+        Parameters:
             error_message (``str``):
                 The returned error message from TDLib
 
@@ -735,9 +735,20 @@ class Client(Decorators, Methods):
             else:
                 await self._handle_update(update)
 
+    def get_inner_object(self, update: types.TlObject):
+        if isinstance(update, types.UpdateNewMessage):
+            return update.message
+        return update
+
     async def __run_initializers(self, update):
         for initializer in self._handlers["initializer"]:
             try:
+                update = (
+                    self.get_inner_object(update)
+                    if initializer.inner_object
+                    else update
+                )
+
                 if initializer.filter is not None:
                     filter_function = initializer.filter.func
 
@@ -756,8 +767,9 @@ class Client(Decorators, Methods):
     async def __run_handlers(self, update):
         for handler in self._handlers[update.getType()]:
             try:
-                if handler.inner_object and isinstance(update, types.UpdateNewMessage):
-                    update = update.message
+                update = (
+                    self.get_inner_object(update) if handler.inner_object else update
+                )
 
                 if handler.filter is not None:
                     filter_function = handler.filter.func
@@ -776,6 +788,10 @@ class Client(Decorators, Methods):
     async def __run_finalizers(self, update):
         for finalizer in self._handlers["finalizer"]:
             try:
+                update = (
+                    self.get_inner_object(update) if finalizer.inner_object else update
+                )
+
                 if finalizer.filter is not None:
                     filter_function = finalizer.filter.func
 

Pytdbot-0.9.0.dev4/pytdbot/exception/__init__.py

@@ -0,0 +1,31 @@
+__all__ = ("StopHandlers", "AuthorizationError")
+
+
+class StopHandlers(Exception):
+    r"""An exception to stop handlers from execution"""
+
+    pass
+
+
+class AuthorizationError(Exception):
+    r"""An exception for authorization errors"""
+
+    pass
+
+
+class WebAppDataInvalid(Exception):
+    r"""An exception for invalid webapp data"""
+
+    pass
+
+
+class WebAppDataOutdated(Exception):
+    r"""An exception for outdated webapp data"""
+
+    pass
+
+
+class WebAppDataMismatch(Exception):
+    r"""An exception for mismatched webapp data"""
+
+    pass

{Pytdbot-0.9.0.dev2 → Pytdbot-0.9.0.dev4}/pytdbot/filters.py

@@ -52,7 +52,7 @@ def create(func: Callable) -> Filter:
 
             client.run()
 
-    Args:
+    Parameters:
         func (``Callable``):
             The filter function
 

{Pytdbot-0.9.0.dev2 → Pytdbot-0.9.0.dev4}/pytdbot/handlers/decorators.py

@@ -16,16 +16,20 @@ class Decorators(Updates):
         self: "pytdbot.Client" = None,
         filters: "pytdbot.filters.Filter" = None,
         position: int = None,
+        inner_object: bool = False,
     ) -> None:
         r"""A decorator to initialize an event object before running other handlers
 
-        Args:
+        Parameters:
             filters (:class:`~pytdbot.filters.Filter`, *optional*):
                 An update filter
 
             position (``int``, *optional*):
                 The function position in initializers list. Default is ``None`` (append)
 
+            inner_object (``bool``, *optional*):
+                Wether to pass an inner object of update or not; for example ``UpdateNewMessage.message``. Default is ``False``
+
         Raises:
             :py:class:`TypeError`
         """
@@ -35,13 +39,19 @@ class Decorators(Updates):
                 return func
             elif isinstance(self, pytdbot.Client):
                 if iscoroutinefunction(func):
-                    self.add_handler("initializer", func, filters, position)
+                    self.add_handler(
+                        "initializer", func, filters, position, inner_object
+                    )
                 else:
                     raise TypeError("Handler must be async")
             elif isinstance(self, pytdbot.filters.Filter):
-                func._handler = Handler(func, "initializer", self, position)
+                func._handler = Handler(
+                    func, "initializer", self, position, inner_object
+                )
             else:
-                func._handler = Handler(func, "initializer", filters, position)
+                func._handler = Handler(
+                    func, "initializer", filters, position, inner_object
+                )
 
             return func
 
@@ -51,16 +61,20 @@ class Decorators(Updates):
         self: "pytdbot.Client" = None,
         filters: "pytdbot.filters.Filter" = None,
         position: int = None,
+        inner_object: bool = False,
     ) -> None:
         r"""A decorator to finalize an event object after running all handlers
 
-        Args:
+        Parameters:
             filters (:class:`~pytdbot.filters.Filter`, *optional*):
                 An update filter
 
             position (``int``, *optional*):
                 The function position in finalizers list. Default is ``None`` (append)
 
+            inner_object (``bool``, *optional*):
+                Wether to pass an inner object of update or not; for example ``UpdateNewMessage.message``. Default is ``False``
+
         Raises:
             :py:class:`TypeError`
         """
@@ -70,13 +84,15 @@ class Decorators(Updates):
                 return func
             elif isinstance(self, pytdbot.Client):
                 if iscoroutinefunction(func):
-                    self.add_handler("finalizer", func, filters, position)
+                    self.add_handler("finalizer", func, filters, position, inner_object)
                 else:
                     raise TypeError("Handler must be async")
             elif isinstance(self, pytdbot.filters.Filter):
-                func._handler = Handler(func, "finalizer", self, position)
+                func._handler = Handler(func, "finalizer", self, position, inner_object)
             else:
-                func._handler = Handler(func, "finalizer", filters, position)
+                func._handler = Handler(
+                    func, "finalizer", filters, position, inner_object
+                )
             return func
 
         return decorator
@@ -88,7 +104,7 @@ class Decorators(Updates):
     ) -> None:
         r"""A decorator to handle ``updateNewMessage`` but with ``Message`` object.
 
-        Args:
+        Parameters:
             filters (:class:`~pytdbot.filters.Filter`, *optional*):
                 An update filter