Rubka 6.4.8__tar.gz → 7.1.15__tar.gz

{rubka-6.4.8 → rubka-7.1.15}/PKG-INFO

@@ -1,27 +1,39 @@
 Metadata-Version: 2.4
 Name: Rubka
-Version: 6.4.8
-Summary: A Python library for interacting with Rubika Bot API.
+Version: 7.1.15
+Summary: Rubika: A Python library for interacting with the Rubika Bot API. This library provides an easy-to-use interface to send messages, polls, stickers, media files, manage groups and channels, handle inline keyboards, and implement advanced bot features like subscription management, user authentication, and message handling. Ideal for developers looking to automate and extend their Rubika bots with Python.
 Home-page: https://github.com/Mahdy-Ahmadi/Rubka
-Download-URL: https://github.com/Mahdy-Ahmadi/rubka/blob/main/project_library.zip
+Download-URL: https://github.com/Mahdy-Ahmadi/rubka/archive/refs/tags/v6.6.4.zip
 Author: Mahdi Ahmadi
 Author-email: mahdiahmadi.1208@gmail.com
 Maintainer: Mahdi Ahmadi
 Maintainer-email: mahdiahmadi.1208@gmail.com
+License: MIT
+Project-URL: Bug Tracker, https://t.me/Bprogrammer
+Project-URL: Documentation, https://github.com/Mahdy-Ahmadi/rubka/blob/main/README.md
+Project-URL: Source Code, https://github.com/Mahdy-Ahmadi/Rubka
+Keywords: rubika bot api library chat messaging rubpy pyrubi rubigram rubika_bot rubika_api fast_rub
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Communications :: Chat
 Classifier: Topic :: Software Development :: Libraries
+Classifier: Natural Language :: Persian
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 Requires-Dist: requests
-Requires-Dist: Pillow
 Requires-Dist: websocket-client
 Requires-Dist: pycryptodome
 Requires-Dist: aiohttp
+Requires-Dist: httpx
 Requires-Dist: tqdm
 Requires-Dist: mutagen
+Requires-Dist: markdownify
 Requires-Dist: filetype
 Requires-Dist: aiofiles
 Dynamic: author
@@ -31,12 +43,18 @@ Dynamic: description
 Dynamic: description-content-type
 Dynamic: download-url
 Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
 Dynamic: maintainer
 Dynamic: maintainer-email
+Dynamic: project-url
 Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
+# وبسایت کتابخونه / نمونه کد ها / وب هوک رایگان
+برای مشاهده مستندات کامل و وب هوک رایگان به آدرس زیر مراجعه کنید:  
+[rubka.ir](rubka.ir)
 # 📚 Rubka Bot Python Library Documentation
 # نمونه تنظیم وب‌هوک (Webhook) در کتابخونه rubla
 
@@ -62,16 +80,16 @@ If `importlib.metadata` is not available, it installs `importlib-metadata` autom
 ## 🚀 Getting Started
 
 ```python
-from rubka import Robot
+from rubka.asynco import Robot
 from rubka.context import Message
-
+import asyncio
 bot = Robot(token="YOUR_TOKEN_HERE")
 
 @bot.on_message(commands=["start"])
-def start(bot: Robot, message: Message):
-    message.reply("سلام! خوش آمدید!")
+async def start(bot: Robot, message: Message):
+    await message.reply("سلام! خوش آمدید!")
 
-bot.run()
+asyncio.run(bot.run())
 ```
 
 ---
@@ -82,8 +100,8 @@ You can handle incoming text messages using `@bot.on_message()`:
 
 ```python
 @bot.on_message(commands=["hello"])
-def greet(bot: Robot, message: Message):
-    message.reply("سلام کاربر عزیز 👋")
+async def greet(bot: Robot, message: Message):
+   await message.reply("سلام کاربر عزیز 👋")
 ```
 
 You can also add filters.

{rubka-6.4.8 → rubka-7.1.15}/README.md

@@ -1,3 +1,6 @@
+# وبسایت کتابخونه / نمونه کد ها / وب هوک رایگان
+برای مشاهده مستندات کامل و وب هوک رایگان به آدرس زیر مراجعه کنید:  
+[rubka.ir](rubka.ir)
 # 📚 Rubka Bot Python Library Documentation
 # نمونه تنظیم وب‌هوک (Webhook) در کتابخونه rubla
 
