Rubka 6.4.6__py3-none-any.whl → 6.4.8__py3-none-any.whl

rubka/api.py

@@ -498,6 +498,168 @@ class Robot:
             })
             return func
         return decorator
+    def on_message_file(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            def wrapper(bot, message: Message):
+                if not message.file:
+                    return
+                if filters and not filters(message):
+                    return
+                return func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "file_only": True,
+                "commands":commands
+            })
+            return wrapper
+        return decorator
+
+    def on_message_forwarded(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            def wrapper(bot, message: Message):
+                if not message.is_forwarded:
+                    return
+                if filters and not filters(message):
+                    return
+                return func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "forwarded_only": True,
+                "commands":commands
+            })
+            return wrapper
+        return decorator
+
+    def on_message_reply(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            def wrapper(bot, message: Message):
+                if not message.is_reply:
+                    return
+                if filters and not filters(message):
+                    return
+                return func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "reply_only": True,
+                "commands":commands
+            })
+            return wrapper
+        return decorator
+
+    def on_message_text(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            def wrapper(bot, message: Message):
+                if not message.text:
+                    return
+                if filters and not filters(message):
+                    return
+                return func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "text_only": True,
+                "commands":commands
+            })
+            return wrapper
+        return decorator
+
+    def on_message_media(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            def wrapper(bot, message: Message):
+                if not message.is_media:
+                    return
+                if filters and not filters(message):
+                    return
+                return func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "media_only": True,
+                "commands":commands
+            })
+            return wrapper
+        return decorator
+
+    def on_message_sticker(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            def wrapper(bot, message: Message):
+                if not message.sticker:
+                    return
+                if filters and not filters(message):
+                    return
+                return func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "sticker_only": True,
+                "commands":commands
+            })
+            return wrapper
+        return decorator
+
+    def on_message_contact(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            def wrapper(bot, message: Message):
+                if not message.is_contact:
+                    return
+                if filters and not filters(message):
+                    return
+                return func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "contact_only": True,
+                "commands":commands
+            })
+            return wrapper
+        return decorator
+
+    def on_message_location(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            def wrapper(bot, message: Message):
+                if not message.is_location:
+                    return
+                if filters and not filters(message):
+                    return
+                return func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "location_only": True,
+                "commands":commands
+            })
+            return wrapper
+        return decorator
+
+    def on_message_poll(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            def wrapper(bot, message: Message):
+                if not message.is_poll:
+                    return
+                if filters and not filters(message):
+                    return
+                return func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "poll_only": True,
+                "commands":commands
+            })
+            return wrapper
+        return decorator
+
     def message_handler(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
         def decorator(func: Callable[[Any, Message], None]):
             self._message_handlers.append({

rubka/asynco.py

@@ -218,6 +218,9 @@ class Robot:
             raise InvalidTokenError("The provided bot token is invalid or expired.")
     from typing import Callable, Any, Optional, List
 
+
+#decorator#
+
     def on_message_private(
         self,
         chat_id: Optional[Union[str, List[str]]] = None,   
@@ -247,30 +250,20 @@ class Robot:
                 
                 if not message.is_private:
                     return
-
-                
                 if chat_id:
                     if isinstance(chat_id, str) and message.chat_id != chat_id:
                         return
                     if isinstance(chat_id, list) and message.chat_id not in chat_id:
                         return
-
-                
                 if sender_id:
                     if isinstance(sender_id, str) and message.sender_id != sender_id:
                         return
                     if isinstance(sender_id, list) and message.sender_id not in sender_id:
                         return
-
-                
                 if sender_type and message.sender_type != sender_type:
                     return
-
-                
                 if not allow_forwarded and message.forwarded_from:
                     return
-
-                
                 if not allow_files and message.file:
                     return
                 if not allow_stickers and message.sticker:
@@ -543,6 +536,142 @@ class Robot:
             })
             return func
         return decorator
+    
+    def on_message_file(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            async def wrapper(bot, message: Message):
+                if not message.file:return
+                if filters and not filters(message):return
+                return await func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "file_only": True,
+                "commands": commands
+            })
+            return wrapper
+        return decorator
+    def on_message_forwarded(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            async def wrapper(bot, message: Message):
+                if not message.is_forwarded:return
+                if filters and not filters(message):return
+                return await func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "forwarded_only": True,
+                "commands": commands
+            })
+            return wrapper
+        return decorator
+    def on_message_reply(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            async def wrapper(bot, message: Message):
+                if not message.is_reply:return
+                if filters and not filters(message):return
+                return await func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "reply_only": True,
+                "commands": commands
+            })
+            return wrapper
+        return decorator
+    def on_message_text(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            async def wrapper(bot, message: Message):
+                if not message.text:return
+                if filters and not filters(message):return
+                return await func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "text_only": True,
+                "commands": commands
+            })
+            return wrapper
+        return decorator
+    def on_message_media(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            async def wrapper(bot, message: Message):
+                if not message.is_media:return
+                if filters and not filters(message):return
+                return await func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "media_only": True,
+                "commands": commands
+            })
+            return wrapper
+        return decorator
+    def on_message_sticker(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            async def wrapper(bot, message: Message):
+                if not message.sticker:return
+                if filters and not filters(message):return
+                return await func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "sticker_only": True,
+                "commands": commands
+            })
+            return wrapper
+        return decorator
+    def on_message_contact(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            async def wrapper(bot, message: Message):
+                if not message.is_contact:return
+                if filters and not filters(message):return
+                return await func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "contact_only": True,
+                "commands": commands
+            })
+            return wrapper
+        return decorator
+    def on_message_location(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            async def wrapper(bot, message: Message):
+                if not message.is_location:return
+                if filters and not filters(message):return
+                return await func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "location_only": True,
+                "commands": commands
+            })
+            return wrapper
+        return decorator
+    def on_message_poll(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+        def decorator(func: Callable[[Any, Message], None]):
+            async def wrapper(bot, message: Message):
+                if not message.is_poll:return
+                if filters and not filters(message):return
+                return await func(bot, message)
+
+            self._message_handlers.append({
+                "func": wrapper,
+                "filters": filters,
+                "poll_only": True,
+                "commands": commands
+            })
+            return wrapper
+        return decorator
     def on_update(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
         def decorator(func: Callable[[Any, Message], None]):
             self._message_handlers.append({
@@ -1516,7 +1645,6 @@ class Robot:
                 json_data = await response.json()
                 if is_temp_file:
                     os.remove(path)
-                print(json_data)
                 return json_data.get('data', {}).get('file_id')
         except :
             raise FeatureNotAvailableError(f"files is not currently supported by the server.")
@@ -1642,7 +1770,7 @@ class Robot:
             "inline_keypad":inline_keypad,
             "chat_keypad_type":chat_keypad_type
         }
-        return json.dumps(result, ensure_ascii=False, indent=4)
+        return result
 
     async def _send_file_generic(self, media_type, chat_id, path, file_id, text, file_name, inline_keypad, chat_keypad, reply_to_message_id, disable_notification, chat_keypad_type):
         if path:
@@ -1702,13 +1830,19 @@ class Robot:
         try:
             chat = await self.get_chat(chat_id)
             chat_info = chat.get("data", {}).get("chat", {})
-            first_name = chat_info.get("first_name", "")
-            last_name = chat_info.get("last_name", "")
-            
-            full_name = f"{first_name} {last_name}".strip()
-            return full_name if full_name else "Unknown"
-        except Exception:
-            return "Unknown"
+            chat_type = chat_info.get("chat_type", "").lower()
+            if chat_type == "user":
+                first_name = chat_info.get("first_name", "")
+                last_name = chat_info.get("last_name", "")
+                full_name = f"{first_name} {last_name}".strip()
+                return full_name if full_name else "null"
+            elif chat_type in ["group", "channel"]:
+                title = chat_info.get("title", "")
+                return title if title else "null"
+            else:return "null"
+        except Exception:return "null"
+
+    
 
     async def get_username(self, chat_id: str) -> str:
         chat_info = await self.get_chat(chat_id)

rubka/context.py

@@ -190,8 +190,10 @@ from pathlib import Path
 class Message:
     def __init__(self, bot, chat_id, message_id, sender_id, text=None, raw_data=None):
         self.bot = bot
-        self.chat_id = chat_id
         self.raw_data = raw_data or {}
+        self.chat_id = chat_id
+        self.object_guid = chat_id
+        self.author_guid  = self.raw_data.get("sender_id", sender_id)
         self.message_id: str = self.raw_data.get("message_id", message_id)
         self.text: str = self.raw_data.get("text", text)
         self.sender_id: str = self.raw_data.get("sender_id", sender_id)
@@ -199,6 +201,7 @@ class Message:
         self.is_edited: bool = self.raw_data.get("is_edited", False)
         self.sender_type: str = self.raw_data.get("sender_type")
         self.args = []
+        self.is_command = bool(self.text and self.text.startswith("/"))
         self.is_user = self.chat_id.startswith("b")
         self.is_private = self.chat_id.startswith("b")
         self.is_group = self.chat_id.startswith("g")
@@ -212,7 +215,18 @@ class Message:
         self.location = Location(self.raw_data["location"]) if "location" in self.raw_data else None
         self.live_location = LiveLocation(self.raw_data["live_location"]) if "live_location" in self.raw_data else None
         self.aux_data = AuxData(self.raw_data["aux_data"]) if "aux_data" in self.raw_data else None
-
+        self.is_reply = self.reply_to_message_id is not None
+        self.has_media = any([self.file, self.sticker, self.poll, self.location, self.live_location])
+        self.is_forwarded = self.forwarded_from is not None
+        self.is_text = bool(self.text and not self.has_media)
+        self.is_media = self.has_media
+        self.is_poll = self.poll is not None
+        self.is_location = self.location is not None
+        self.is_live_location = self.live_location is not None
+        self.is_contact = self.contact_message is not None
+        self.has_any_media = any([self.file, self.sticker, self.poll, self.location, self.live_location])
+        self.edited_text = self.raw_data.get("edited_text") if self.is_edited else None
+        self.info = {attr: value for attr, value in vars(self).items()}
     @property
     def session(self):
         if self.chat_id not in self.bot.sessions:

rubka/update.py

@@ -190,8 +190,10 @@ from pathlib import Path
 class Message:
     def __init__(self, bot, chat_id, message_id, sender_id, text=None, raw_data=None):
         self.bot = bot
-        self.chat_id = chat_id
         self.raw_data = raw_data or {}
+        self.chat_id = chat_id
+        self.object_guid = chat_id
+        self.author_guid  = self.raw_data.get("sender_id", sender_id)
         self.message_id: str = self.raw_data.get("message_id", message_id)
         self.text: str = self.raw_data.get("text", text)
         self.sender_id: str = self.raw_data.get("sender_id", sender_id)
@@ -199,6 +201,7 @@ class Message:
         self.is_edited: bool = self.raw_data.get("is_edited", False)
         self.sender_type: str = self.raw_data.get("sender_type")
         self.args = []
+        self.is_command = bool(self.text and self.text.startswith("/"))
         self.is_user = self.chat_id.startswith("b")
         self.is_private = self.chat_id.startswith("b")
         self.is_group = self.chat_id.startswith("g")
@@ -212,7 +215,18 @@ class Message:
         self.location = Location(self.raw_data["location"]) if "location" in self.raw_data else None
         self.live_location = LiveLocation(self.raw_data["live_location"]) if "live_location" in self.raw_data else None
         self.aux_data = AuxData(self.raw_data["aux_data"]) if "aux_data" in self.raw_data else None
-
+        self.is_reply = self.reply_to_message_id is not None
+        self.has_media = any([self.file, self.sticker, self.poll, self.location, self.live_location])
+        self.is_forwarded = self.forwarded_from is not None
+        self.is_text = bool(self.text and not self.has_media)
+        self.is_media = self.has_media
+        self.is_poll = self.poll is not None
+        self.is_location = self.location is not None
+        self.is_live_location = self.live_location is not None
+        self.is_contact = self.contact_message is not None
+        self.has_any_media = any([self.file, self.sticker, self.poll, self.location, self.live_location])
+        self.edited_text = self.raw_data.get("edited_text") if self.is_edited else None
+        self.info = {attr: value for attr, value in vars(self).items()}
     @property
     def session(self):
         if self.chat_id not in self.bot.sessions:

{rubka-6.4.6.dist-info → rubka-6.4.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Rubka
-Version: 6.4.6
+Version: 6.4.8
 Summary: A Python library for interacting with Rubika Bot API.
 Home-page: https://github.com/Mahdy-Ahmadi/Rubka
 Download-URL: https://github.com/Mahdy-Ahmadi/rubka/blob/main/project_library.zip

{rubka-6.4.6.dist-info → rubka-6.4.8.dist-info}/RECORD

@@ -1,9 +1,9 @@
 rubka/__init__.py,sha256=TR1DABU5Maz2eO62ZEFiwOqNU0dH6l6HZfqRUxeo4eY,194
-rubka/api.py,sha256=o5YM_KnDdoS0GRKYAXjy9d3xij2gdgmaDmn18ht9cok,61898
-rubka/asynco.py,sha256=CcqSxKvfA1JSG1UDVn78GnImLS0LDdUic2xqCXK_9Cw,77829
+rubka/api.py,sha256=J0fa4XXjImFulLXAaJY2pbE46e03i-Y5QggxaAZq6xw,68159
+rubka/asynco.py,sha256=wiuw2oLaYH5a99W7_37sjP29hXabAbThnkLk1sPIzUk,83919
 rubka/button.py,sha256=vU9OvWXCD4MRrTJ8Xmivd4L471-06zrD2qpZBTw5vjY,13305
 rubka/config.py,sha256=Bck59xkOiqioLv0GkQ1qPGnBXVctz1hKk6LT4h2EPx0,78
-rubka/context.py,sha256=2HWMy5yaPWE0lJFjRkVzG-8wUgPyugRHz25t4hpF0Ko,18341
+rubka/context.py,sha256=4YZs7DiZD_HWOqY76hwwajG0J-bLy6wjeKtQT3EatZU,19341
 rubka/decorators.py,sha256=hGwUoE4q2ImrunJIGJ_kzGYYxQf1ueE0isadqraKEts,1157
 rubka/exceptions.py,sha256=tujZt1XrhWaw-lmdeVadVceUptpw4XzNgE44sAAY0gs,90
 rubka/jobs.py,sha256=GvLMLsVhcSEzRTgkvnPISPEBN71suW2xXI0hUaUZPTo,378
@@ -11,7 +11,7 @@ rubka/keyboards.py,sha256=7nr-dT2bQJVQnQ6RMWPTSjML6EEk6dsBx-4d8pab8xk,488
 rubka/keypad.py,sha256=yGsNt8W5HtUFBzVF1m_p7GySlu1hwIcSvXZ4BTdrlvg,9558
 rubka/logger.py,sha256=J2I6NiK1z32lrAzC4H1Et6WPMBXxXGCVUsW4jgcAofs,289
 rubka/rubino.py,sha256=uOhvljK_tms_767pX1TSxryyq71rKDyCgiv36ssNXEg,56674
-rubka/update.py,sha256=2HWMy5yaPWE0lJFjRkVzG-8wUgPyugRHz25t4hpF0Ko,18341
+rubka/update.py,sha256=4YZs7DiZD_HWOqY76hwwajG0J-bLy6wjeKtQT3EatZU,19341
 rubka/utils.py,sha256=XUQUZxQt9J2f0X5hmAH_MH1kibTAfdT1T4AaBkBhBBs,148
 rubka/adaptorrubka/__init__.py,sha256=6o2tCXnVeES7nx-LjnzsuMqjKcWIm9qwKficLE54s-U,83
 rubka/adaptorrubka/enums.py,sha256=cyiakExmZi-QQpYuf_A93HQvfZVmyG_0uVuvTTNT5To,1053
@@ -34,7 +34,7 @@ rubka/adaptorrubka/types/socket/message.py,sha256=0WgLMZh4eow8Zn7AiSX4C3GZjQTkIg
 rubka/adaptorrubka/utils/__init__.py,sha256=OgCFkXdNFh379quNwIVOAWY2NP5cIOxU5gDRRALTk4o,54
 rubka/adaptorrubka/utils/configs.py,sha256=nMUEOJh1NqDJsf9W9PurkN_DLYjO6kKPMm923i4Jj_A,492
 rubka/adaptorrubka/utils/utils.py,sha256=5-LioLNYX_TIbQGDeT50j7Sg9nAWH2LJUUs-iEXpsUY,8816
-rubka-6.4.6.dist-info/METADATA,sha256=tQy-9qciKVwDM4aLWdhR13Tkc-SLf1FxpsgLxRh0gKQ,33335
-rubka-6.4.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-rubka-6.4.6.dist-info/top_level.txt,sha256=vy2A4lot11cRMdQS-F4HDCIXL3JK8RKfu7HMDkezJW4,6
-rubka-6.4.6.dist-info/RECORD,,
+rubka-6.4.8.dist-info/METADATA,sha256=2FefyxguhKHS07vKRgGlhhzHBi9ojoGe0U9ymQvDNTg,33335
+rubka-6.4.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rubka-6.4.8.dist-info/top_level.txt,sha256=vy2A4lot11cRMdQS-F4HDCIXL3JK8RKfu7HMDkezJW4,6
+rubka-6.4.8.dist-info/RECORD,,