Rubka 6.6.4__py3-none-any.whl → 6.6.8__py3-none-any.whl

rubka/__init__.py

@@ -1,6 +1,75 @@
+"""
+🔹 Synchronous Example
+```python
+from rubka import Robot, Message
+
+bot = Robot(token="YOUR_BOT_TOKEN")
+
+@bot.on_message(commands=["start", "help"])
+def handle_start(bot: Robot, message: Message):
+    message.reply("👋 Hello! Welcome to the Rubka bot (sync example).")
+
+bot.run()
+```
+
+Explanation
+
+Robot is created with your bot token.
+@bot.on_message registers a handler for incoming messages.
+
+The function handle_start runs synchronously (step by step, blocking).
+
+message.reply sends a message back to the user immediately.
+
+Finally, bot.run() starts the event loop and keeps the bot running.
+
+This approach is simpler and best for small bots or basic logic where you don’t need concurrency.
+
+🔹 Asynchronous Example
+```python
+import asyncio
+from rubka.asynco import Robot, Message
+
+bot = Robot(token="YOUR_BOT_TOKEN")
+
+@bot.on_message(commands=["start", "help"])
+async def handle_start(bot: Robot, message: Message):
+    await message.reply("⚡ Hello! This is the async version of Rubka.")
+
+async def main():
+    await bot.run()
+
+asyncio.run(main())
+```
+Explanation
+
+Uses rubka.asynco.Robot for asynchronous operation.
+
+The handler handle_start is defined with async def.
+
+await message.reply(...) is non-blocking: the bot can process other tasks while waiting for Rubika’s response.
+
+asyncio.run(main()) starts the async event loop.
+
+This approach is more powerful and recommended for larger bots or when you:
+
+Need to call external APIs.
+
+Handle multiple long-running tasks.
+
+Want better performance and scalability.
+
+👉 In short:
+
+Sync = simple, step-by-step, blocking.
+
+Async = scalable, concurrent, non-blocking.
+"""
+
 from .api import Robot
 from .rubino import Bot
 from .exceptions import APIRequestError
