Metadata-Version: 2.4
Name: spluslib
Version: 3.0.0
Summary: High-level Soroush Plus userbot library - A clean, simplified API for building userbots on Soroush Plus platform
Home-page: https://github.com/erfan-mirdehghan/spluslib
Author: Erfan Mirdehghan
Author-email: Erfan Mirdehghan <erfan.mirdehghan@example.com>
License: MIT
Project-URL: Homepage, https://github.com/erfan-mirdehghan/spluslib
Project-URL: Repository, https://github.com/erfan-mirdehghan/spluslib
Project-URL: Issues, https://github.com/erfan-mirdehghan/spluslib/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: pyaes>=1.6.1
Requires-Dist: rsa>=4.8
Requires-Dist: python-socks>=2.4.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# 🚀 SplusLib - کتابخانه حرفه‌ای سروش پلاس

<div align="center">

**یک کتابخانه کامل، سریع و حرفه‌ای برای ساخت ربات‌های کاربری (Userbot) در پیام‌رسان سروش پلاس**

[![PyPI version](https://img.shields.io/pypi/v/spluslib.svg)](https://pypi.org/project/spluslib/)
[![Python Version](https://img.shields.io/pypi/pyversions/spluslib.svg)](https://pypi.org/project/spluslib/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Downloads](https://static.pepy.tech/badge/spluslib)](https://pepy.tech/project/spluslib)

</div>

---

## ✨ ویژگی‌های کلیدی

- ⚡ **سریع و بهینه**: با استفاده از `asyncio` و `aiohttp`
- 🎯 **ساده و حرفه‌ای**: متدهای سطح بالا به جای دستورات پیچیده
- 🔧 **قابل اعتماد**: رفع باگ‌های متعدد و پایداری بالا
- 📦 **کامل**: پشتیبانی از تمام قابلیت‌های سروش پلاس، شامل استوری
- 🎨 **انعطاف‌پذیر**: سیستم رویدادها و فیلترهای پیشرفته
- 📝 **Type Hints**: پشتیبانی کامل از تایپ‌هینت‌ها برای IDE بهتر

## 🛠️ نصب سریع

```bash
pip install spluslib
```

## 📖 داکیومنت کامل

**برای مشاهده داکیومنت کامل، راهنمای استفاده و مثال‌های بیشتر، لطفاً به صفحه گیت‌هاب مراجعه کنید:**

🔗 **[https://github.com/Erfan-Mirdehghan/SplusLib](https://github.com/Erfan-Mirdehghan/SplusLib)**

در گیت‌هاب می‌توانید:
- 📚 مستندات کامل همه متدها
- 💡 مثال‌های کاربردی
- 🐛 گزارش باگ‌ها
- 💬 بحث و تبادل نظر
- 🔄 آخرین آپدیت‌ها

را مشاهده کنید.

## 🚀 شروع سریع

```python
import asyncio
from spluslib import SplusClient

async def main():
    # ایجاد کلاینت
    client = SplusClient("my_session")

    # اتصال و ورود
    await client.start("+989123456789")

    # دریافت اطلاعات کاربر
    me = await client.get_me()
    print(f"✅ وارد شدید به عنوان: {me['first_name']}")

    # ارسال پیام
    await client.send_message("me", "سلام! از SplusLib استفاده می‌کنم 🚀")

    # هندلر رویداد
    @client.on_message()
    async def handler(event):
        if event.raw_text == "ping":
            await event.reply("pong! 🏓")

    await client.run_until_disconnected()

asyncio.run(main())
```

## 📦 نیازمندی‌ها

- Python 3.8 یا بالاتر
- اتصال به اینترنت

## 🎯 قابلیت‌های اصلی

### 📨 پیام‌ها
- ارسال، ویرایش، حذف و فوروارد پیام
- پین کردن و ری اکشن
- جستجوی پیام‌ها

### 👥 مدیریت گروه‌ها
- ساخت گروه و کانال، مدیریت یوزرنیم
- مدیریت اعضا (بن، آنبان، میوت، ادمین)
- لینک‌های دعوت و درخواست‌های عضویت
- دریافت لیست اعضا

### 📖 استوری
- سین کردن، ری‌اکشن، ریپلای روی استوری
- چک کردن استوری فعال یه کاربر و گرفتن لینکش
- دانلود عکس/ویدیوی استوری

### 📞 تماس‌های گروهی
- ساخت و مدیریت کنفرانس‌ها
- جوین و لیو تماس
- مدیریت شرکت‌کنندگان

### 📁 فایل‌ها
- ارسال عکس (با پشتیبانی از حالت اسپویلر)، ویدیو، صدا و اسناد
- دانلود مدیا

## 🤝 مشارکت

ما از مشارکت شما استقبال می‌کنیم! لطفاً برای گزارش باگ‌ها یا پیشنهادات، در گیت‌هاب Issue ایجاد کنید.

## 📄 لایسنس

این پروژه تحت لایسنس **MIT** منتشر شده است.

## 👨‍💻 توسعه‌دهنده

**Erfan Mirdehghan**

---

<div align="center">

**[⭐️ در گیت‌هاب ستاره بدید](https://github.com/Erfan-Mirdehghan/SplusLib)** | **[📖 داکیومنت کامل](https://github.com/Erfan-Mirdehghan/SplusLib)** | **[🐛 گزارش باگ](https://github.com/Erfan-Mirdehghan/SplusLib/issues)**

</div>
