spluspy 2.0.4__tar.gz → 2.0.6__tar.gz

spluspy-2.0.6/.gitignore

@@ -0,0 +1,50 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+*.whl
+
+# Virtual environments
+venv/
+.venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+
+# Logs
+*.log
+logs/
+
+# Database files
+*.sqlite
+*.sqlite3
+
+# Environment
+.env
+.env.*
+
+# OS
+Thumbs.db
+Desktop.ini
+.DS_Store
+
+# Temporary files
+tempCodeRunnerFile.py
+*.tmp
+*.bak

{spluspy-2.0.4 → spluspy-2.0.6}/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to SplusPy will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [2.0.6] - 2026-07-11
+
+### Fixed
+- Fixed missing `Union` import in `batch.py` that caused `NameError` at runtime
+- Fixed missing `copy_messages` method call in sync wrapper that caused `AttributeError`
+- Removed unused `SplusConnectionError` import in `client.py`
+- Fixed deprecated `asyncio.get_event_loop()` replaced with `asyncio.get_running_loop()` in network client
+- Fixed FSM `on_enter`/`on_leave` hooks that were registered but never invoked
+- Fixed `RateLimitMiddleware` that incremented counter but didn't actually rate-limit updates
+
+### Removed
+- Removed unused `HttpTransport` class from transport module
+- Removed duplicate `test_storage_backends.py` (merged TTL test into `test_storage.py`)
+
+### Changed
+- Renamed `FloodWait` in `rate_limiter.py` to `FloodWaitState` to avoid confusion with `errors.FloodWait`
+- Moved inline `import inspect` and `import re` to module-level imports in `client.py`
+- Added `FloodWaitState` docstring clarification in rate limiter
+
+### Documentation
+- Fixed README.md project structure: `types/` corrected to `models/`
+- Fixed README.md FSM example that accessed data after `reset()`
+- Fixed Dockerfile `COPY bot.py` that failed when file doesn't exist
+- Added docstring for `Regex` filter side effect (`pattern_match`)
+
 ## [3.0.0] - 2026-07-10
 
 ### Added

{spluspy-2.0.4 → spluspy-2.0.6}/Dockerfile

@@ -14,8 +14,9 @@ COPY spluspy/ spluspy/
 # Install the package
 RUN pip install --no-cache-dir ".[all]"
 
-# Copy bot script if present
-COPY bot.py ./
+# Copy bot script (pass as build arg)
+ARG BOT_SCRIPT=bot.py
+COPY ${BOT_SCRIPT} ./
 
 # Run the bot
 CMD ["python", "bot.py"]

{spluspy-2.0.4 → spluspy-2.0.6}/MANIFEST.in

@@ -2,6 +2,6 @@ include LICENSE
 include README.md
 include README.rst
 include pyproject.toml
-recursive-include spluspy *.py *.pyi
+recursive-include spluspy *.py *.pyi py.typed
 recursive-include tests *.py
 recursive-include examples *.py

