shadism 1.0.0__tar.gz

shadism-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AmirAli khosravinejad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

shadism-1.0.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include LICENSE
+include requirements.txt
+include pyproject.toml
+include setup.py
+recursive-include shadism *.py py.typed

shadism-1.0.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: shadism
+Version: 1.0.0
+Summary: Ultra-high-performance async UserBot library for the Shad messenger web protocol
+Author-email: AmirAli khosravinejad <khosravinejad.amirali@gmail.com>
+Maintainer-email: AmirAli khosravinejad <khosravinejad.amirali@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://shadism.spark-js.ir
+Project-URL: Documentation, https://shadism.spark-js.ir
+Project-URL: Bale Channel, https://ble.ir/join/8jXbafMPwL
+Project-URL: Repository, https://github.com/AmirAli-khosravinejad/shadism
+Project-URL: Issues, https://github.com/AmirAli-khosravinejad/shadism/issues
+Keywords: shad,messenger,userbot,async,asyncio,chat,bot
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Framework :: AsyncIO
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: h2>=4.0.0
+Requires-Dist: cryptography>=42.0.0
+Requires-Dist: Pillow>=10.0.0
+Dynamic: license-file
+
+# shadism (شادیسم) ⚡
+
+[![PyPI Version](https://img.shields.io/badge/pypi-v1.0.0-blue.svg)](https://pypi.org/project/shadism/)
+[![Python Version](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-00d2ff.svg)](https://pypi.org/project/shadism/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-shadism.spark--js.ir-00f0ff.svg)](https://shadism.spark-js.ir)
+[![Bale Channel](https://img.shields.io/badge/Bale%20Channel-shadism-00a4d6.svg)](https://ble.ir/join/8jXbafMPwL)
+
+**shadism** is an ultra-high-performance, modern, and fully asynchronous Python SDK and UserBot framework for the **Shad** messenger protocol.
+
+Designed from the ground up with native `asyncio`, client-side end-to-end encryption (AES-256-CBC + RSA), rich object-oriented models, and declarative message filtering.
+
+---
+
+## 👨‍💻 Developer & Community
+
+- **Author**: AmirAli khosravinejad
+- **Email**: [khosravinejad.amirali@gmail.com](mailto:khosravinejad.amirali@gmail.com)
+- **Official Documentation**: [https://shadism.spark-js.ir](https://shadism.spark-js.ir)
+- **GitHub Repository**: [https://github.com/AmirAli-khosravinejad/shadism](https://github.com/AmirAli-khosravinejad/shadism)
+- **Official Announcement Channel (Bale)**: [https://ble.ir/join/8jXbafMPwL](https://ble.ir/join/8jXbafMPwL)
+
+---
+
+## 🚀 Key Features
+
+- **⚡ 100% Asynchronous**: Built entirely on `asyncio` and `httpx` with HTTP/2 support.
+- **🔐 End-to-End Encryption**: Automated key generation, passphrases, AES-CBC payload encryption, and RSA authentication.
+- **🎯 Declarative Filters**: Chainable event filters (`filters.command`, `filters.regex`, `filters.group`, `filters.private`, `&`, `|`, `~`).
+- **📜 Smart Chat History**: `get_chat_history()` with automatic batch pagination, deduplication, and update fallback.
+- **📁 Automated Media Streaming**: Chunked file upload (`UploadFile.ashx`) and automatic photo thumbnail generation.
+- **🎙️ Voice Chat (WebRTC)**: Group and channel voice chat creation, joining, speaking activity control, and participants management.
+- **🧩 Rich OOP Models**: Direct interaction with `Message`, `Chat`, and `User` objects (`await msg.reply()`, `await msg.delete()`, `await chat.send_message()`).
+
+---
+
+## 📦 Installation
+
+All dependencies (`httpx`, `h2`, `cryptography`, `Pillow`) are automatically installed:
+
+```bash
+pip install shadism
+```
+
+---
+
+## ⚡ Quickstart
+
+### 1. Simple Echo / Ping Bot
+
+```python
+import asyncio
+from shadism import Client, filters
+
+bot = Client("0937xxxxxxx")
+
+@bot.on_message(filters.command("ping"))
+async def ping_handler(message):
+    await message.reply("🏓 pong!")
+
+@bot.on_message(filters.command("start"))
+async def start_handler(message):
+    await message.reply("سلام! ربات شادیسم با موفقیت راه‌اندازی شد. 🚀")
+
+async def main():
+    await bot.start()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+
+### 2. Fetching Chat History (`get_chat_history`)
+
+```python
+from shadism import Client
+
+bot = Client("0937xxxxxxx")
+
+@bot.on_message
+async def history_example(message):
+    if message.text == "تاریخچه":
+        history = await bot.get_chat_history(message.chat_guid, limit=20)
+        for msg in history:
+            print(f"[{msg.id}] {msg.author_guid}: {msg.text}")
+```
+
+---
+
+### 3. Sending Photos and Files
+
+```python
+# Send photo with automatic thumbnail generation
+await bot.send_photo(
+    object_guid="u0DoNvd...",
+    photo="banner.jpg",
+    caption="تصویر جدید 🖼️"
+)
+
+# Send documents and files
+await bot.send_file(
+    object_guid="u0DoNvd...",
+    file="document.pdf",
+    caption="فایل ضمیمه 📄"
+)
+```
+
+---
+
+### 4. Interactive Two-Way Message Cleaner
+
+```python
+@bot.on_message
+async def clean_messages(message):
+    if message.text == "پاکسازی":
+        messages = await bot.get_chat_history(message.chat_guid, limit=50)
+        to_delete = [
+            m.id for m in messages 
+            if m.author_guid == bot.session.user_guid
+        ]
+        if to_delete:
+            await bot.delete_messages(message.chat_guid, to_delete, delete_type="Global")
+            await bot.send_message(message.chat_guid, f"عملیات انجام شد: {len(to_delete)} پیام پاک شد.")
+```
+
+---
+
+## 📖 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+Developed by **AmirAli khosravinejad**.

shadism-1.0.0/README.md

@@ -0,0 +1,132 @@
+# shadism (شادیسم) ⚡
+
+[![PyPI Version](https://img.shields.io/badge/pypi-v1.0.0-blue.svg)](https://pypi.org/project/shadism/)
+[![Python Version](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-00d2ff.svg)](https://pypi.org/project/shadism/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-shadism.spark--js.ir-00f0ff.svg)](https://shadism.spark-js.ir)
+[![Bale Channel](https://img.shields.io/badge/Bale%20Channel-shadism-00a4d6.svg)](https://ble.ir/join/8jXbafMPwL)
+
+**shadism** is an ultra-high-performance, modern, and fully asynchronous Python SDK and UserBot framework for the **Shad** messenger protocol.
+
+Designed from the ground up with native `asyncio`, client-side end-to-end encryption (AES-256-CBC + RSA), rich object-oriented models, and declarative message filtering.
+
+---
+
+## 👨‍💻 Developer & Community
+
+- **Author**: AmirAli khosravinejad
+- **Email**: [khosravinejad.amirali@gmail.com](mailto:khosravinejad.amirali@gmail.com)
+- **Official Documentation**: [https://shadism.spark-js.ir](https://shadism.spark-js.ir)
+- **GitHub Repository**: [https://github.com/AmirAli-khosravinejad/shadism](https://github.com/AmirAli-khosravinejad/shadism)
+- **Official Announcement Channel (Bale)**: [https://ble.ir/join/8jXbafMPwL](https://ble.ir/join/8jXbafMPwL)
+
+---
+
+## 🚀 Key Features
+
+- **⚡ 100% Asynchronous**: Built entirely on `asyncio` and `httpx` with HTTP/2 support.
+- **🔐 End-to-End Encryption**: Automated key generation, passphrases, AES-CBC payload encryption, and RSA authentication.
+- **🎯 Declarative Filters**: Chainable event filters (`filters.command`, `filters.regex`, `filters.group`, `filters.private`, `&`, `|`, `~`).
+- **📜 Smart Chat History**: `get_chat_history()` with automatic batch pagination, deduplication, and update fallback.
+- **📁 Automated Media Streaming**: Chunked file upload (`UploadFile.ashx`) and automatic photo thumbnail generation.
+- **🎙️ Voice Chat (WebRTC)**: Group and channel voice chat creation, joining, speaking activity control, and participants management.
+- **🧩 Rich OOP Models**: Direct interaction with `Message`, `Chat`, and `User` objects (`await msg.reply()`, `await msg.delete()`, `await chat.send_message()`).
+
+---
+
+## 📦 Installation
+
+All dependencies (`httpx`, `h2`, `cryptography`, `Pillow`) are automatically installed:
+
+```bash
+pip install shadism
+```
+
+---
+
+## ⚡ Quickstart
+
+### 1. Simple Echo / Ping Bot
+
+```python
+import asyncio
+from shadism import Client, filters
+
+bot = Client("0937xxxxxxx")
+
+@bot.on_message(filters.command("ping"))
+async def ping_handler(message):
+    await message.reply("🏓 pong!")
+
+@bot.on_message(filters.command("start"))
+async def start_handler(message):
+    await message.reply("سلام! ربات شادیسم با موفقیت راه‌اندازی شد. 🚀")
+
+async def main():
+    await bot.start()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+
+### 2. Fetching Chat History (`get_chat_history`)
+
+```python
+from shadism import Client
+
+bot = Client("0937xxxxxxx")
+
+@bot.on_message
+async def history_example(message):
+    if message.text == "تاریخچه":
+        history = await bot.get_chat_history(message.chat_guid, limit=20)
+        for msg in history:
+            print(f"[{msg.id}] {msg.author_guid}: {msg.text}")
+```
+
+---
+
+### 3. Sending Photos and Files
+
+```python
+# Send photo with automatic thumbnail generation
+await bot.send_photo(
+    object_guid="u0DoNvd...",
+    photo="banner.jpg",
+    caption="تصویر جدید 🖼️"
+)
+
+# Send documents and files
+await bot.send_file(
+    object_guid="u0DoNvd...",
+    file="document.pdf",
+    caption="فایل ضمیمه 📄"
+)
+```
+
+---
+
+### 4. Interactive Two-Way Message Cleaner
+
+```python
+@bot.on_message
+async def clean_messages(message):
+    if message.text == "پاکسازی":
+        messages = await bot.get_chat_history(message.chat_guid, limit=50)
+        to_delete = [
+            m.id for m in messages 
+            if m.author_guid == bot.session.user_guid
+        ]
+        if to_delete:
+            await bot.delete_messages(message.chat_guid, to_delete, delete_type="Global")
+            await bot.send_message(message.chat_guid, f"عملیات انجام شد: {len(to_delete)} پیام پاک شد.")
+```
+
+---
+
+## 📖 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+Developed by **AmirAli khosravinejad**.