+from .rubino import Bot as rubino
 
 __all__ = [
     "Robot",

rubka/api.py

@@ -4,6 +4,7 @@ from .exceptions import APIRequestError
 from .adaptorrubka import Client as Client_get
 from .logger import logger
 from . import filters
+from . import helpers
 from typing import Callable
 from .context import Message,InlineMessage
 from typing import Optional, Union, Literal, Dict, Any

rubka/asynco.py

@@ -1666,16 +1666,103 @@ class Robot:
         return await self._send_file_generic("File", chat_id, path, file_id, caption, file_name, inline_keypad, chat_keypad, reply_to_message_id, disable_notification, chat_keypad_type)
     async def re_send(self, chat_id: str, path: Optional[Union[str, Path]] = None, file_id: Optional[str] = None, caption: Optional[str] = None, file_name: Optional[str] = None, inline_keypad: Optional[Dict[str, Any]] = None, chat_keypad: Optional[Dict[str, Any]] = None, reply_to_message_id: Optional[str] = None, disable_notification: bool = False, chat_keypad_type: Optional[Literal["New", "Removed", "None"]] = "None") -> Dict[str, Any]:
         return await self._send_file_generic("File", chat_id, path, file_id, caption, file_name, inline_keypad, chat_keypad, reply_to_message_id, disable_notification, chat_keypad_type)  
-    async def send_music(self, chat_id: str, path: Optional[Union[str, Path]] = None, file_id: Optional[str] = None, text: Optional[str] = None, file_name: Optional[str] = "music", inline_keypad: Optional[Dict[str, Any]] = None, chat_keypad: Optional[Dict[str, Any]] = None, reply_to_message_id: Optional[str] = None, disable_notification: bool = False, chat_keypad_type: Optional[Literal["New", "Removed", "None"]] = "None") -> Dict[str, Any]:
-        return await self._send_file_generic("File", chat_id, path, file_id, text, f"{file_name}.ogg", inline_keypad, chat_keypad, reply_to_message_id, disable_notification, chat_keypad_type)
+    
+    async def send_music(
+    self,
+    chat_id: str,
+    path: Optional[Union[str, Path]] = None,
+    file_id: Optional[str] = None,
+    text: Optional[str] = None,
+    file_name: Optional[str] = None,
+    inline_keypad: Optional[Dict[str, Any]] = None,
+    chat_keypad: Optional[Dict[str, Any]] = None,
+    reply_to_message_id: Optional[str] = None,
+    disable_notification: bool = False,
+    chat_keypad_type: Optional[Literal["New", "Removed", "None"]] = "None"
+    ) -> Dict[str, Any]:
+        valid_extensions = {"ogg", "oga", "opus", "flac"}
+        extension = "flac"
+        if path:
+            path_str = str(path)
+            if path_str.startswith("http://") or path_str.startswith("https://"):
+                parsed = urlparse(path_str)
+                base_name = os.path.basename(parsed.path)
+            else:
+                base_name = os.path.basename(path_str)
+            name, ext = os.path.splitext(base_name)
+
+            if file_name is None or not file_name.strip():
+                file_name = name or "music"
+            ext = ext.lower().replace(".", "")
+            if ext in valid_extensions:
+                extension = ext
+        else:
+            if file_name is None:
+                file_name = "music"
+        return await self._send_file_generic(
+            "File",
+            chat_id,
+            path,
+            file_id,
+            text,
+            f"{file_name}.{extension}",
+            inline_keypad,
+            chat_keypad,
+            reply_to_message_id,
+            disable_notification,
+            chat_keypad_type
+        )
     async def send_video(self, chat_id: str, path: Optional[Union[str, Path]] = None, file_id: Optional[str] = None, text: Optional[str] = None, file_name: Optional[str] = None, inline_keypad: Optional[Dict[str, Any]] = None, chat_keypad: Optional[Dict[str, Any]] = None, reply_to_message_id: Optional[str] = None, disable_notification: bool = False, chat_keypad_type: Optional[Literal["New", "Removed", "None"]] = "None") -> Dict[str, Any]:
         return await self._send_file_generic("Video", chat_id, path, file_id, text, file_name, inline_keypad, chat_keypad, reply_to_message_id, disable_notification, chat_keypad_type)
     async def send_voice(self, chat_id: str, path: Optional[Union[str, Path]] = None, file_id: Optional[str] = None, text: Optional[str] = None, file_name: Optional[str] = None, inline_keypad: Optional[Dict[str, Any]] = None, chat_keypad: Optional[Dict[str, Any]] = None, reply_to_message_id: Optional[str] = None, disable_notification: bool = False, chat_keypad_type: Optional[Literal["New", "Removed", "None"]] = "None") -> Dict[str, Any]:
         return await self._send_file_generic("voice", chat_id, path, file_id, text, file_name, inline_keypad, chat_keypad, reply_to_message_id, disable_notification, chat_keypad_type)
     async def send_image(self, chat_id: str, path: Optional[Union[str, Path]] = None, file_id: Optional[str] = None, text: Optional[str] = None, file_name: Optional[str] = None, inline_keypad: Optional[Dict[str, Any]] = None, chat_keypad: Optional[Dict[str, Any]] = None, reply_to_message_id: Optional[str] = None, disable_notification: bool = False, chat_keypad_type: Optional[Literal["New", "Removed", "None"]] = "None") -> Dict[str, Any]:
         return await self._send_file_generic("Image", chat_id, path, file_id, text, file_name, inline_keypad, chat_keypad, reply_to_message_id, disable_notification, chat_keypad_type)
-    async def send_gif(self, chat_id: str, path: Optional[Union[str, Path]] = None, file_id: Optional[str] = None, text: Optional[str] = None, file_name: Optional[str] = None, inline_keypad: Optional[Dict[str, Any]] = None, chat_keypad: Optional[Dict[str, Any]] = None, reply_to_message_id: Optional[str] = None, disable_notification: bool = False, chat_keypad_type: Optional[Literal["New", "Removed", "None"]] = "None") -> Dict[str, Any]:
-        return await self._send_file_generic("Gif", chat_id, path, file_id, text, file_name, inline_keypad, chat_keypad, reply_to_message_id, disable_notification, chat_keypad_type)
+    async def send_gif(
+    self,
+    chat_id: str,
+    path: Optional[Union[str, Path]] = None,
+    file_id: Optional[str] = None,
+    text: Optional[str] = None,
+    file_name: Optional[str] = None,
+    inline_keypad: Optional[Dict[str, Any]] = None,
+    chat_keypad: Optional[Dict[str, Any]] = None,
+    reply_to_message_id: Optional[str] = None,
+    disable_notification: bool = False,
+    chat_keypad_type: Optional[Literal["New", "Removed", "None"]] = "None"
+    ) -> Dict[str, Any]:
+        valid_extensions = {"gif"}
+        extension = "gif"
+        if path:
+            path_str = str(path)
+            if path_str.startswith("http://") or path_str.startswith("https://"):
+                parsed = urlparse(path_str)
+                base_name = os.path.basename(parsed.path)
+            else:
+                base_name = os.path.basename(path_str)
+            name, ext = os.path.splitext(base_name)
+
+            if file_name is None or not file_name.strip():
+                file_name = name or "gif"
+            ext = ext.lower().replace(".", "")
+            if ext in valid_extensions:
+                extension = ext
+        else:
+            if file_name is None:
+                file_name = "gif"
+        return await self._send_file_generic(
+            "File",
+            chat_id,
+            path,
+            file_id,
+            text,
+            f"{file_name}.{extension}",
+            inline_keypad,
+            chat_keypad,
+            reply_to_message_id,
+            disable_notification,
+            chat_keypad_type
+        )
     async def forward_message(self, from_chat_id: str, message_id: str, to_chat_id: str, disable_notification: bool = False) -> Dict[str, Any]:
         return await self._post("forwardMessage", {"from_chat_id": from_chat_id, "message_id": message_id, "to_chat_id": to_chat_id, "disable_notification": disable_notification})
     async def edit_message_text(self, chat_id: str, message_id: str, text: str) -> Dict[str, Any]: