soropy 1.0.0__tar.gz

soropy-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 SoroPy Team
+
+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.

soropy-1.0.0/MANIFEST.in

@@ -0,0 +1,9 @@
+include README.md
+include LICENSE
+include pyproject.toml
+include setup.py
+recursive-include soropy *.py
+recursive-include examples *.py
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude *.egg-info

soropy-1.0.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: soropy
+Version: 1.0.0
+Summary: کتابخانه حرفه‌ای سروش پلاس برای پایتون - Professional Soroush Plus Web Client Library
+Home-page: https://github.com/soropy/soropy
+Author: SoroPy Team
+Author-email: SoroPy Team <soropy@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/soropy/soropy
+Project-URL: Documentation, https://soropy.readthedocs.io
+Project-URL: Repository, https://github.com/soropy/soropy
+Project-URL: Issues, https://github.com/soropy/soropy/issues
+Keywords: soroush,splus,messenger,automation,bot,soroush-plus
+Classifier: Development Status :: 5 - Production/Stable
+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
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: selenium>=4.10.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# SoroPy 🚀
+
+**حرفه‌ای‌ترین کتابخانه پایتون برای سروش پلاس**
+
+[![PyPI](https://img.shields.io/pypi/v/soropy)](https://pypi.org/project/soropy/)
+[![Python](https://img.shields.io/pypi/pyversions/soropy)](https://pypi.org/project/soropy/)
+[![License](https://img.shields.io/pypi/l/soropy)](https://opensource.org/licenses/MIT)
+
+---
+
+## ✨ امکانات
+
+| قابلیت | توضیح |
+|--------|-------|
+| 🔐 **لاگین خودکار** | ورود با شماره + کد تأیید، ذخیره سشن |
+| 💬 **استخراج چت‌ها** | لیست همه / شخصی / گروه / کانال |
+| 📨 **ارسال پیام** | تکی و دسته‌ای به چت‌های شخصی |
+| 📢 **ارسال در کانال** | پست گذاشتن (نیاز به ادمین بودن) |
+| 📇 **مدیریت مخاطبین** | مشاهده، اضافه کردن، جستجو |
+| 🤖 **پاسخ خودکار** | موتور قوانین + جلوگیری از پاسخ تکراری |
+| 👁️ **مانیتور مداوم** | بررسی و پاسخ خودکار هر X ثانیه |
+| 👥 **چند اکانت** | مدیریت همزمان چندین حساب |
+| 🖥️ **بدون پنجره** | حالت headless - بدون نمایش مرورگر |
+| 🧵 **Thread-safe** | طراحی ایمن برای چند نخی |
+| 💾 **ذخیره سشن** | بدون نیاز به لاگین مجدد |
+
+---
+
+## 📦 نصب
+
+```bash
+pip install soropy

soropy-1.0.0/README.md

@@ -0,0 +1,32 @@
+# SoroPy 🚀
+
+**حرفه‌ای‌ترین کتابخانه پایتون برای سروش پلاس**
+
+[![PyPI](https://img.shields.io/pypi/v/soropy)](https://pypi.org/project/soropy/)
+[![Python](https://img.shields.io/pypi/pyversions/soropy)](https://pypi.org/project/soropy/)
+[![License](https://img.shields.io/pypi/l/soropy)](https://opensource.org/licenses/MIT)
+
+---
+
+## ✨ امکانات
+
+| قابلیت | توضیح |
+|--------|-------|
+| 🔐 **لاگین خودکار** | ورود با شماره + کد تأیید، ذخیره سشن |
+| 💬 **استخراج چت‌ها** | لیست همه / شخصی / گروه / کانال |
+| 📨 **ارسال پیام** | تکی و دسته‌ای به چت‌های شخصی |
+| 📢 **ارسال در کانال** | پست گذاشتن (نیاز به ادمین بودن) |
+| 📇 **مدیریت مخاطبین** | مشاهده، اضافه کردن، جستجو |
+| 🤖 **پاسخ خودکار** | موتور قوانین + جلوگیری از پاسخ تکراری |
+| 👁️ **مانیتور مداوم** | بررسی و پاسخ خودکار هر X ثانیه |
+| 👥 **چند اکانت** | مدیریت همزمان چندین حساب |
+| 🖥️ **بدون پنجره** | حالت headless - بدون نمایش مرورگر |
+| 🧵 **Thread-safe** | طراحی ایمن برای چند نخی |
+| 💾 **ذخیره سشن** | بدون نیاز به لاگین مجدد |
+
+---
+
+## 📦 نصب
+
+```bash
+pip install soropy

soropy-1.0.0/examples/auto_reply_example.py

@@ -0,0 +1,41 @@
+"""
+Auto-reply with custom rules.
+"""
+
+from soropy import SoroushClient
+
+client = SoroushClient("09123456789", headless=True)
+
+try:
+    client.login()
+
+    # ── Configure rules ────────────────────────────────
+    client.add_reply_rule("سلام", "علیک سلام! 👋")
+    client.add_reply_rule("چطوری", "خوبم ممنون، تو چطوری؟")
+    client.add_reply_rule("خوبی", "ممنون خوبم! 😊")
+    client.add_reply_rule("خداحافظ", "بای بای! 🙏", priority=10)
+
+    # Or bulk-load from dict:
+    client.load_reply_rules({
+        "قیمت": "لطفاً به سایت مراجعه کنید",
+        "آدرس": "تهران، خیابان ولیعصر",
+    })
+
+    # Set the fallback reply
+    client.set_default_reply("پیامت دریافت شد، به زودی پاسخ میدم ✅")
+
+    # ── Single pass ────────────────────────────────────
+    results = client.check_and_reply()
+    for chat, sends in results.items():
+        for s in sends:
+            print(s)
+
+    # ── Or continuous monitor ──────────────────────────
+    def on_reply(chat_name, original, reply):
+        print(f"📨 {chat_name}: replied '{reply}'")
+
+    # Blocking (Ctrl+C to stop):
+    client.start_monitor(interval=30, blocking=True, on_reply=on_reply)
+
+finally:
+    client.close()

soropy-1.0.0/examples/basic_usage.py

@@ -0,0 +1,51 @@
+"""
+Basic SoroPy usage example.
+"""
+
+from soropy import SoroushClient
+
+# ── Single account ────────────────────────────────────
+
+client = SoroushClient(
+    phone="09123456789",
+    headless=False,       # Set True for invisible browser
+    session_dir="my_sessions",
+)
+
+try:
+    # Login (will prompt for SMS code if needed)
+    status = client.login()
+    print(f"Login status: {status}")
+
+    # Extract chat list
+    chats = client.get_chats(save_to="chats.json")
+    print(f"Total chats: {chats.total_count}")
+    print(f"Personal: {len(chats.personal)}")
+    print(f"Groups: {len(chats.groups)}")
+    print(f"Channels: {len(chats.channels)}")
+
+    # Send a message to a specific chat
+    result = client.send_message("علی", "سلام! حالت خوبه؟")
+    print(result)
+
+    # Send bulk messages to first 5 personal chats
+    results = client.send_to_personal(message="سلام!", max_count=5)
+    for r in results:
+        print(r)
+
+    # Get contacts
+    contacts = client.get_contacts()
+    print(f"Contacts: {len(contacts)}")
+
+    # Add a contact
+    client.add_contact("09187654321", "محمد", "احمدی")
+
+    # Search contacts
+    found = client.search_contacts("محمد")
+    print(f"Found: {found}")
+
+    # Send to channel (admin required)
+    client.send_to_channel("@my_channel", "سلام از SoroPy!")
+
+finally:
+    client.close()

soropy-1.0.0/examples/headless_example.py

@@ -0,0 +1,40 @@
+"""
+Headless (no visible window) operation.
+"""
+
+from soropy import SoroushClient
+
+# The browser runs invisibly
+client = SoroushClient(
+    phone="09123456789",
+    headless=True,
+    session_dir="headless_sessions",
+)
+
+try:
+    # If session exists, no code needed
+    if client.has_session:
+        print("Session found – auto-login")
+        status = client.login()
+    else:
+        # First time: need code
+        def get_code():
+            return input("Enter SMS code: ")
+        status = client.login(code_callback=get_code)
+
+    print(f"Status: {status}")
+
+    # Do work...
+    chats = client.get_chats()
+    print(f"Chats: {chats.total_count}")
+
+    # Single auto-reply pass
+    results = client.check_and_reply()
+    total_ok = sum(
+        1 for sends in results.values()
+        for s in sends if s.success
+    )
+    print(f"Replied to {total_ok} messages")
+
+finally:
+    client.close()

soropy-1.0.0/examples/massage_to_3_PV.py

@@ -0,0 +1,48 @@
+"""
+نمونه کاربردی ساده - لاگین و ارسال به ۳ نفر
+اجرا:
+    pip install soropy
+    python send_three.py
+"""
+
+from soropy import SoroushClient
+
+# ─── مرحله ۱: شماره و لاگین ───────────────────────────
+raw_phone = input("📱 شماره تلفن (مثلاً 09123456789): ").strip()
+
+client = SoroushClient(phone=raw_phone, headless=True)
+
+try:
+    # لاگین - اگه اولین باره کد SMS میخواد
+    status = client.login()
+    print(f"✅ وضعیت: {status.value}")
+
+    # ─── مرحله ۲: گرفتن نام ۳ نفر ─────────────────────
+    targets = []
+    for i in range(1, 4):
+        name = input(f"👤 نام شخص {i}: ").strip()
+        targets.append(name)
+
+    # ─── مرحله ۳: ارسال پیام ──────────────────────────
+    msg = "سلام خوبی؟ 😊"
+    print(f"\n📨 ارسال: '{msg}' به {len(targets)} نفر\n")
+
+    results = client.send_bulk_messages(
+        chat_names=targets,
+        message=msg,
+        delay=3.0,
+    )
+
+    # ─── نتیجه ─────────────────────────────────────────
+    ok = sum(1 for r in results if r.success)
+    fail = len(results) - ok
+
+    print("\n" + "=" * 40)
+    print(f"📊 نتیجه: ✅ {ok} | ❌ {fail}")
+    for r in results:
+        print(f"   {r}")
+    print("=" * 40)
+
+finally:
+    input("\n⏎ Enter بزن تا بسته بشه...")
+    client.close()

soropy-1.0.0/examples/multi_account.py

@@ -0,0 +1,52 @@
+"""
+Multi-account management example.
+"""
+
+from soropy import MultiAccountManager
+
+manager = MultiAccountManager(
+    headless=True,
+    session_dir="multi_sessions",
+)
+
+try:
+    # Register accounts
+    c1 = manager.add_account("09123456789")
+    c2 = manager.add_account("09187654321")
+
+    # Configure rules per-account
+    c1.add_reply_rule("سلام", "سلام از اکانت ۱")
+    c2.add_reply_rule("سلام", "سلام از اکانت ۲")
+
+    # Login all (sequential, will prompt for codes)
+    statuses = manager.login_all()
+    for phone, status in statuses.items():
+        print(f"{phone}: {status.value}")
+
+    # Extract chats for account 1
+    chats = manager.get_client("09123456789").get_chats()
+    print(f"Account 1 chats: {chats.total_count}")
+
+    # Send message from account 2
+    result = manager.get_client("09187654321").send_message("علی", "سلام!")
+    print(result)
+
+    # Start monitors for all accounts
+    def on_any_reply(phone, chat, orig, reply):
+        print(f"[{phone}] {chat} → {reply}")
+
+    threads = manager.start_all_monitors(interval=30, on_reply=on_any_reply)
+    print(f"Monitors running: {len(threads)}")
+
+    # Keep running
+    import time
+    try:
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        pass
+
+    manager.stop_all_monitors()
+
+finally:
+    manager.close_all()

soropy-1.0.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "soropy"
+version = "1.0.0"
+description = "کتابخانه حرفه‌ای سروش پلاس برای پایتون - Professional Soroush Plus Web Client Library"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [
+    {name = "SoroPy Team", email = "soropy@example.com"}
+]
+keywords = ["soroush", "splus", "messenger", "automation", "bot", "soroush-plus"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Communications :: Chat",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "selenium>=4.10.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/soropy/soropy"
+Documentation = "https://soropy.readthedocs.io"
+Repository = "https://github.com/soropy/soropy"
+Issues = "https://github.com/soropy/soropy/issues"
+
+[tool.setuptools.packages.find]
+include = ["soropy*"]

soropy-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

soropy-1.0.0/setup.py

@@ -0,0 +1,21 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="soropy",
+    version="1.0.0",
+    packages=find_packages(),
+    install_requires=[
+        "selenium>=4.10.0",
+    ],
+    python_requires=">=3.8",
+    author="SoroPy Team",
+    description="Professional Soroush Plus Web Client Library for Python",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/soropy/soropy",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+)

soropy-1.0.0/soropy/__init__.py

@@ -0,0 +1,86 @@
+"""
+SoroPy - Professional Soroush Plus Web Client Library
+=====================================================
+
+A comprehensive, production-grade Python library for automating
+Soroush Plus (splus.ir) web messenger.
+
+Features:
+    - Multi-account simultaneous sessions
+    - Headless browser support
+    - Auto-reply with rule engine and duplicate prevention
+    - Chat extraction, messaging, channel posting
+    - Contact management
+    - Persistent session management
+    - Thread-safe design
+
+Basic Usage:
+    >>> from soropy import SoroushClient
+    >>> client = SoroushClient("+989123456789")
+    >>> client.login()
+    >>> chats = client.get_chats()
+    >>> client.send_message("علی", "سلام!")
+    >>> client.close()
+
+Multi-Account:
+    >>> from soropy import MultiAccountManager
+    >>> manager = MultiAccountManager()
+    >>> manager.add_account("+989123456789")
+    >>> manager.add_account("+989187654321")
+    >>> manager.login_all()
+"""
+
+__version__ = "1.0.0"
+__author__ = "SoroPy Team"
+__license__ = "MIT"
+
+from soropy.client import SoroushClient
+from soropy.auto_reply import AutoReplyEngine, ReplyRule
+from soropy.types import (
+    ChatInfo,
+    ContactInfo,
+    MessageInfo,
+    UnreadChat,
+    SendResult,
+    LoginStatus,
+)
+from soropy.exceptions import (
+    SoroPyError,
+    LoginError,
+    SessionError,
+    ChatError,
+    MessageError,
+    ContactError,
+    ChannelError,
+    BrowserError,
+    TimeoutError as SoroPyTimeoutError,
+)
+from soropy.session import SessionManager
+from soropy.message_tracker import MessageTracker
+
+# Multi-account manager
+from soropy.multi import MultiAccountManager
+
+__all__ = [
+    "SoroushClient",
+    "MultiAccountManager",
+    "AutoReplyEngine",
+    "ReplyRule",
+    "ChatInfo",
+    "ContactInfo",
+    "MessageInfo",
+    "UnreadChat",
+    "SendResult",
+    "LoginStatus",
+    "SessionManager",
+    "MessageTracker",
+    "SoroPyError",
+    "LoginError",
+    "SessionError",
+    "ChatError",
+    "MessageError",
+    "ContactError",
+    "ChannelError",
+    "BrowserError",
+    "SoroPyTimeoutError",
+]