@@ -23,16 +26,16 @@ If `importlib.metadata` is not available, it installs `importlib-metadata` autom
 ## 🚀 Getting Started
 
 ```python
-from rubka import Robot
+from rubka.asynco import Robot
 from rubka.context import Message
-
+import asyncio
 bot = Robot(token="YOUR_TOKEN_HERE")
 
 @bot.on_message(commands=["start"])
-def start(bot: Robot, message: Message):
-    message.reply("سلام! خوش آمدید!")
+async def start(bot: Robot, message: Message):
+    await message.reply("سلام! خوش آمدید!")
 
-bot.run()
+asyncio.run(bot.run())
 ```
 
 ---
@@ -43,8 +46,8 @@ You can handle incoming text messages using `@bot.on_message()`:
 
 ```python
 @bot.on_message(commands=["hello"])
-def greet(bot: Robot, message: Message):
-    message.reply("سلام کاربر عزیز 👋")
+async def greet(bot: Robot, message: Message):
+   await message.reply("سلام کاربر عزیز 👋")
 ```
 
 You can also add filters.

{rubka-6.4.8 → rubka-7.1.15}/Rubka.egg-info/PKG-INFO

@@ -1,27 +1,39 @@
 Metadata-Version: 2.4
 Name: Rubka
-Version: 6.4.8
-Summary: A Python library for interacting with Rubika Bot API.
+Version: 7.1.15
+Summary: Rubika: A Python library for interacting with the Rubika Bot API. This library provides an easy-to-use interface to send messages, polls, stickers, media files, manage groups and channels, handle inline keyboards, and implement advanced bot features like subscription management, user authentication, and message handling. Ideal for developers looking to automate and extend their Rubika bots with Python.
 Home-page: https://github.com/Mahdy-Ahmadi/Rubka
-Download-URL: https://github.com/Mahdy-Ahmadi/rubka/blob/main/project_library.zip
+Download-URL: https://github.com/Mahdy-Ahmadi/rubka/archive/refs/tags/v6.6.4.zip
 Author: Mahdi Ahmadi
 Author-email: mahdiahmadi.1208@gmail.com
 Maintainer: Mahdi Ahmadi
 Maintainer-email: mahdiahmadi.1208@gmail.com
+License: MIT
+Project-URL: Bug Tracker, https://t.me/Bprogrammer
+Project-URL: Documentation, https://github.com/Mahdy-Ahmadi/rubka/blob/main/README.md
+Project-URL: Source Code, https://github.com/Mahdy-Ahmadi/Rubka
+Keywords: rubika bot api library chat messaging rubpy pyrubi rubigram rubika_bot rubika_api fast_rub
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Communications :: Chat
 Classifier: Topic :: Software Development :: Libraries
+Classifier: Natural Language :: Persian
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 Requires-Dist: requests
-Requires-Dist: Pillow
 Requires-Dist: websocket-client
 Requires-Dist: pycryptodome
 Requires-Dist: aiohttp
+Requires-Dist: httpx
 Requires-Dist: tqdm
 Requires-Dist: mutagen
+Requires-Dist: markdownify
 Requires-Dist: filetype
 Requires-Dist: aiofiles
 Dynamic: author
@@ -31,12 +43,18 @@ Dynamic: description
 Dynamic: description-content-type
 Dynamic: download-url
 Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
 Dynamic: maintainer
 Dynamic: maintainer-email
+Dynamic: project-url
 Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
+# وبسایت کتابخونه / نمونه کد ها / وب هوک رایگان
+برای مشاهده مستندات کامل و وب هوک رایگان به آدرس زیر مراجعه کنید:  
+[rubka.ir](rubka.ir)
 # 📚 Rubka Bot Python Library Documentation
 # نمونه تنظیم وب‌هوک (Webhook) در کتابخونه rubla
 
@@ -62,16 +80,16 @@ If `importlib.metadata` is not available, it installs `importlib-metadata` autom
 ## 🚀 Getting Started
 
 ```python
-from rubka import Robot
+from rubka.asynco import Robot
 from rubka.context import Message
-
+import asyncio
 bot = Robot(token="YOUR_TOKEN_HERE")
 
 @bot.on_message(commands=["start"])
-def start(bot: Robot, message: Message):
-    message.reply("سلام! خوش آمدید!")
+async def start(bot: Robot, message: Message):
+    await message.reply("سلام! خوش آمدید!")
 
-bot.run()
+asyncio.run(bot.run())
 ```
 
 ---
@@ -82,8 +100,8 @@ You can handle incoming text messages using `@bot.on_message()`:
 
 ```python
 @bot.on_message(commands=["hello"])
-def greet(bot: Robot, message: Message):
-    message.reply("سلام کاربر عزیز 👋")
+async def greet(bot: Robot, message: Message):
+   await message.reply("سلام کاربر عزیز 👋")
 ```
 
 You can also add filters.

