soroushthon 0.2.93.dev0__tar.gz → 0.2.94__tar.gz

soroushthon-0.2.94/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: soroushthon
+Version: 0.2.94
+Summary: کلاینت ناهمگام پایتون برای ساخت ابزارهای حساب کاربری سروش‌پلاس
+License-Expression: GPL-3.0-only
+Project-URL: Community, https://splus.ir/soroushthon
+Keywords: soroush plus,asyncio,messaging,user client
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: TELETHON_LICENSE
+License-File: NOTICE.md
+Requires-Dist: aiohttp>=3.8
+Requires-Dist: pyaes>=1.6
+Requires-Dist: rsa>=4
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Requires-Dist: pytest-asyncio>=0.23; extra == "test"
+Provides-Extra: media
+Requires-Dist: hachoir>=3.3; extra == "media"
+Provides-Extra: audio
+Requires-Dist: livekit; extra == "audio"
+Dynamic: license-file
+
+# سروش‌تون | Soroushthon
+
+### سروش‌پلاس را با پایتون به ایده‌هایت وصل کن
+
+یک پیام تازه می‌رسد؛ برنامه‌ات آن را می‌بیند، تصمیم می‌گیرد و پاسخ می‌دهد. **Soroushthon** ابزار پایتونی ناهمگام برای ساخت چنین برنامه‌هایی با **حساب کاربری سروش‌پلاس** است: از یک پاسخ ساده به پیام تا کار با گفتگوها، رسانه‌ها، نظرسنجی‌ها و رویدادها.
+
+کد روزمره را با متدهای آشنا بنویس و وقتی به جزئیات بیشتری نیاز داری، به درخواست‌های خام کتابخانه دسترسی داشته باش. برای هر حساب هم می‌توانی نشست جداگانه نگه داری.
+
+## در چند خط، اولین واکنش را بساز
+
+این نمونه پیام `ping` را که **خودت با همان حساب** می‌فرستی می‌بیند و روی همان پیام پاسخ می‌دهد:
+
+```python
+from soroushthon import SoroushClient
+
+client = SoroushClient.for_account("main")
+
+
+@client.on_message(outgoing=True, pattern=r"(?i)\Aping\Z")
+async def reply_to_ping(event):
+    await client.send_message(
+        await event.get_input_chat(),
+        "pong",
+        reply_to=event.id,
+    )
+
+
+client.start()
+client.run_until_disconnected()
+```
+
+اولین اجرا اطلاعات ورود را درخواست می‌کند. نشست حساب روی دستگاه ذخیره می‌شود؛ فایل‌های `.session` را در اختیار دیگران قرار نده.
+
+## چه چیزهایی می‌توانی بسازی؟
+
+| زمینه | ابزارهای کتابخانه |
+| --- | --- |
+| پیام‌ها | خواندن، جست‌وجو، ارسال، ویرایش، حذف و پاسخ‌دادن به پیام |
+| فایل و رسانه | ارسال و دریافت عکس، ویدئو، صوت و سند |
+| برنامه‌های واکنشی | ثبت تابع برای پیام تازه و دیگر رویدادهای پشتیبانی‌شده |
+| گفتگو و کانال | فهرست گفتگوها، اطلاعات گفتگو، اعضا و نقش‌ها |
+| تعامل | نظرسنجی، رأی و واکنش به پیام |
+| چند حساب | نشست مستقل با `SoroushClient.for_account(...)` |
+| امکانات پیشرفته | دسترسی به درخواست‌های خام برای توسعه و بررسی پروتکل |
+
+متدهای کوتاهی مانند `send`، `messages`، `file`، `poll` و `react` در کنار نام‌های کامل آن‌ها قرار دارند. این نام‌ها برای ساده‌تر نوشتن کدند؛ هر درخواست خامِ موجود در بسته الزاماً روی سرور در همهٔ شرایط آزموده نشده است.
+
+## نصب؛ یک دستور قابل کپی
+
+به Python 3.9 یا جدیدتر نیاز داری. دستورهای زیر فقط از نویسه‌های انگلیسی استفاده می‌کنند:
+
+**Pydroid 3 و Termux** — در ترمینال همان برنامه:
+
+```sh
+python -m pip install --upgrade soroushthon
+```
+
+**VS Code روی Linux یا macOS** — در ترمینال پروژه:
+
+```sh
+python -m pip install --upgrade soroushthon
+```
+
+**VS Code روی Windows** — در ترمینال پروژه:
+
+```powershell
+py -m pip install --upgrade soroushthon
+```
+
+در VS Code مفسر Python همان محیطی را انتخاب کن که دستور نصب را در آن اجرا کردی. روی Android، نصب `aiohttp` و وابستگی‌های آن به سازگاری بسته‌ها با نسخهٔ Python محیطت بستگی دارد؛ در محیطی که این وابستگی‌ها نصب باشند، خود Soroushthon به‌صورت wheel مستقل از معماری ارائه می‌شود.
+
+برای دیدن نسخهٔ نصب‌شده:
+
+```sh
+python -c "import soroushthon; print(soroushthon.__version__)"
+```
+
+در Windows، اگر با `py` نصب کردی، در دستور بررسی هم `python` را با `py` جایگزین کن.
+
+## از اینجا ادامه بده
+
+برای هر حساب یک نام انتخاب کن: `main` برای حساب اصلی یا نام‌هایی مثل `work` برای نشست جدا. برای برنامهٔ ناهمگام موجود هم می‌توانی از `await client.start()` و `await client.disconnect()` استفاده کنی. نصب وابستگی‌های اصلی `aiohttp`، `pyaes` و `rsa` را `pip` انجام می‌دهد؛ بعضی امکانات رسانه‌ای وابستگی اختیاری دارند.
+
+Soroushthon یک پروژهٔ **غیررسمی** است و به برنامهٔ رسمی سروش‌پلاس وابسته نیست. وضعیت اجرای امکانات پیشرفته می‌تواند به پاسخ سرور و نوع گفتگو بستگی داشته باشد. سورس با مجوز **GPL-3.0-only** منتشر می‌شود؛ اطلاعات منشأ کدهای اقتباس‌شده در `NOTICE.md` و `TELETHON_LICENSE` همراه بسته آمده است.
+
+برای گفتگو دربارهٔ پروژه و دیدن نمونه‌های بیشتر: [@soroushthon در سروش‌پلاس](https://splus.ir/soroushthon).

soroushthon-0.2.94/PLATFORMS.md

@@ -0,0 +1,43 @@
+# نصب روی محیط‌های مختلف
+
+نسخهٔ انتشار `0.2.94` برای Python 3.9 یا جدیدتر بسته‌بندی شده است. بستهٔ اصلی `aiohttp`، `pyaes` و `rsa` را از طریق pip دریافت می‌کند. تمام فرمان‌ها در این صفحه انگلیسی و قابل کپی هستند.
+
+## Pydroid 3
+
+در ترمینال Pydroid اجرا کن:
+
+```sh
+python -m pip install --upgrade soroushthon
+python -c "import soroushthon; print(soroushthon.__version__)"
+```
+
+نسخهٔ `aiohttp` و وابستگی‌هایش باید در Python همین برنامه قابل نصب باشند. خرابی داخلی pip را با نصب دوبارهٔ خود pip بررسی کن؛ خطای import در pip نشانهٔ اشکال در بستهٔ Soroushthon نیست.
+
+## Termux
+
+```sh
+python -m pip install --upgrade soroushthon
+python -c "import soroushthon; print(soroushthon.__version__)"
+```
+
+نسخهٔ Python و وابستگی‌های موجود در Termux می‌توانند با Pydroid متفاوت باشند. برای هر محیط باید نصب را در ترمینال خودش انجام دهی.
+
+## VS Code روی Linux یا macOS
+
+```sh
+python -m venv .venv
+.venv/bin/python -m pip install --upgrade soroushthon
+.venv/bin/python -c "import soroushthon; print(soroushthon.__version__)"
+```
+
+در VS Code مفسر `.venv` همین پروژه را انتخاب کن.
+
+## VS Code روی Windows
+
+```powershell
+py -m venv .venv
+.venv\Scripts\python.exe -m pip install --upgrade soroushthon
+.venv\Scripts\python.exe -c "import soroushthon; print(soroushthon.__version__)"
+```
+
+موفقیت نصب روی یک سیستم، اجرای همهٔ قابلیت‌های وابسته به پاسخ سرور را در سیستم‌های دیگر اثبات نمی‌کند. فایل نشست حساب را عمومی منتشر نکن.

soroushthon-0.2.94/PUBLISHING.md

@@ -0,0 +1,41 @@
+# انتشار نسخهٔ 0.2.94
+
+این پوشه سورس نسخهٔ نهایی `0.2.94` است. متن `PYPI_README.md` توضیح صفحهٔ PyPI است. نام و نسخهٔ بستهٔ منتشرشده را نمی‌توان با همان نام فایل دوباره جایگزین کرد.
+
+## کنترل پیش از ارسال
+
+```sh
+python -m pip install build twine
+python -m pytest -q
+python -m build
+python -m twine check dist/*
+python tools/check_release.py dist
+```
+
+پس از ساخت، نصب و import بسته را در محیطی جدا از پوشهٔ سورس امتحان کن. روی یک حساب آزمایشی مسیر ورود، دریافت و ارسال پیام، رویداد، رسانه و اتصال مجدد را اجرا و نتیجه را بررسی کن. فایل نشست یا دادهٔ حساب نباید در بسته باشد. آزمون محلی جای بررسی زنده را نمی‌گیرد.
+
+## ارسال از Termux به PyPI
+
+ZIP انتشار را در پوشهٔ Downloads گوشی ذخیره کن. اگر دسترسی Termux به حافظه را قبلاً فعال نکرده‌ای، یک‌بار `termux-setup-storage` را اجرا کن و اجازهٔ Android را بده. سپس این فرمان‌ها را در Termux اجرا کن:
+
+```sh
+mkdir -p ~/soroushthon-upload-0.2.94
+cd ~/soroushthon-upload-0.2.94
+cp ~/storage/downloads/soroushthon-0.2.94-release.zip .
+python -m zipfile -e soroushthon-0.2.94-release.zip .
+sha256sum -c SHA256SUMS.txt
+python -m pip install twine
+python -m twine check --strict dist/soroushthon-0.2.94.tar.gz dist/soroushthon-0.2.94-py3-none-any.whl
+python -m twine upload --repository pypi --username __token__ dist/soroushthon-0.2.94.tar.gz dist/soroushthon-0.2.94-py3-none-any.whl
+```
+
+در درخواست `Password:`، توکن API پروژهٔ `soroushthon` را وارد کن. هنگام تایپ توکن چیزی روی صفحه نشان داده نمی‌شود. توکن را داخل فرمان، فایل یا پیام قرار نده.
+
+پس از انتشار، در Python محیط مقصد این دو دستور را اجرا و شمارهٔ نسخه را بررسی کن:
+
+```sh
+python -m pip install --upgrade --no-cache-dir soroushthon
+python -c "import soroushthon; print(soroushthon.__version__)"
+```
+
+نسخهٔ توسعه‌ای `0.2.93.dev0` و نسخهٔ پایدار قبلی `0.2.21` را برای تغییر صفحهٔ اصلی PyPI لازم نیست پاک کنی؛ نسخهٔ نهایی تازه با نصب معمولی انتخاب می‌شود. حذف نسخهٔ قدیمی نصب کاربرانی را که آن را پین کرده‌اند خراب می‌کند.

soroushthon-0.2.94/PYPI_README.md

@@ -0,0 +1,86 @@
+# سروش‌تون | Soroushthon
+
+### سروش‌پلاس را با پایتون به ایده‌هایت وصل کن
+
+یک پیام تازه می‌رسد؛ برنامه‌ات آن را می‌بیند، تصمیم می‌گیرد و پاسخ می‌دهد. **Soroushthon** ابزار پایتونی ناهمگام برای ساخت چنین برنامه‌هایی با **حساب کاربری سروش‌پلاس** است: از یک پاسخ ساده به پیام تا کار با گفتگوها، رسانه‌ها، نظرسنجی‌ها و رویدادها.
+
+کد روزمره را با متدهای آشنا بنویس و وقتی به جزئیات بیشتری نیاز داری، به درخواست‌های خام کتابخانه دسترسی داشته باش. برای هر حساب هم می‌توانی نشست جداگانه نگه داری.
+
+## در چند خط، اولین واکنش را بساز
+
+این نمونه پیام `ping` را که **خودت با همان حساب** می‌فرستی می‌بیند و روی همان پیام پاسخ می‌دهد:
+
+```python
+from soroushthon import SoroushClient
+
+client = SoroushClient.for_account("main")
+
+
+@client.on_message(outgoing=True, pattern=r"(?i)\Aping\Z")
+async def reply_to_ping(event):
+    await client.send_message(
+        await event.get_input_chat(),
+        "pong",
+        reply_to=event.id,
+    )
+
+
+client.start()
+client.run_until_disconnected()
+```
+
+اولین اجرا اطلاعات ورود را درخواست می‌کند. نشست حساب روی دستگاه ذخیره می‌شود؛ فایل‌های `.session` را در اختیار دیگران قرار نده.
+
+## چه چیزهایی می‌توانی بسازی؟
+
+| زمینه | ابزارهای کتابخانه |
+| --- | --- |
+| پیام‌ها | خواندن، جست‌وجو، ارسال، ویرایش، حذف و پاسخ‌دادن به پیام |
+| فایل و رسانه | ارسال و دریافت عکس، ویدئو، صوت و سند |
+| برنامه‌های واکنشی | ثبت تابع برای پیام تازه و دیگر رویدادهای پشتیبانی‌شده |
+| گفتگو و کانال | فهرست گفتگوها، اطلاعات گفتگو، اعضا و نقش‌ها |
+| تعامل | نظرسنجی، رأی و واکنش به پیام |
+| چند حساب | نشست مستقل با `SoroushClient.for_account(...)` |
+| امکانات پیشرفته | دسترسی به درخواست‌های خام برای توسعه و بررسی پروتکل |
+
+متدهای کوتاهی مانند `send`، `messages`، `file`، `poll` و `react` در کنار نام‌های کامل آن‌ها قرار دارند. این نام‌ها برای ساده‌تر نوشتن کدند؛ هر درخواست خامِ موجود در بسته الزاماً روی سرور در همهٔ شرایط آزموده نشده است.
+
+## نصب؛ یک دستور قابل کپی
+
+به Python 3.9 یا جدیدتر نیاز داری. دستورهای زیر فقط از نویسه‌های انگلیسی استفاده می‌کنند:
+
+**Pydroid 3 و Termux** — در ترمینال همان برنامه:
+
+```sh
+python -m pip install --upgrade soroushthon
+```
+
+**VS Code روی Linux یا macOS** — در ترمینال پروژه:
+
+```sh
+python -m pip install --upgrade soroushthon
+```
+
+**VS Code روی Windows** — در ترمینال پروژه:
+
+```powershell
+py -m pip install --upgrade soroushthon
+```
+
+در VS Code مفسر Python همان محیطی را انتخاب کن که دستور نصب را در آن اجرا کردی. روی Android، نصب `aiohttp` و وابستگی‌های آن به سازگاری بسته‌ها با نسخهٔ Python محیطت بستگی دارد؛ در محیطی که این وابستگی‌ها نصب باشند، خود Soroushthon به‌صورت wheel مستقل از معماری ارائه می‌شود.
+
+برای دیدن نسخهٔ نصب‌شده:
+
+```sh
+python -c "import soroushthon; print(soroushthon.__version__)"
+```
+
+در Windows، اگر با `py` نصب کردی، در دستور بررسی هم `python` را با `py` جایگزین کن.
+
+## از اینجا ادامه بده
+
+برای هر حساب یک نام انتخاب کن: `main` برای حساب اصلی یا نام‌هایی مثل `work` برای نشست جدا. برای برنامهٔ ناهمگام موجود هم می‌توانی از `await client.start()` و `await client.disconnect()` استفاده کنی. نصب وابستگی‌های اصلی `aiohttp`، `pyaes` و `rsa` را `pip` انجام می‌دهد؛ بعضی امکانات رسانه‌ای وابستگی اختیاری دارند.
+
+Soroushthon یک پروژهٔ **غیررسمی** است و به برنامهٔ رسمی سروش‌پلاس وابسته نیست. وضعیت اجرای امکانات پیشرفته می‌تواند به پاسخ سرور و نوع گفتگو بستگی داشته باشد. سورس با مجوز **GPL-3.0-only** منتشر می‌شود؛ اطلاعات منشأ کدهای اقتباس‌شده در `NOTICE.md` و `TELETHON_LICENSE` همراه بسته آمده است.
+
+برای گفتگو دربارهٔ پروژه و دیدن نمونه‌های بیشتر: [@soroushthon در سروش‌پلاس](https://splus.ir/soroushthon).

soroushthon-0.2.94/README.md

@@ -0,0 +1,92 @@
+# سروش‌تون | Soroushthon
+
+### سروش‌پلاس را با پایتون به ایده‌هایت وصل کن
+
+یک پیام تازه می‌رسد؛ برنامه‌ات آن را می‌بیند، تصمیم می‌گیرد و پاسخ می‌دهد. **Soroushthon** ابزار پایتونی ناهمگام برای ساخت چنین برنامه‌هایی با **حساب کاربری سروش‌پلاس** است: از یک پاسخ ساده به پیام تا کار با گفتگوها، رسانه‌ها، نظرسنجی‌ها و رویدادها.
+
+کد روزمره را با متدهای آشنا بنویس و وقتی به جزئیات بیشتری نیاز داری، به درخواست‌های خام کتابخانه دسترسی داشته باش. برای هر حساب هم می‌توانی نشست جداگانه نگه داری.
+
+## در چند خط، اولین واکنش را بساز
+
+این نمونه پیام `ping` را که **خودت با همان حساب** می‌فرستی می‌بیند و روی همان پیام پاسخ می‌دهد:
+
+```python
+from soroushthon import SoroushClient
+
+client = SoroushClient.for_account("main")
+
+
+@client.on_message(outgoing=True, pattern=r"(?i)\Aping\Z")
+async def reply_to_ping(event):
+    await client.send_message(
+        await event.get_input_chat(),
+        "pong",
+        reply_to=event.id,
+    )
+
+
+client.start()
+client.run_until_disconnected()
+```
+
+اولین اجرا اطلاعات ورود را درخواست می‌کند. نشست حساب روی دستگاه ذخیره می‌شود؛ فایل‌های `.session` را در اختیار دیگران قرار نده.
+
+## چه چیزهایی می‌توانی بسازی؟
+
+| زمینه | ابزارهای کتابخانه |
+| --- | --- |
+| پیام‌ها | خواندن، جست‌وجو، ارسال، ویرایش، حذف و پاسخ‌دادن به پیام |
+| فایل و رسانه | ارسال و دریافت عکس، ویدئو، صوت و سند |
+| برنامه‌های واکنشی | ثبت تابع برای پیام تازه و دیگر رویدادهای پشتیبانی‌شده |
+| گفتگو و کانال | فهرست گفتگوها، اطلاعات گفتگو، اعضا و نقش‌ها |
+| تعامل | نظرسنجی، رأی و واکنش به پیام |
+| چند حساب | نشست مستقل با `SoroushClient.for_account(...)` |
+| امکانات پیشرفته | دسترسی به درخواست‌های خام برای توسعه و بررسی پروتکل |
+
+متدهای کوتاهی مانند `send`، `messages`، `file`، `poll` و `react` در کنار نام‌های کامل آن‌ها قرار دارند. این نام‌ها برای ساده‌تر نوشتن کدند؛ هر درخواست خامِ موجود در بسته الزاماً روی سرور در همهٔ شرایط آزموده نشده است.
+
+## نصب؛ یک دستور قابل کپی
+
+به Python 3.9 یا جدیدتر نیاز داری. دستورهای زیر فقط از نویسه‌های انگلیسی استفاده می‌کنند:
+
+**Pydroid 3 و Termux** — در ترمینال همان برنامه:
+
+```sh
+python -m pip install --upgrade soroushthon
+```
+
+**VS Code روی Linux یا macOS** — در ترمینال پروژه:
+
+```sh
+python -m pip install --upgrade soroushthon
+```
+
+**VS Code روی Windows** — در ترمینال پروژه:
+
+```powershell
+py -m pip install --upgrade soroushthon
+```
+
+در VS Code مفسر Python همان محیطی را انتخاب کن که دستور نصب را در آن اجرا کردی. روی Android، نصب `aiohttp` و وابستگی‌های آن به سازگاری بسته‌ها با نسخهٔ Python محیطت بستگی دارد؛ در محیطی که این وابستگی‌ها نصب باشند، خود Soroushthon به‌صورت wheel مستقل از معماری ارائه می‌شود.
+
+برای دیدن نسخهٔ نصب‌شده:
+
+```sh
+python -c "import soroushthon; print(soroushthon.__version__)"
+```
+
+در Windows، اگر با `py` نصب کردی، در دستور بررسی هم `python` را با `py` جایگزین کن.
+
+## از اینجا ادامه بده
+
+برای هر حساب یک نام انتخاب کن: `main` برای حساب اصلی یا نام‌هایی مثل `work` برای نشست جدا. برای برنامهٔ ناهمگام موجود هم می‌توانی از `await client.start()` و `await client.disconnect()` استفاده کنی. نصب وابستگی‌های اصلی `aiohttp`، `pyaes` و `rsa` را `pip` انجام می‌دهد؛ بعضی امکانات رسانه‌ای وابستگی اختیاری دارند.
+
+Soroushthon یک پروژهٔ **غیررسمی** است و به برنامهٔ رسمی سروش‌پلاس وابسته نیست. وضعیت اجرای امکانات پیشرفته می‌تواند به پاسخ سرور و نوع گفتگو بستگی داشته باشد. سورس با مجوز **GPL-3.0-only** منتشر می‌شود؛ اطلاعات منشأ کدهای اقتباس‌شده در `NOTICE.md` و `TELETHON_LICENSE` همراه بسته آمده است.
+
+برای گفتگو دربارهٔ پروژه و دیدن نمونه‌های بیشتر: [@soroushthon در سروش‌پلاس](https://splus.ir/soroushthon).
+
+## راهنماهای بیشتر در سورس
+
+- [نمونه‌های برنامه](examples/) و [فهرست امکانات](CAPABILITIES.md)
+- [پیام و رسانه](MEDIA.md)، [نظرسنجی و واکنش](INTERACTIONS.md) و [راهنمای Termux](TERMUX_TESTING.md)
+- [منشأ کدها و مجوزها](NOTICE.md)

{soroushthon-0.2.93.dev0 → soroushthon-0.2.94}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "soroushthon"
-version = "0.2.93.dev0"
-description = "کتابخانهٔ ناهمگام پایتون برای حساب کاربری سروش‌پلاس"
+version = "0.2.94"
+description = "کلاینت ناهمگام پایتون برای ساخت ابزارهای حساب کاربری سروش‌پلاس"
 readme = "PYPI_README.md"
 requires-python = ">=3.9"
 license = "GPL-3.0-only"
@@ -18,6 +18,9 @@ classifiers = [
   "Topic :: Communications :: Chat",
 ]
 
+[project.urls]
+Community = "https://splus.ir/soroushthon"
+
 [project.optional-dependencies]
 test = ["pytest>=7", "pytest-asyncio>=0.23"]
 media = ["hachoir>=3.3"]

soroushthon-0.2.94/soroushthon/version.py

@@ -0,0 +1 @@
+__version__ = '0.2.94'

soroushthon-0.2.94/soroushthon.egg-info/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: soroushthon
+Version: 0.2.94
+Summary: کلاینت ناهمگام پایتون برای ساخت ابزارهای حساب کاربری سروش‌پلاس
+License-Expression: GPL-3.0-only
+Project-URL: Community, https://splus.ir/soroushthon
+Keywords: soroush plus,asyncio,messaging,user client
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: TELETHON_LICENSE
+License-File: NOTICE.md
+Requires-Dist: aiohttp>=3.8
+Requires-Dist: pyaes>=1.6
+Requires-Dist: rsa>=4
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Requires-Dist: pytest-asyncio>=0.23; extra == "test"
+Provides-Extra: media
+Requires-Dist: hachoir>=3.3; extra == "media"
+Provides-Extra: audio
+Requires-Dist: livekit; extra == "audio"
+Dynamic: license-file
+
+# سروش‌تون | Soroushthon
+
+### سروش‌پلاس را با پایتون به ایده‌هایت وصل کن
+
+یک پیام تازه می‌رسد؛ برنامه‌ات آن را می‌بیند، تصمیم می‌گیرد و پاسخ می‌دهد. **Soroushthon** ابزار پایتونی ناهمگام برای ساخت چنین برنامه‌هایی با **حساب کاربری سروش‌پلاس** است: از یک پاسخ ساده به پیام تا کار با گفتگوها، رسانه‌ها، نظرسنجی‌ها و رویدادها.
+
+کد روزمره را با متدهای آشنا بنویس و وقتی به جزئیات بیشتری نیاز داری، به درخواست‌های خام کتابخانه دسترسی داشته باش. برای هر حساب هم می‌توانی نشست جداگانه نگه داری.
+
+## در چند خط، اولین واکنش را بساز
+
+این نمونه پیام `ping` را که **خودت با همان حساب** می‌فرستی می‌بیند و روی همان پیام پاسخ می‌دهد:
+
+```python
+from soroushthon import SoroushClient
+
+client = SoroushClient.for_account("main")
+
+
+@client.on_message(outgoing=True, pattern=r"(?i)\Aping\Z")
+async def reply_to_ping(event):
+    await client.send_message(
+        await event.get_input_chat(),
+        "pong",
+        reply_to=event.id,
+    )
+
+
+client.start()
+client.run_until_disconnected()
+```
+
+اولین اجرا اطلاعات ورود را درخواست می‌کند. نشست حساب روی دستگاه ذخیره می‌شود؛ فایل‌های `.session` را در اختیار دیگران قرار نده.
+
+## چه چیزهایی می‌توانی بسازی؟
+
+| زمینه | ابزارهای کتابخانه |
+| --- | --- |
+| پیام‌ها | خواندن، جست‌وجو، ارسال، ویرایش، حذف و پاسخ‌دادن به پیام |
+| فایل و رسانه | ارسال و دریافت عکس، ویدئو، صوت و سند |
+| برنامه‌های واکنشی | ثبت تابع برای پیام تازه و دیگر رویدادهای پشتیبانی‌شده |
+| گفتگو و کانال | فهرست گفتگوها، اطلاعات گفتگو، اعضا و نقش‌ها |
+| تعامل | نظرسنجی، رأی و واکنش به پیام |
+| چند حساب | نشست مستقل با `SoroushClient.for_account(...)` |
+| امکانات پیشرفته | دسترسی به درخواست‌های خام برای توسعه و بررسی پروتکل |
+
+متدهای کوتاهی مانند `send`، `messages`، `file`، `poll` و `react` در کنار نام‌های کامل آن‌ها قرار دارند. این نام‌ها برای ساده‌تر نوشتن کدند؛ هر درخواست خامِ موجود در بسته الزاماً روی سرور در همهٔ شرایط آزموده نشده است.
+
+## نصب؛ یک دستور قابل کپی
+
+به Python 3.9 یا جدیدتر نیاز داری. دستورهای زیر فقط از نویسه‌های انگلیسی استفاده می‌کنند:
+
+**Pydroid 3 و Termux** — در ترمینال همان برنامه:
+
+```sh
+python -m pip install --upgrade soroushthon
+```
+
+**VS Code روی Linux یا macOS** — در ترمینال پروژه:
+
+```sh
+python -m pip install --upgrade soroushthon
+```
+
+**VS Code روی Windows** — در ترمینال پروژه:
+
+```powershell
+py -m pip install --upgrade soroushthon
+```
+
+در VS Code مفسر Python همان محیطی را انتخاب کن که دستور نصب را در آن اجرا کردی. روی Android، نصب `aiohttp` و وابستگی‌های آن به سازگاری بسته‌ها با نسخهٔ Python محیطت بستگی دارد؛ در محیطی که این وابستگی‌ها نصب باشند، خود Soroushthon به‌صورت wheel مستقل از معماری ارائه می‌شود.
+
+برای دیدن نسخهٔ نصب‌شده:
+
+```sh
+python -c "import soroushthon; print(soroushthon.__version__)"
+```
+
+در Windows، اگر با `py` نصب کردی، در دستور بررسی هم `python` را با `py` جایگزین کن.
+
+## از اینجا ادامه بده
+
+برای هر حساب یک نام انتخاب کن: `main` برای حساب اصلی یا نام‌هایی مثل `work` برای نشست جدا. برای برنامهٔ ناهمگام موجود هم می‌توانی از `await client.start()` و `await client.disconnect()` استفاده کنی. نصب وابستگی‌های اصلی `aiohttp`، `pyaes` و `rsa` را `pip` انجام می‌دهد؛ بعضی امکانات رسانه‌ای وابستگی اختیاری دارند.
+
+Soroushthon یک پروژهٔ **غیررسمی** است و به برنامهٔ رسمی سروش‌پلاس وابسته نیست. وضعیت اجرای امکانات پیشرفته می‌تواند به پاسخ سرور و نوع گفتگو بستگی داشته باشد. سورس با مجوز **GPL-3.0-only** منتشر می‌شود؛ اطلاعات منشأ کدهای اقتباس‌شده در `NOTICE.md` و `TELETHON_LICENSE` همراه بسته آمده است.
+
+برای گفتگو دربارهٔ پروژه و دیدن نمونه‌های بیشتر: [@soroushthon در سروش‌پلاس](https://splus.ir/soroushthon).

soroushthon-0.2.93.dev0/PKG-INFO

@@ -1,78 +0,0 @@
-Metadata-Version: 2.4
-Name: soroushthon
-Version: 0.2.93.dev0
-Summary: کتابخانهٔ ناهمگام پایتون برای حساب کاربری سروش‌پلاس
-License-Expression: GPL-3.0-only
-Keywords: soroush plus,asyncio,messaging,user client
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Communications :: Chat
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-License-File: TELETHON_LICENSE
-License-File: NOTICE.md
-Requires-Dist: aiohttp>=3.8
-Requires-Dist: pyaes>=1.6
-Requires-Dist: rsa>=4
-Provides-Extra: test
-Requires-Dist: pytest>=7; extra == "test"
-Requires-Dist: pytest-asyncio>=0.23; extra == "test"
-Provides-Extra: media
-Requires-Dist: hachoir>=3.3; extra == "media"
-Provides-Extra: audio
-Requires-Dist: livekit; extra == "audio"
-Dynamic: license-file
-
-# سروش‌تون | Soroushthon
-
-### پایتون و حساب سروش‌پلاس؛ بقیه‌اش با ایدهٔ خودت
-
-سروش‌تون را ساخته‌ام تا برای کارهای تکراریِ سروش‌پلاس لازم نباشد هر بار از اول با جزئیات پروتکل درگیر شوم. وقتی می‌خواهم پیام‌ها را بخوانم، فایلی بفرستم، برای یک گروه برنامه بنویسم یا به رویدادهای تازه واکنش نشان بدهم، ترجیح می‌دهم کد برنامه‌ام را ببینم، نه انبوهی از درخواست‌های ریز را.
-
-برای همین متدهای روزمره را کوتاه و سرراست نگه داشته‌ام و راهِ استفاده از درخواست‌های خام را هم باز گذاشته‌ام. کتابخانه با **حساب کاربری سروش‌پلاس** و `asyncio` کار می‌کند؛ می‌توانی برای هر حساب نشست خودش را داشته باشی.
-
-چند کاری که می‌شود باهاش انجام داد:
-
-- خواندن، جست‌وجو، فرستادن، ویرایش و حذف پیام در گفتگوی خصوصی، گروه و کانال
-- فرستادن و دریافت عکس، ویدئو، صوت، پیام صوتی و فایل
-- نوشتن برنامه‌هایی که به پیام و رویداد تازه واکنش نشان می‌دهند
-- کار با نظرسنجی، رأی و واکنش
-- خواندن اطلاعات گروه و کانال، اعضا و نقش‌ها، و بررسی عضویت کاربر مشخص
-- ساخت و فرستادن لینک نشست کنفرانس در گفتگو
-
-## یک شروع کوتاه
-
-```bash
-python -m pip install soroushthon
-```
-
-```python
-import asyncio
-from soroushthon import SoroushClient
-
-
-async def main():
-    client = SoroushClient.for_account('main')
-    await client.start()
-    try:
-        me = await client.me()
-        print('شناسهٔ حساب:', me.id)
-
-        await client.send('me', 'سلام از سروش‌تون!')
-
-        chat = await client.bind_chat('@my_channel')
-        for message in await chat.messages(limit=5):
-            print(message)
-    finally:
-        await client.disconnect()
-
-
-asyncio.run(main())
-```
-
-پایتون ۳٫۹ یا جدیدتر کافی است. برای حساب دوم هم می‌توانی به‌جای `main` یک نام دیگر مثل `work` بگذاری؛ نشست‌ها جدا نگه داشته می‌شوند.
-
-اگر داری با سروش‌تون برنامه می‌سازی، خبرهای نسخه‌های تازه را می‌خواهی یا جایی از کار سؤال داری، به [گپ/کانال `@soroushthon` در سروش‌پلاس](https://splus.ir/soroushthon) بیا. سورس، نمونه‌ها و راهنماهای بیشتر هم در مخزن پروژه قرار دارند.
-
-این پروژه با مجوز **GPLv3** منتشر می‌شود؛ اطلاعات منشأ کدهای اقتباس‌شده همراه سورس آمده است.

soroushthon-0.2.93.dev0/PLATFORMS.md

@@ -1,44 +0,0 @@
-# اجرای کتابخانه در محیط‌های مختلف
-
-VS Code ویرایشگر است؛ اجرای برنامه به Python انتخاب‌شده در آن بستگی دارد. برای توسعه، رباتِ روی هاست و Termux از همان API `SoroushClient` استفاده کن. هستهٔ پیام، فایل، نظرسنجی، رویداد و ساخت لینک کنفرانس به `livekit` و `ffmpeg` وابسته نیست. اتصال به اتاق صوتی یا پخش فایل صوتی در تماس اختیاری و جداست.
-
-این سورس توسعه هنوز منتشر نشده است؛ `pip install soroushthon` از PyPI نسخهٔ قبلی را می‌گیرد. پوشهٔ سورس را روی محیط مقصد منتقل و از داخل آن نصب کن. بستهٔ جاری `aiohttp`، `pyaes` و `rsa` را به‌عنوان وابستگی پایه تعریف می‌کند.
-
-## لینوکس، macOS و هاست لینوکسی
-
-```sh
-cd soroushthon-0.2.35-dev
-python3 -m venv .venv
-.venv/bin/python -m pip install -e .
-.venv/bin/python -c "import soroushthon; print(soroushthon.__version__)"
-```
-
-روی هاست، فرآیند ربات باید در حال اجرا بماند و شبکهٔ خروجی و فضای پایدار برای فایل نشست داشته باشد. نخستین ورود معمولاً کد تأیید می‌خواهد؛ فایل نشست را عمومی یا داخل مخزن منتشر نکن. `for_account('test')` در خانهٔ کاربر اجراکننده یک نشست جدا می‌سازد. فایل نشستِ ایجادشده را بدون نیاز یا مجوز به محیط دیگری منتقل نکن.
-
-## Windows و VS Code
-
-در PowerShell داخل پوشهٔ سورس:
-
-```powershell
-py -m venv .venv
-.venv\Scripts\python.exe -m pip install -e .
-.venv\Scripts\python.exe -c "import soroushthon; print(soroushthon.__version__)"
-```
-
-در VS Code دستور **Python: Select Interpreter** را اجرا و Python داخل همین `.venv` را انتخاب کن. اجرای برنامه روی VS Code، PowerShell یا یک هاست باید همان نسخهٔ کتابخانه را از همان محیط Python import کند.
-
-## Termux
-
-پس از استخراج ZIP در خانهٔ Termux، اگر وابستگی‌های پایهٔ نسخهٔ قبلی را نصب کرده‌ای:
-
-```sh
-cd ~/soroushthon-0.2.35-dev
-python -c "import soroushthon; print(soroushthon.__version__)"
-python examples/full_coverage.py --account test --only-conference --create-meet
-```
-
-برای استفاده از کتابخانه در یک پروژهٔ دیگر، آن را در محیط Python همان پروژه نصب کن. اگر محیط مجازی جدا ساخته‌ای، دستور نصب را از Python همان محیط اجرا کن. ساخت کنفرانس مستقل هیچ وابستگی صوتی ندارد. گوشی آزمایشی `armv7l` است و در آن `livekit` و `ffmpeg` نصب نبودند؛ از این نتیجه نمی‌توان دربارهٔ نصب یا اجرای رسانه روی سرور لینوکسی یا رایانه نتیجه گرفت.
-
-## مرز تأیید
-
-آزمون‌های محلی در Linux اجرا شده‌اند؛ حساب آزمایشی از Termux ساخت، ورود، خروج و پایان کنفرانس مستقل را تأیید کرد. فایل `.github/workflows/check.yml` ماتریس Python 3.12 و 3.13 روی Linux، Windows و macOS را تعریف می‌کند؛ این ماتریس بعد از قرارگرفتن پروژه در مخزن GitHub اجرا می‌شود و در حال حاضر نتیجه‌ای برای Windows/macOS نداریم. رفتار شبکه و قابلیت‌های خاص سرور نیز جدا از موفقیت آزمون‌های محلی است.