spluspy 2.2.9__tar.gz → 2.2.11__tar.gz

{spluspy-2.2.9/spluspy.egg-info → spluspy-2.2.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spluspy
-Version: 2.2.9
+Version: 2.2.11
 Summary: High-performance Python Self-Bot Framework for Soroush Plus
 Author: Ali Mirshekari
 License: MIT
@@ -26,18 +26,18 @@ Requires-Dist: rsa
 Requires-Dist: pyaes
 Dynamic: license-file
 
-# SplusPy v2.2.9
+# SplusPy v2.2.11
 
 
-**A fast, minimal, and fully-featured self-bot framework**
+**A fast, minimal, and fully-featured framework for Soroush Plus — self-bots and official bots**
 
 ---
 
 ## About
 
-SplusPy is a Python library designed specifically for building **Soroush Plus self-bots** (userbots). It provides a clean, intuitive API for automating your personal Soroush Plus account with ease.
+SplusPy is a Python library designed specifically for building **Soroush Plus self-bots** (userbots) and **official bots**. It provides a clean, intuitive API for automating your personal Soroush Plus account or building bots via the official HTTP Bot API.
 
-> ⚠️ **Note:** This is a **self-bot framework** — it operates on your personal account, not a bot account. Please adhere to Soroush's Terms of Service.
+> ⚠️ **Note:** This framework supports both **self-bot** (personal account) and **official bot** (Bot API) modes. Please adhere to Soroush's Terms of Service.
 
 ---
 
@@ -83,6 +83,30 @@ client.run_until_disconnected()
 
 ---
 
+## Official Bot (Robot)
+
+You can also build official bots using the HTTP Bot API:
+
+```python
+from spluspy import Robot, filters
+
+bot = Robot("YOUR_BOT_TOKEN")
+
+@bot.on_message(filters.text("hello"))
+async def hello_handler(client, event):
+    await event.reply("Hi there!")
+
+bot.run()
+```
+
+### How it works
+
+1. **Create a `Robot`** — pass your bot token.
+2. **Register handlers** — use `@bot.on_message()` just like the self-bot.
+3. **Run** — call `bot.run()` to start long-polling.
+
+---
+
 ## License
 
 MIT License. See [LICENSE](LICENSE) for details.

{spluspy-2.2.9 → spluspy-2.2.11}/README.md

@@ -1,15 +1,15 @@
-# SplusPy v2.2.9
+# SplusPy v2.2.11
 
 
-**A fast, minimal, and fully-featured self-bot framework**
+**A fast, minimal, and fully-featured framework for Soroush Plus — self-bots and official bots**
 
 ---
 
 ## About
 
-SplusPy is a Python library designed specifically for building **Soroush Plus self-bots** (userbots). It provides a clean, intuitive API for automating your personal Soroush Plus account with ease.
+SplusPy is a Python library designed specifically for building **Soroush Plus self-bots** (userbots) and **official bots**. It provides a clean, intuitive API for automating your personal Soroush Plus account or building bots via the official HTTP Bot API.
 
-> ⚠️ **Note:** This is a **self-bot framework** — it operates on your personal account, not a bot account. Please adhere to Soroush's Terms of Service.
+> ⚠️ **Note:** This framework supports both **self-bot** (personal account) and **official bot** (Bot API) modes. Please adhere to Soroush's Terms of Service.
 
 ---
 
@@ -55,6 +55,30 @@ client.run_until_disconnected()
 
 ---
 
+## Official Bot (Robot)
+
+You can also build official bots using the HTTP Bot API:
+
+```python
+from spluspy import Robot, filters
+
+bot = Robot("YOUR_BOT_TOKEN")
+
+@bot.on_message(filters.text("hello"))
+async def hello_handler(client, event):
+    await event.reply("Hi there!")
+
+bot.run()
+```
+
+### How it works
+
+1. **Create a `Robot`** — pass your bot token.
+2. **Register handlers** — use `@bot.on_message()` just like the self-bot.
+3. **Run** — call `bot.run()` to start long-polling.
+
+---
+
 ## License
 
 MIT License. See [LICENSE](LICENSE) for details.

{spluspy-2.2.9 → spluspy-2.2.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "spluspy"
-version = "2.2.9"
+version = "2.2.11"
 description = "High-performance Python Self-Bot Framework for Soroush Plus"
 readme = "README.md"
 license = {text = "MIT"}

spluspy-2.2.11/spluspy/__init__.py

@@ -0,0 +1,20 @@
+from .client.soroushclient import SoroushClient as Client
+from .http_api import Robot
+from .http_api.types import Message, CallbackQuery
+from .http_api.keyboards import InlineKeyboardBuilder, ReplyKeyboardBuilder
+from .http_api.callbackquery import HTTPCallbackQuery
+from .network import connection
+from .tl.custom import Button
+from .tl import patched as _  # import for its side-effects
+from . import version, events, utils, errors, functions, custom
+from .filters import filters
+from .enums import MessageMediaType
+
+__version__ = version.__version__
+
+__all__ = [
+    'Client', 'Robot', 'Message', 'CallbackQuery', 'Button', 'filters',
+    'MessageMediaType', 'InlineKeyboardBuilder', 'ReplyKeyboardBuilder',
+    'HTTPCallbackQuery', 'functions', 'custom', 'errors',
+    'events', 'utils', 'connection',
+]

spluspy-2.2.11/spluspy/client/__init__.py

@@ -0,0 +1,12 @@
+"""
+This package defines clients as subclasses of others, and then a single
+`spluspy.client.soroushclient.SoroushClient` which is subclass of them
+all to provide the final unified interface while the methods can live in
+different subclasses to be more maintainable.
+
+The ABC is `spluspy.client.telegrambaseclient.SoroushPlusBaseClient` and
+methods are provided via `spluspy.methods.Methods` which aggregates all
+the individual method mixins.
+"""
+from .telegrambaseclient import SoroushPlusBaseClient
+from .soroushclient import SoroushClient

spluspy-2.2.11/spluspy/client/soroushclient.py

@@ -0,0 +1,51 @@
+import asyncio
+import typing
+from typing import Optional
+
+from ..methods import Methods
+from .telegrambaseclient import SoroushPlusBaseClient
+
+if typing.TYPE_CHECKING:
+    from ..http_api.robot import Robot
+
+
+class SoroushClient(Methods, SoroushPlusBaseClient):
+    def __init__(
+        self,
+        *args,
+        http_token: Optional[str] = None,
+        **kwargs,
+    ):
+        super().__init__(*args, **kwargs)
+        self._http_robot: Optional["Robot"] = (
+            _create_robot(http_token) if http_token else None
+        )
+        self._http_polling_task: Optional[asyncio.Task] = None
+
+    @property
+    def http_robot(self) -> Optional["Robot"]:
+        """Direct access to the HTTP Robot instance (if ``http_token`` was provided)."""
+        return self._http_robot
+
+    async def connect(self):
+        await super().connect()
+        if self._http_robot is not None:
+            self._http_robot.loop = self.loop
+            self._http_polling_task = asyncio.create_task(
+                self._http_robot._polling_loop()
+            )
+
+    async def _disconnect_coro(self):
+        if self._http_robot is not None and self._http_polling_task is not None:
+            self._http_polling_task.cancel()
+            try:
+                await self._http_polling_task
+            except asyncio.CancelledError:
+                pass
+            await self._http_robot.close()
+        await super()._disconnect_coro()
+
+
+def _create_robot(token: str) -> "Robot":
+    from ..http_api.robot import Robot
+    return Robot(token)