{spluspy-2.0.4 → spluspy-2.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spluspy
-Version: 2.0.4
+Version: 2.0.6
 Summary: A modern async Python library for interacting with Soroush Plus
 Project-URL: Homepage, https://github.com/Itskillmaster/spluspy
 Project-URL: Documentation, https://github.com/Itskillmaster/spluspy#readme
@@ -36,6 +36,7 @@ Requires-Dist: pytest-cov>=4.0; extra == 'all'
 Requires-Dist: pytest>=7.0; extra == 'all'
 Requires-Dist: redis>=4.0; extra == 'all'
 Requires-Dist: ruff>=0.1.0; extra == 'all'
+Requires-Dist: uvloop>=0.19.0; (sys_platform != 'win32') and extra == 'all'
 Provides-Extra: dev
 Requires-Dist: black>=23.0; extra == 'dev'
 Requires-Dist: mypy>=1.0; extra == 'dev'
@@ -50,6 +51,7 @@ Requires-Dist: redis>=4.0; extra == 'redis'
 Provides-Extra: speed
 Requires-Dist: cryptg; extra == 'speed'
 Requires-Dist: orjson>=3.9.0; extra == 'speed'
+Requires-Dist: uvloop>=0.19.0; (sys_platform != 'win32') and extra == 'speed'
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -309,8 +311,9 @@ async def process_form(client, message):
         await message.reply("How old are you?")
     elif state == Form.age:
         await ctx.set_data(age=message.text)
+        data = await ctx.get_data()
         await ctx.reset()
-        await message.reply(f"Registered! Name: {(await ctx.get_data()).get('name')}")
+        await message.reply(f"Registered! Name: {data.get('name')}")
 ```
 
 #### Advanced FSM: State Routing with Decorators
@@ -542,7 +545,7 @@ spluspy/
 ├── config.py            # Configuration
 ├── compat.py            # Compatibility layer
 ├── client/              # Client and conversation API
-├── types/               # Domain models (Message, User, Chat, Media, etc.)
+├── models/              # Domain models (Message, User, Chat, Media, etc.)
 ├── events/              # Event types and builders
 ├── filters/             # Composable message filters
 ├── errors/              # Custom exception hierarchy

{spluspy-2.0.4 → spluspy-2.0.6}/README.md

@@ -255,8 +255,9 @@ async def process_form(client, message):
         await message.reply("How old are you?")
     elif state == Form.age:
         await ctx.set_data(age=message.text)
+        data = await ctx.get_data()
         await ctx.reset()
-        await message.reply(f"Registered! Name: {(await ctx.get_data()).get('name')}")
+        await message.reply(f"Registered! Name: {data.get('name')}")
 ```
 
 #### Advanced FSM: State Routing with Decorators
@@ -488,7 +489,7 @@ spluspy/
 ├── config.py            # Configuration
 ├── compat.py            # Compatibility layer
 ├── client/              # Client and conversation API
-├── types/               # Domain models (Message, User, Chat, Media, etc.)
+├── models/              # Domain models (Message, User, Chat, Media, etc.)
 ├── events/              # Event types and builders
 ├── filters/             # Composable message filters
 ├── errors/              # Custom exception hierarchy

{spluspy-2.0.4 → spluspy-2.0.6}/examples/01_hello_bot.py

@@ -5,8 +5,7 @@ The simplest possible SplusPy bot that replies "Hello!" to any message.
 
 from spluspy import Client
 
-# Use session_name for clarity
-bot = Client(session_name="hello_session")
+bot = Client("hello_session")
 
 
 @bot.on_message()

{spluspy-2.0.4 → spluspy-2.0.6}/examples/02_echo_bot.py

@@ -5,7 +5,7 @@ Echoes back any text message it receives.
 
 from spluspy import Client, filters
 
-bot = Client(session_name="echo_session")
+bot = Client("echo_session")
 
 
 @bot.on_message(filters.text)

{spluspy-2.0.4 → spluspy-2.0.6}/examples/04_private_only.py

@@ -3,16 +3,15 @@
 Only responds to messages in private chats.
 """
 
-from spluspy import Client
-from spluspy import filters
+from spluspy import Client, filters
 
 bot = Client("private_session")
 
 
 @bot.on_message(filters.private)
-async def private_handler(m):
+async def private_handler(client, message):
     """Handle messages in private chats only."""
-    await m.reply("This is a private chat!")
+    await message.reply("This is a private chat!")
 
 
 if __name__ == "__main__":

{spluspy-2.0.4 → spluspy-2.0.6}/examples/05_group_only.py

@@ -3,16 +3,15 @@
 Only responds to messages in group chats.
 """
 
-from spluspy import Client
-from spluspy import filters
+from spluspy import Client, filters
 
 bot = Client("group_session")
 
 
 @bot.on_message(filters.group)
-async def group_handler(m):
+async def group_handler(client, message):
     """Handle messages in group chats only."""
-    await m.reply("This is a group chat!")
+    await message.reply("This is a group chat!")
 
 
 if __name__ == "__main__":

{spluspy-2.0.4 → spluspy-2.0.6}/examples/06_regex_bot.py

@@ -3,23 +3,22 @@
 Matches messages using regex patterns.
 """
 
-from spluspy import Client
-from spluspy import filters
+from spluspy import Client, filters
 
 bot = Client("regex_session")
 
 
 @bot.on_message(filters.regex(r"\d+"))
-async def number_handler(m):
+async def number_handler(client, message):
     """Handle messages containing numbers."""
-    numbers = m.pattern_match.group()
-    await m.reply(f"I found a number: {numbers}")
+    numbers = message.pattern_match.group()
+    await message.reply(f"I found a number: {numbers}")
 
 
 @bot.on_message(filters.regex(r"(?i)hello|hi|hey"))
-async def greeting_handler(m):
+async def greeting_handler(client, message):
     """Handle greeting messages."""
-    await m.reply("Hey there!")
+    await message.reply("Hey there!")
 
 
 if __name__ == "__main__":

{spluspy-2.0.4 → spluspy-2.0.6}/examples/07_user_filter.py

@@ -3,8 +3,7 @@
 Responds only to specific users.
 """
 
-from spluspy import Client
-from spluspy import filters
+from spluspy import Client, filters
 
 bot = Client("user_filter_session")
 
@@ -13,15 +12,15 @@ ALLOWED_USERS = [123456, 789012]
 
 
 @bot.on_message(filters.user(*ALLOWED_USERS))
-async def allowed_handler(m):
+async def allowed_handler(client, message):
     """Handle messages from allowed users only."""
-    await m.reply("Hello authorized user!")
+    await message.reply("Hello authorized user!")
 
 
 @bot.on_message()
-async def unauthorized_handler(m):
+async def unauthorized_handler(client, message):
     """Handle messages from unauthorized users."""
-    await m.reply("Sorry, you are not authorized.")
+    await message.reply("Sorry, you are not authorized.")
 
 
 if __name__ == "__main__":

{spluspy-2.0.4 → spluspy-2.0.6}/examples/09_inline_keyboard.py

@@ -3,14 +3,13 @@
 Demonstrates inline keyboard buttons and callback queries.
 """
 
-from spluspy import Client
-from spluspy import Button, filters
+from spluspy import Client, Button, filters
 
 bot = Client("keyboard_session")
 
 
 @bot.on_message(filters.command("menu"))
-async def menu_handler(m):
+async def menu_handler(client, message):
     """Show an inline keyboard menu."""
     keyboard = Button.build_inline(
         [
@@ -18,19 +17,19 @@ async def menu_handler(m):
             [Button.inline("Option 3", b"opt3")],
         ]
     )
-    await m.reply("Choose an option:", buttons=keyboard)
+    await message.reply("Choose an option:", buttons=keyboard)
 
 
 @bot.on_callback_query()
-async def callback_handler(cb):
+async def callback_handler(client, callback):
     """Handle inline button clicks."""
-    data = cb.text
+    data = callback.text
     if data == "opt1":
-        await cb.answer("You chose Option 1!")
+        await callback.answer("You chose Option 1!")
     elif data == "opt2":
-        await cb.answer("You chose Option 2!")
+        await callback.answer("You chose Option 2!")
     elif data == "opt3":
-        await cb.answer("You chose Option 3!")
+        await callback.answer("You chose Option 3!")
 
 
 if __name__ == "__main__":

{spluspy-2.0.4 → spluspy-2.0.6}/examples/10_reply_keyboard.py

@@ -3,32 +3,31 @@
 Demonstrates reply keyboards (replacing the user's keyboard).
 """
 
-from spluspy import Client
-from spluspy import Button, filters
+from spluspy import Client, Button, filters
 
 bot = Client("reply_keyboard_session")
 
 
 @bot.on_message(filters.command("menu"))
-async def menu_handler(m):
+async def menu_handler(client, message):
     """Show a reply keyboard."""
     keyboard = Button.build_reply(
         [Button.text("Settings"), Button.text("Profile")],
         [Button.text("Help")],
     )
-    await m.reply("Choose:", buttons=keyboard)
+    await message.reply("Choose:", buttons=keyboard)
 
 
 @bot.on_message(filters.command("clear"))
-async def clear_handler(m):
+async def clear_handler(client, message):
     """Clear the keyboard."""
-    await m.reply("Keyboard cleared!", buttons=Button.clear())
+    await message.reply("Keyboard cleared!", buttons=Button.clear())
 
 
 @bot.on_message(filters.text)
-async def text_handler(m):
+async def text_handler(client, message):
     """Handle text messages."""
-    await m.reply(f"You pressed: {m.text}")
+    await message.reply(f"You pressed: {message.text}")
 
 
 if __name__ == "__main__":

{spluspy-2.0.4 → spluspy-2.0.6}/examples/11_message_actions.py

@@ -3,38 +3,36 @@
 Demonstrates various message actions like edit, delete, forward, pin.
 """
 
-from spluspy import Client
-from spluspy import filters
+from spluspy import Client, filters
 
 bot = Client("actions_session")
 
 
 @bot.on_message(filters.command("edit"))
-async def edit_example(m):
+async def edit_example(client, message):
     """Demonstrate message editing."""
-    sent = await m.reply("This message will be edited...")
+    sent = await message.reply("This message will be edited...")
     await sent.edit("Message edited successfully!")
 
 
 @bot.on_message(filters.command("pin"))
-async def pin_example(m):
+async def pin_example(client, message):
     """Demonstrate message pinning."""
-    sent = await m.reply("This message will be pinned!")
+    sent = await message.reply("This message will be pinned!")
     await sent.pin(notify=True)
 
 
 @bot.on_message(filters.command("forward"))
-async def forward_example(m):
+async def forward_example(client, message):
     """Demonstrate message forwarding."""
-    await m.reply("Forwarding this message...")
-    # await m.forward(target_chat_id)
+    await message.reply("Forwarding this message...")
 
 
 @bot.on_message(filters.command("react"))
-async def react_example(m):
+async def react_example(client, message):
     """Demonstrate reactions."""
-    await m.react("❤️")
-    await m.reply("Reaction added!")
+    await message.react("❤️")
+    await message.reply("Reaction added!")
 
 
 if __name__ == "__main__":

spluspy-2.0.6/examples/12_media_bot.py

@@ -0,0 +1,36 @@
+"""Example 12: Media Bot
+
+Demonstrates sending different types of media.
+"""
+
+from spluspy import Client, filters
+
+bot = Client("media_session")
+
+
+@bot.on_message(filters.command("photo"))
+async def photo_example(client, message):
+    """Send a photo."""
+    await message.reply_photo("https://example.com/photo.jpg", caption="Here is a photo!")
+
+
+@bot.on_message(filters.command("video"))
+async def video_example(client, message):
+    """Send a video."""
+    await message.reply_video("https://example.com/video.mp4", caption="Here is a video!")
+
+
+@bot.on_message(filters.command("document"))
+async def document_example(client, message):
+    """Send a document."""
+    await message.reply_document("https://example.com/file.pdf", caption="Here is a document!")
+
+
+@bot.on_message(filters.command("location"))
+async def location_example(client, message):
+    """Send a location."""
+    await message.reply("Sending location...")
+
+
+if __name__ == "__main__":
+    bot.run()

{spluspy-2.0.4 → spluspy-2.0.6}/examples/13_fsm_bot.py

@@ -3,8 +3,7 @@
 Demonstrates the Finite State Machine for conversational flows.
 """
 
-from spluspy import Client
-from spluspy import filters
+from spluspy import Client, filters
 from spluspy.fsm import State, StateMachine
 from spluspy.storage import MemoryStorage
 
@@ -22,40 +21,40 @@ class RegistrationForm:
 
 
 @bot.on_message(filters.command("register"))
-async def start_registration(m):
+async def start_registration(client, message):
     """Start the registration flow."""
-    ctx = fsm.context(m.sender_id)
+    ctx = fsm.context(message.sender_id)
     await ctx.set_state(RegistrationForm.name)
-    await m.reply("What is your name?")
+    await message.reply("What is your name?")
 
 
 @bot.on_message(filters.private)
-async def process_form(m):
+async def process_form(client, message):
     """Process form responses based on current state."""
-    ctx = fsm.context(m.sender_id)
+    ctx = fsm.context(message.sender_id)
     state = await ctx.get_state()
 
     if state is None:
         return
 
     if state == RegistrationForm.name:
-        await ctx.set_data(name=m.text)
+        await ctx.set_data(name=message.text)
         await ctx.set_state(RegistrationForm.age)
-        await m.reply("How old are you?")
+        await message.reply("How old are you?")
 
     elif state == RegistrationForm.age:
-        await ctx.set_data(age=m.text)
+        await ctx.set_data(age=message.text)
         await ctx.set_state(RegistrationForm.city)
-        await m.reply("Which city are you from?")
+        await message.reply("Which city are you from?")
 
     elif state == RegistrationForm.city:
         data = await ctx.get_data()
         await ctx.reset()
-        await m.reply(
+        await message.reply(
             f"Registration complete!\n"
             f"Name: {data.get('name')}\n"
             f"Age: {data.get('age')}\n"
-            f"City: {m.text}"
+            f"City: {message.text}"
         )
 
 

{spluspy-2.0.4 → spluspy-2.0.6}/examples/14_plugin_bot.py

@@ -6,6 +6,8 @@ Demonstrates the plugin loading system.
 # plugins/greetings.py
 """Greeting plugin."""
 
+from spluspy import filters
+
 GREETINGS = {
     "hello": "Hello there!",
     "hi": "Hey!",
@@ -18,14 +20,14 @@ def register(client):
     """Register plugin handlers with the client."""
 
     @client.on_message(filters.command("greet"))
-    async def greet_handler(m):
-        await m.reply("Available greetings: hello, hi, salam, bye")
+    async def greet_handler(client, message):
+        await message.reply("Available greetings: hello, hi, salam, bye")
 
     @client.on_message(filters.text)
-    async def auto_greet(m):
-        text = m.text.lower().strip()
+    async def auto_greet(client, message):
+        text = message.text.lower().strip()
         if text in GREETINGS:
-            await m.reply(GREETINGS[text])
+            await message.reply(GREETINGS[text])
 
 
 # main.py

{spluspy-2.0.4 → spluspy-2.0.6}/examples/15_middleware_bot.py

@@ -33,8 +33,8 @@ bot.middleware.add(LoggingMiddleware())
 
 
 @bot.on_message()
-async def handler(m):
-    await m.reply("Hello!")
+async def handler(client, message):
+    await message.reply("Hello!")
 
 
 if __name__ == "__main__":

{spluspy-2.0.4 → spluspy-2.0.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "spluspy"
-version = "2.0.4"
+version = "2.0.6"
 description = "A modern async Python library for interacting with Soroush Plus"
 readme = "README.md"
 license = "MIT"
@@ -43,6 +43,7 @@ dependencies = [
 speed = [
     "cryptg",
     "orjson>=3.9.0",
+    "uvloop>=0.19.0; sys_platform != 'win32'",
 ]
 redis = [
     "redis>=4.0",

{spluspy-2.0.4 → spluspy-2.0.6}/spluspy/__init__.py

@@ -64,6 +64,7 @@ from spluspy.fsm import State, StateMachine, FSMContext, StateTransition
 from spluspy.storage import Storage, MemoryStorage, SQLiteStorage, get_storage
 from spluspy.middleware.base import Middleware, MiddlewareManager
 from spluspy.middleware.rate_limit import RateLimitMiddleware
+from spluspy.network.protocols import IAdapter, ITransport, IStorage, IEventDispatcher
 from spluspy.utils.logger import (
     setup_logging,
     get_logger,
@@ -72,6 +73,11 @@ from spluspy.utils.logger import (
 )
 from spluspy.utils.rate_limiter import RateLimiter, FloodWaitError
 from spluspy.utils.cache import LRUCache, EntityCache
+from spluspy.utils.resolver import TargetResolver, TargetResolution, resolve_reply_sender
+from spluspy.afk import AfkManager
+from spluspy.admin import ChatAdmin
+from spluspy.mirror import MessageMirror
+from spluspy.scheduler.scheduler import MessageScheduler
 
 __all__ = [
     "__version__",
@@ -124,10 +130,21 @@ __all__ = [
     "Middleware",
     "MiddlewareManager",
     "RateLimitMiddleware",
+    "IAdapter",
+    "ITransport",
+    "IStorage",
+    "IEventDispatcher",
     "RateLimiter",
     "FloodWaitError",
     "LRUCache",
     "EntityCache",
+    "TargetResolver",
+    "TargetResolution",
+    "resolve_reply_sender",
+    "AfkManager",
+    "ChatAdmin",
+    "MessageMirror",
+    "MessageScheduler",
     "setup_logging",
     "get_logger",
     "set_level",

{spluspy-2.0.4 → spluspy-2.0.6}/spluspy/__version__.py

@@ -1,6 +1,6 @@
 """SplusPy version information."""
 
-__version__ = "2.0.4"
+__version__ = "2.0.6"
 __author__ = "Ali Mirshekari"
 __license__ = "MIT"
 __url__ = "https://github.com/Itskillmaster/spluspy"