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

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

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

🛠️ نصب سریع

pip install spluslib

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

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

🔗 https://github.com/Erfan-Mirdehghan/SplusLib

در گیت‌هاب می‌توانید:

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

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

🚀 شروع سریع

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