Rubka 4.6.2__tar.gz → 5.0.0__tar.gz

{rubka-4.6.2 → rubka-5.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Rubka
-Version: 4.6.2
+Version: 5.0.0
 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-4.6.2 → rubka-5.0.0}/Rubka.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Rubka
-Version: 4.6.2
+Version: 5.0.0
 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-4.6.2 → rubka-5.0.0}/rubka/api.py

@@ -172,6 +172,15 @@ class Robot:
             })
             return func
         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({
+                "func": func,
+                "filters": filters,
+                "commands": commands
+            })
+            return func
+        return decorator
 
     def on_callback(self, button_id: Optional[str] = None):
         def decorator(func: Callable[[Any, Message], None]):

{rubka-4.6.2 → rubka-5.0.0}/rubka/asynco.py

@@ -196,6 +196,15 @@ class Robot:
             })
             return func
         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({
+                "func": func,
+                "filters": filters,
+                "commands": commands
+            })
+            return func
+        return decorator
 
     def on_callback(self, button_id: Optional[str] = None):
         def decorator(func: Callable[[Any, Message], None]):

{rubka-4.6.2 → rubka-5.0.0}/rubka/button.py

@@ -16,6 +16,115 @@ class InlineBuilder:
             raise ValueError("حداقل یک دکمه باید به row داده شود")
         self.rows.append({"buttons": list(buttons)})
         return self
+    def button_open_chat(self, id: str, text: str, object_guid: str, object_type: str ="User") -> Dict:
+        return {
+            "id": id,
+            "type": 'Link', 
+            "button_text": text,
+            "button_link": {
+                "type": 'openchat', 
+                "open_chat_data": {
+                    "object_guid": object_guid,
+                    "object_type": object_type 
+                }
+            }
+        }
+    def button_join_channel(self, id: str, text: str, username: str, ask_join: bool = False) -> Dict:
+        """
+        Creates an inline button that prompts the user to join a Rubika channel.
+
+        Args:
+            id (str): Unique identifier for the button (used for event handling).
+            text (str): The text displayed on the button.
+            username (str): The channel username (can be with or without '@').
+            ask_join (bool, optional): If True, the user will be prompted with a 
+                                    confirmation dialog before joining. 
+                                    Defaults to False.
+
+        Returns:
+            dict: A dictionary representing the inline button, which can be passed
+                to inline keyboard builder methods.
+
+        Example:
+            ```python
+            from rubka.button import InlineBuilder
+
+            buttons = (
+                InlineBuilder()
+                .row(
+                    InlineBuilder().button_join_channel(
+                        id="join_btn",
+                        text="Join our channel 📢",
+                        username="rubka_library",
+                        ask_join=True
+                    )
+                )
+                .build()
+            )
+
+            await message.reply_inline(
+                text="Please join our channel before using the bot.",
+                inline_keypad=buttons
+            )
+            ```
+        """
+        return {
+            "id": id,
+            "type": 'Link', 
+            "button_text": text,
+            "button_link": {
+                "type": 'joinchannel', 
+                "joinchannel_data": {
+                    "username": username.replace("@", ""),
+                    "ask_join": ask_join
+                }
+            }
+        }
+
+    def button_url_link(self, id: str, text: str, url: str) -> Dict:
+        """
+        Creates an inline button that opens a given URL when clicked.
+
+        Args:
+            id (str): Unique identifier for the button (used for event handling if needed).
+            text (str): The text displayed on the button.
+            url (str): The destination URL that will be opened when the button is clicked.
+
+        Returns:
+            dict: A dictionary representing the inline button, which can be passed
+                to inline keyboard builder methods.
+
+        Example:
+            ```python
+            from rubka.button import InlineBuilder
+
+            buttons = (
+                InlineBuilder()
+                .row(
+                    InlineBuilder().button_url_link(
+                        id="website_btn",
+                        text="Visit our website 🌐",
+                        url="https://api-free.ir"
+                    )
+                )
+                .build()
+            )
+
+            await message.reply_inline(
+                text="Click the button below to visit our website.",
+                inline_keypad=buttons
+            )
+            ```
+        """
+        return {
+            "id": id,
+            "type": 'Link', 
+            "button_text": text,
+            "button_link": {
+                "type": 'url', 
+                "link_url": url
+            }
+        }
 
     def button_simple(self, id: str, text: str) -> Dict:
         return {"id": id, "type": "Simple", "button_text": text}

{rubka-4.6.2 → rubka-5.0.0}/setup.py

@@ -8,7 +8,7 @@ except FileNotFoundError:
 
 setup(
     name='Rubka',
-    version='4.6.2',
+    version='5.0.0',
     description='A Python library for interacting with Rubika Bot API.',
     long_description=long_description,
     long_description_content_type='text/markdown',