{rubka-6.4.8 → rubka-7.1.15}/Rubka.egg-info/SOURCES.txt

@@ -3,6 +3,8 @@ setup.py
 Rubka.egg-info/PKG-INFO
 Rubka.egg-info/SOURCES.txt
 Rubka.egg-info/dependency_links.txt
+Rubka.egg-info/entry_points.txt
+Rubka.egg-info/not-zip-safe
 Rubka.egg-info/requires.txt
 Rubka.egg-info/top_level.txt
 rubka/__init__.py
@@ -13,11 +15,15 @@ rubka/config.py
 rubka/context.py
 rubka/decorators.py
 rubka/exceptions.py
+rubka/filters.py
+rubka/helpers.py
 rubka/jobs.py
 rubka/keyboards.py
 rubka/keypad.py
 rubka/logger.py
+rubka/metadata.py
 rubka/rubino.py
+rubka/tv.py
 rubka/update.py
 rubka/utils.py
 rubka/adaptorrubka/__init__.py

rubka-7.1.15/Rubka.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+rubka = rubka.__main__:main

rubka-7.1.15/Rubka.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

{rubka-6.4.8 → rubka-7.1.15}/Rubka.egg-info/requires.txt

@@ -1,9 +1,10 @@
 requests
-Pillow
 websocket-client
 pycryptodome
 aiohttp
+httpx
 tqdm
 mutagen
+markdownify
 filetype
 aiofiles

rubka-7.1.15/rubka/__init__.py

@@ -0,0 +1,80 @@
+"""
+🔹 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
+from .tv import TV as TvRubika
+
+__all__ = [
+    "Robot",
+    "on_message",
+    "APIRequestError",
+    "create_simple_keyboard",
+]

{rubka-6.4.8 → rubka-7.1.15}/rubka/api.py

@@ -3,6 +3,8 @@ from typing import List, Optional, Dict, Any, Literal
 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
@@ -52,22 +54,8 @@ def get_latest_version(package_name: str) -> str:
         data = resp.json()
         return data["info"]["version"]
     except Exception:return None
-def check_rubka_version():
-    package_name = "rubka"
-    installed_version = get_installed_version(package_name)
-    if installed_version is None:return
-    latest_version = get_latest_version(package_name)
-    if latest_version is None:return
-    if installed_version != latest_version:
-        print(f"\n\nWARNING: Your installed version of '{package_name}' is OUTDATED and may cause errors or security risks!")
-        print(f"Installed version : {installed_version}")
-        print(f"Latest available version : {latest_version}")
-        print(f"Please update IMMEDIATELY by running:")
-        print(f"\npip install {package_name}=={latest_version}\n")
-        print(f"Not updating may lead to malfunctions or incompatibility.")
-        print(f"To see new methods : @rubka_library\n\n")
-
-check_rubka_version()
+
+
 def show_last_six_words(text):
     text = text.strip()
     return text[-6:]
@@ -489,14 +477,28 @@ class Robot:
 
         return decorator
 
-    def on_message(self, filters: Optional[Callable[[Message], bool]] = None, commands: Optional[List[str]] = None):
+    def on_message(
+        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 filters and not filters(message):
+                    return
+                if commands:
+                    if not getattr(message, "is_command", False):
+                        return
+                    cmd = message.text.split()[0].lstrip("/") if message.text else ""
+                    if cmd not in commands:
+                        return
+                return func(bot, message)
             self._message_handlers.append({
-                "func": func,
+                "func": wrapper,
                 "filters": filters,
                 "commands": commands
             })
-            return func
+            return wrapper
         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]):
@@ -1000,7 +1002,9 @@ class Robot:
         inline_keypad: Optional[Dict[str, Any]] = None,
         disable_notification: bool = False,
         reply_to_message_id: Optional[str] = None,
-        chat_keypad_type: Optional[Literal["New", "Removed"]] = None
+        chat_keypad_type: Optional[Literal["New", "Removed"]] = None,
+        delete_after = None,
+        parse_mode = None
     ) -> Dict[str, Any]:
         """
         Send a text message to a chat.
@@ -1654,9 +1658,11 @@ class Robot:
         self,
         chat_id: str,
         message_id: str,
-        inline_keypad: Dict[str, Any]
+        inline_keypad: Dict[str, Any],
+        text : str = None
     ) -> Dict[str, Any]:
         """Edit inline keypad of a message."""
+        if text is not None:self._post("editMessageText", {"chat_id": chat_id,"message_id": message_id,"text": text})
         return self._post("editMessageKeypad", {
             "chat_id": chat_id,
             "message_id": message_id,