soroushthon 0.2.93.dev0__tar.gz → 0.2.95__tar.gz

soroushthon-0.2.95/ADAPTIVE_UPDATES.md

@@ -0,0 +1,41 @@
+# بازیابی انتخابی رویدادهای دیررس گروه
+
+وقتی حساب در گروه‌های زیادی عضو است، پیام‌های بعضی گروه‌ها ممکن است دیرتر از زمان ثبت‌شدهٔ خود پیام به برنامه برسند. قابلیت آزمایشی این نسخه زمان پیام پذیرفته‌شده از اتصال زنده را با ساعت دستگاه مقایسه می‌کند. اگر از یک گروه دو پیام دیررس نزدیک به هم برسد، برای مدت محدودی اختلاف رویدادهای همان گروه را از سرور درخواست می‌کند. این قابلیت همهٔ گروه‌ها را دوره‌ای نمی‌پیماید.
+
+## فعال‌سازی برای آزمایش
+
+این قابلیت در سورس انتشار `0.2.95` قرار دارد و به‌صورت پیش‌فرض خاموش است. پس از نصب نسخهٔ جدید، در ساخت کلاینت بنویس:
+
+```python
+from soroushthon import SoroushClient
+
+client = SoroushClient.for_account("main", adaptive_update_polling=True)
+
+
+@client.on_message()
+async def on_message(event):
+    print(event.chat_id, event.id)
+
+
+client.start()
+client.run_until_disconnected()
+```
+
+برای دیدن شمارنده‌ها در برنامهٔ در حال اجرا:
+
+```python
+print(client.adaptive_update_stats())
+```
+
+خروجی شامل `hot_groups`، `polls`، `recovered_updates`، `live_wins`، `busy_skips`، `errors`، `observed_messages` و `lag_p95_seconds` است. مقدار آخر صدک تقریبی تأخیر در حداکثر ۵۱۲ پیام گروهی اخیر است؛ اختلاف ساعت دستگاه و سرور روی آن اثر می‌گذارد. قبل از مقایسه، ساعت دستگاه را با زمان شبکه هماهنگ کن و روی یک حساب یکسان مدتی با گزینهٔ خاموش و روشن آزمایش کن.
+
+## حدود و رفتار
+
+- تشخیص پس از ۲۰ ثانیهٔ آغاز اتصال و با آستانهٔ دو ثانیه تأخیر شروع می‌شود. فقط گروه‌هایی که نوعشان در حافظهٔ کلاینت شناخته شده و `pts` معتبر دارند بررسی می‌شوند.
+- بعد از اتصال مجدد، نوع گروه‌های ذخیره‌شده ممکن است موقتاً فقط به‌صورت کانال شناخته شود؛ در این حالت تا دریافت اطلاعات تازهٔ گروه، بازیابی انتخابی آن فعال نمی‌شود.
+- در هر حساب حداکثر ۸ گروهِ فعال هم‌زمان نگه داشته می‌شود. بین درخواست‌های حساب دست‌کم ۲٫۵ ثانیه فاصله است. گروه‌های پررفت‌وآمد موقتاً کنار گذاشته می‌شوند تا بار اضافه تأخیر را بیشتر نکند.
+- پاسخ سرور تنها وقتی به حالت رویدادها اعمال می‌شود که در این فاصله رویداد زنده یا بازیابی معمول جلو نیفتاده باشد. رویدادهای بازیابی‌شده از مسیر عادی هندلرها عبور می‌کنند؛ رویداد تکراری نباید دوباره پردازش شود.
+- اگر سرور پاسخ `ChannelDifferenceTooLong` بدهد، این مسیر از پرش خودکار به انتهای تاریخچه خودداری می‌کند. در آن حالت بازیابیِ کامل رویدادهای قدیمی تضمین نمی‌شود.
+- این قابلیت برای پیام‌های گروهی کانال‌پایه است. برای حساب‌ها یا شبکه‌هایی با وضعیت متفاوت، کاهش تأخیر هنوز باید به‌صورت زنده سنجیده شود. تعداد درخواست‌ها را با `polls` و خطاها را با `errors` کنترل کن.
+
+برای خاموش‌کردن، `adaptive_update_polling=True` را از سازنده بردار و برنامه را دوباره اجرا کن.

{soroushthon-0.2.93.dev0 → soroushthon-0.2.95}/CAPABILITIES.json

@@ -1744,10 +1744,18 @@
       "missing_direct_raw_refs": [],
       "status": "not_live_verified"
     },
+    {
+      "name": "UpdateMethods.adaptive_update_stats",
+      "kind": "sync/property",
+      "source": "soroushthon/client/updates.py:42",
+      "direct_raw_refs": [],
+      "missing_direct_raw_refs": [],
+      "status": "not_live_verified"
+    },
     {
       "name": "UpdateMethods.add_event_handler",
       "kind": "sync/property",
-      "source": "soroushthon/client/updates.py:145",
+      "source": "soroushthon/client/updates.py:165",
       "direct_raw_refs": [],
       "missing_direct_raw_refs": [],
       "status": "not_live_verified"
@@ -1755,7 +1763,7 @@
     {
       "name": "UpdateMethods.catch_up",
       "kind": "async",
-      "source": "soroushthon/client/updates.py:254",
+      "source": "soroushthon/client/updates.py:274",
       "direct_raw_refs": [],
       "missing_direct_raw_refs": [],
       "status": "not_live_verified"
@@ -1763,7 +1771,7 @@
     {
       "name": "UpdateMethods.list_event_handlers",
       "kind": "sync/property",
-      "source": "soroushthon/client/updates.py:233",
+      "source": "soroushthon/client/updates.py:253",
       "direct_raw_refs": [],
       "missing_direct_raw_refs": [],
       "status": "not_live_verified"
@@ -1771,7 +1779,7 @@
     {
       "name": "UpdateMethods.on",
       "kind": "sync/property",
-      "source": "soroushthon/client/updates.py:118",
+      "source": "soroushthon/client/updates.py:138",
       "direct_raw_refs": [],
       "missing_direct_raw_refs": [],
       "status": "not_live_verified"
@@ -1779,7 +1787,7 @@
     {
       "name": "UpdateMethods.remove_event_handler",
       "kind": "sync/property",
-      "source": "soroushthon/client/updates.py:194",
+      "source": "soroushthon/client/updates.py:214",
       "direct_raw_refs": [],
       "missing_direct_raw_refs": [],
       "status": "not_live_verified"
@@ -1787,7 +1795,7 @@
     {
       "name": "UpdateMethods.run_until_disconnected",
       "kind": "sync/property",
-      "source": "soroushthon/client/updates.py:71",
+      "source": "soroushthon/client/updates.py:91",
       "direct_raw_refs": [],
       "missing_direct_raw_refs": [],
       "status": "not_live_verified"
@@ -1795,13 +1803,21 @@
     {
       "name": "UpdateMethods.set_receive_updates",
       "kind": "async",
-      "source": "soroushthon/client/updates.py:54",
+      "source": "soroushthon/client/updates.py:74",
       "direct_raw_refs": [
         "updates.GetStateRequest"
       ],
       "missing_direct_raw_refs": [],
       "status": "not_live_verified"
     },
+    {
+      "name": "UpdateMethods.update_pipeline_stats",
+      "kind": "sync/property",
+      "source": "soroushthon/client/updates.py:47",
+      "direct_raw_refs": [],
+      "missing_direct_raw_refs": [],
+      "status": "not_live_verified"
+    },
     {
       "name": "UploadMethods.send_audio",
       "kind": "async",
@@ -1958,50 +1974,186 @@
     }
   ],
   "shortcuts": [
+    {
+      "name": "admin_log",
+      "alias_of": "ChatMethods.get_admin_log"
+    },
+    {
+      "name": "audio",
+      "alias_of": "UploadMethods.send_audio"
+    },
+    {
+      "name": "authorizations",
+      "alias_of": "AccountMethods.get_authorizations"
+    },
+    {
+      "name": "authorized",
+      "alias_of": "UserMethods.is_user_authorized"
+    },
+    {
+      "name": "auto_download",
+      "alias_of": "AccountMethods.get_auto_download_settings"
+    },
     {
       "name": "bio",
       "alias_of": "UserMethods.get_user_bio"
     },
+    {
+      "name": "block",
+      "alias_of": "ContactMethods.block_user"
+    },
+    {
+      "name": "blocked",
+      "alias_of": "ContactMethods.get_blocked"
+    },
     {
       "name": "call_info",
       "alias_of": "InteractionMethods.get_group_call"
     },
+    {
+      "name": "call_members",
+      "alias_of": "InteractionMethods.get_group_call_participants"
+    },
+    {
+      "name": "chat_info",
+      "alias_of": "ChatMethods.get_chat_info"
+    },
+    {
+      "name": "common_chats",
+      "alias_of": "MessageMethods.get_common_chats"
+    },
     {
       "name": "contact",
       "alias_of": "InteractionMethods.send_contact"
     },
+    {
+      "name": "contacts",
+      "alias_of": "ContactMethods.get_contacts"
+    },
     {
       "name": "delete",
       "alias_of": "MessageMethods.delete_messages"
     },
+    {
+      "name": "dialog",
+      "alias_of": "DialogMethods.get_peer_dialog"
+    },
+    {
+      "name": "dialog_filters",
+      "alias_of": "DialogMethods.get_dialog_filters"
+    },
     {
       "name": "dialogs",
       "alias_of": "DialogMethods.get_dialogs"
     },
+    {
+      "name": "document",
+      "alias_of": "UploadMethods.send_document"
+    },
     {
       "name": "download",
       "alias_of": "DownloadMethods.download_media"
     },
+    {
+      "name": "drafts",
+      "alias_of": "DialogMethods.get_drafts"
+    },
     {
       "name": "edit",
       "alias_of": "MessageMethods.edit_message"
     },
+    {
+      "name": "end_call",
+      "alias_of": "InteractionMethods.end_group_call"
+    },
+    {
+      "name": "entity",
+      "alias_of": "UserMethods.get_entity"
+    },
     {
       "name": "file",
       "alias_of": "UploadMethods.send_file"
     },
+    {
+      "name": "find_contacts",
+      "alias_of": "ContactMethods.search_contacts"
+    },
+    {
+      "name": "find_members",
+      "alias_of": "ChatMethods.search_chat_members"
+    },
     {
       "name": "forward",
       "alias_of": "MessageMethods.forward_messages"
     },
+    {
+      "name": "full_user",
+      "alias_of": "UserMethods.get_full_user"
+    },
+    {
+      "name": "history",
+      "alias_of": "MessageMethods.iter_messages"
+    },
+    {
+      "name": "history_page",
+      "alias_of": "MessageMethods.get_chat_history_page"
+    },
+    {
+      "name": "input_entity",
+      "alias_of": "UserMethods.get_input_entity"
+    },
+    {
+      "name": "invite",
+      "alias_of": "ChatMethods.invite_chat_members"
+    },
+    {
+      "name": "invite_links",
+      "alias_of": "ChatMethods.get_invite_links"
+    },
+    {
+      "name": "is_member",
+      "alias_of": "ChatMethods.is_chat_member"
+    },
+    {
+      "name": "iter_chats",
+      "alias_of": "DialogMethods.iter_dialogs"
+    },
+    {
+      "name": "iter_members",
+      "alias_of": "ChatMethods.iter_participants"
+    },
+    {
+      "name": "join_invite",
+      "alias_of": "ChatMethods.join_by_invite"
+    },
+    {
+      "name": "join_public",
+      "alias_of": "ChatMethods.join_public_chat"
+    },
+    {
+      "name": "kick",
+      "alias_of": "ChatMethods.kick_participant"
+    },
+    {
+      "name": "leave_call",
+      "alias_of": "InteractionMethods.leave_group_call"
+    },
     {
       "name": "location",
       "alias_of": "InteractionMethods.send_location"
     },
+    {
+      "name": "mark_read",
+      "alias_of": "MessageMethods.send_read_acknowledge"
+    },
     {
       "name": "me",
       "alias_of": "UserMethods.get_me"
     },
+    {
+      "name": "media_page",
+      "alias_of": "MessageMethods.get_chat_media_page"
+    },
     {
       "name": "meet",
       "alias_of": "InteractionMethods.create_meet"
@@ -2014,10 +2166,66 @@
       "name": "meet_links",
       "alias_of": "InteractionMethods.get_chat_meet_links"
     },
+    {
+      "name": "member_status",
+      "alias_of": "ChatMethods.get_chat_member_status"
+    },
+    {
+      "name": "members",
+      "alias_of": "ChatMethods.get_participants"
+    },
+    {
+      "name": "mentions_page",
+      "alias_of": "MessageMethods.get_chat_mentions_page"
+    },
     {
       "name": "messages",
       "alias_of": "MessageMethods.get_messages"
     },
+    {
+      "name": "new_channel",
+      "alias_of": "ChatMethods.create_channel"
+    },
+    {
+      "name": "new_conference",
+      "alias_of": "InteractionMethods.create_conference"
+    },
+    {
+      "name": "new_group",
+      "alias_of": "ChatMethods.create_group"
+    },
+    {
+      "name": "notifications",
+      "alias_of": "AccountMethods.get_chat_notifications"
+    },
+    {
+      "name": "online_count",
+      "alias_of": "ChatMethods.get_group_online_count"
+    },
+    {
+      "name": "peer_id",
+      "alias_of": "UserMethods.get_peer_id"
+    },
+    {
+      "name": "peer_settings",
+      "alias_of": "AccountMethods.get_peer_settings"
+    },
+    {
+      "name": "permissions",
+      "alias_of": "ChatMethods.get_permissions"
+    },
+    {
+      "name": "photo",
+      "alias_of": "UploadMethods.send_photo"
+    },
+    {
+      "name": "pin",
+      "alias_of": "MessageMethods.pin_message"
+    },
+    {
+      "name": "pinned_dialogs",
+      "alias_of": "DialogMethods.get_pinned_dialogs"
+    },
     {
       "name": "poll",
       "alias_of": "InteractionMethods.send_poll"
@@ -2030,6 +2238,18 @@
       "name": "poll_voters",
       "alias_of": "InteractionMethods.get_poll_votes"
     },
+    {
+      "name": "post_views",
+      "alias_of": "ChatMethods.get_channel_post_views"
+    },
+    {
+      "name": "primary_invite",
+      "alias_of": "ChatMethods.get_chat_primary_invite_link"
+    },
+    {
+      "name": "privacy",
+      "alias_of": "AccountMethods.get_global_privacy_settings"
+    },
     {
       "name": "react",
       "alias_of": "InteractionMethods.send_reaction"
@@ -2042,25 +2262,109 @@
       "name": "reactions",
       "alias_of": "InteractionMethods.get_message_reactions"
     },
+    {
+      "name": "readers",
+      "alias_of": "MessageMethods.get_message_read_participants"
+    },
+    {
+      "name": "replies",
+      "alias_of": "MessageMethods.get_chat_replies"
+    },
+    {
+      "name": "scheduled",
+      "alias_of": "MessageMethods.get_scheduled_messages"
+    },
+    {
+      "name": "search_all",
+      "alias_of": "MessageMethods.search_all_messages"
+    },
+    {
+      "name": "search_chat",
+      "alias_of": "MessageMethods.search_chat_messages"
+    },
     {
       "name": "send",
       "alias_of": "MessageMethods.send_message"
     },
+    {
+      "name": "send_as_peers",
+      "alias_of": "ChatMethods.get_send_as_peers"
+    },
+    {
+      "name": "send_scheduled",
+      "alias_of": "MessageMethods.send_scheduled_messages_now"
+    },
+    {
+      "name": "set_auto_download",
+      "alias_of": "AccountMethods.save_auto_download_settings"
+    },
+    {
+      "name": "set_description",
+      "alias_of": "ChatMethods.set_chat_description"
+    },
+    {
+      "name": "set_notifications",
+      "alias_of": "AccountMethods.update_chat_notifications"
+    },
+    {
+      "name": "set_privacy",
+      "alias_of": "AccountMethods.set_global_privacy_settings"
+    },
+    {
+      "name": "set_reactions",
+      "alias_of": "ChatMethods.set_chat_reactions"
+    },
+    {
+      "name": "set_title",
+      "alias_of": "ChatMethods.set_chat_title"
+    },
+    {
+      "name": "set_username",
+      "alias_of": "AccountMethods.update_username"
+    },
     {
       "name": "start_call",
       "alias_of": "InteractionMethods.start_group_call"
     },
+    {
+      "name": "unblock",
+      "alias_of": "ContactMethods.unblock_user"
+    },
+    {
+      "name": "unpin",
+      "alias_of": "MessageMethods.unpin_message"
+    },
     {
       "name": "unreact",
       "alias_of": "InteractionMethods.remove_reaction"
     },
+    {
+      "name": "unread_mentions",
+      "alias_of": "MessageMethods.get_unread_mentions"
+    },
+    {
+      "name": "unread_reactions",
+      "alias_of": "MessageMethods.get_unread_reactions"
+    },
     {
       "name": "upload",
       "alias_of": "UploadMethods.upload_file"
     },
+    {
+      "name": "video",
+      "alias_of": "UploadMethods.send_video"
+    },
+    {
+      "name": "voice",
+      "alias_of": "UploadMethods.send_voice"
+    },
     {
       "name": "vote",
       "alias_of": "InteractionMethods.vote_poll"
+    },
+    {
+      "name": "web_preview",
+      "alias_of": "MessageMethods.get_web_page_preview"
     }
   ],
   "raw_functions": [

{soroushthon-0.2.93.dev0 → soroushthon-0.2.95}/CAPABILITIES.md

@@ -4,7 +4,7 @@
 پشتیبانی سرور سروش یا نتیجهٔ آزمون زنده را ثابت نمی‌کند. فایل
 `CAPABILITIES.json` نام و امضای تمام درخواست‌های خام را نیز نگه می‌دارد.
 
-متدهای عمومی mixinهای کلاینت: **203**؛ نام‌های کوتاه همان متدها: **26**؛
+متدهای عمومی mixinهای کلاینت: **205**؛ نام‌های کوتاه همان متدها: **98**؛
 درخواست‌های خام TL: **368**؛ انواع TL: **1271**.
 نام کوتاه توانایی جداگانه یا درخواست تازه به سرور اضافه نمی‌کند.
 این شمارش سه ثبت‌کنندهٔ رویداد `SoroushClient.on_message/on_edited/on_raw` و
@@ -14,32 +14,104 @@
 
 | نام کوتاه | همان متد اصلی |
 | --- | --- |
+| `admin_log` | `ChatMethods.get_admin_log` |
+| `audio` | `UploadMethods.send_audio` |
+| `authorizations` | `AccountMethods.get_authorizations` |
+| `authorized` | `UserMethods.is_user_authorized` |
+| `auto_download` | `AccountMethods.get_auto_download_settings` |
 | `bio` | `UserMethods.get_user_bio` |
+| `block` | `ContactMethods.block_user` |
+| `blocked` | `ContactMethods.get_blocked` |
 | `call_info` | `InteractionMethods.get_group_call` |
+| `call_members` | `InteractionMethods.get_group_call_participants` |
+| `chat_info` | `ChatMethods.get_chat_info` |
+| `common_chats` | `MessageMethods.get_common_chats` |
 | `contact` | `InteractionMethods.send_contact` |
+| `contacts` | `ContactMethods.get_contacts` |
 | `delete` | `MessageMethods.delete_messages` |
+| `dialog` | `DialogMethods.get_peer_dialog` |
+| `dialog_filters` | `DialogMethods.get_dialog_filters` |
 | `dialogs` | `DialogMethods.get_dialogs` |
+| `document` | `UploadMethods.send_document` |
 | `download` | `DownloadMethods.download_media` |
+| `drafts` | `DialogMethods.get_drafts` |
 | `edit` | `MessageMethods.edit_message` |
+| `end_call` | `InteractionMethods.end_group_call` |
+| `entity` | `UserMethods.get_entity` |
 | `file` | `UploadMethods.send_file` |
+| `find_contacts` | `ContactMethods.search_contacts` |
+| `find_members` | `ChatMethods.search_chat_members` |
 | `forward` | `MessageMethods.forward_messages` |
+| `full_user` | `UserMethods.get_full_user` |
+| `history` | `MessageMethods.iter_messages` |
+| `history_page` | `MessageMethods.get_chat_history_page` |
+| `input_entity` | `UserMethods.get_input_entity` |
+| `invite` | `ChatMethods.invite_chat_members` |
+| `invite_links` | `ChatMethods.get_invite_links` |
+| `is_member` | `ChatMethods.is_chat_member` |
+| `iter_chats` | `DialogMethods.iter_dialogs` |
+| `iter_members` | `ChatMethods.iter_participants` |
+| `join_invite` | `ChatMethods.join_by_invite` |
+| `join_public` | `ChatMethods.join_public_chat` |
+| `kick` | `ChatMethods.kick_participant` |
+| `leave_call` | `InteractionMethods.leave_group_call` |
 | `location` | `InteractionMethods.send_location` |
+| `mark_read` | `MessageMethods.send_read_acknowledge` |
 | `me` | `UserMethods.get_me` |
+| `media_page` | `MessageMethods.get_chat_media_page` |
 | `meet` | `InteractionMethods.create_meet` |
 | `meet_in` | `InteractionMethods.share_meet` |
 | `meet_links` | `InteractionMethods.get_chat_meet_links` |
+| `member_status` | `ChatMethods.get_chat_member_status` |
+| `members` | `ChatMethods.get_participants` |
+| `mentions_page` | `MessageMethods.get_chat_mentions_page` |
 | `messages` | `MessageMethods.get_messages` |
+| `new_channel` | `ChatMethods.create_channel` |
+| `new_conference` | `InteractionMethods.create_conference` |
+| `new_group` | `ChatMethods.create_group` |
+| `notifications` | `AccountMethods.get_chat_notifications` |
+| `online_count` | `ChatMethods.get_group_online_count` |
+| `peer_id` | `UserMethods.get_peer_id` |
+| `peer_settings` | `AccountMethods.get_peer_settings` |
+| `permissions` | `ChatMethods.get_permissions` |
+| `photo` | `UploadMethods.send_photo` |
+| `pin` | `MessageMethods.pin_message` |
+| `pinned_dialogs` | `DialogMethods.get_pinned_dialogs` |
 | `poll` | `InteractionMethods.send_poll` |
 | `poll_results` | `InteractionMethods.get_poll_results` |
 | `poll_voters` | `InteractionMethods.get_poll_votes` |
+| `post_views` | `ChatMethods.get_channel_post_views` |
+| `primary_invite` | `ChatMethods.get_chat_primary_invite_link` |
+| `privacy` | `AccountMethods.get_global_privacy_settings` |
 | `react` | `InteractionMethods.send_reaction` |
 | `reaction_users` | `InteractionMethods.get_reaction_users` |
 | `reactions` | `InteractionMethods.get_message_reactions` |
+| `readers` | `MessageMethods.get_message_read_participants` |
+| `replies` | `MessageMethods.get_chat_replies` |
+| `scheduled` | `MessageMethods.get_scheduled_messages` |
+| `search_all` | `MessageMethods.search_all_messages` |
+| `search_chat` | `MessageMethods.search_chat_messages` |
 | `send` | `MessageMethods.send_message` |
+| `send_as_peers` | `ChatMethods.get_send_as_peers` |
+| `send_scheduled` | `MessageMethods.send_scheduled_messages_now` |
+| `set_auto_download` | `AccountMethods.save_auto_download_settings` |
+| `set_description` | `ChatMethods.set_chat_description` |
+| `set_notifications` | `AccountMethods.update_chat_notifications` |
+| `set_privacy` | `AccountMethods.set_global_privacy_settings` |
+| `set_reactions` | `ChatMethods.set_chat_reactions` |
+| `set_title` | `ChatMethods.set_chat_title` |
+| `set_username` | `AccountMethods.update_username` |
 | `start_call` | `InteractionMethods.start_group_call` |
+| `unblock` | `ContactMethods.unblock_user` |
+| `unpin` | `MessageMethods.unpin_message` |
 | `unreact` | `InteractionMethods.remove_reaction` |
+| `unread_mentions` | `MessageMethods.get_unread_mentions` |
+| `unread_reactions` | `MessageMethods.get_unread_reactions` |
 | `upload` | `UploadMethods.upload_file` |
+| `video` | `UploadMethods.send_video` |
+| `voice` | `UploadMethods.send_voice` |
 | `vote` | `InteractionMethods.vote_poll` |
+| `web_preview` | `MessageMethods.get_web_page_preview` |
 
 ## درخواست‌های خام بر حسب حوزه
 
@@ -252,6 +324,7 @@
 | `MessageMethods.send_scheduled_messages_now` | — |
 | `MessageMethods.unpin_message` | — |
 | `MessageParseMethods.parse_mode` | — |
+| `UpdateMethods.adaptive_update_stats` | — |
 | `UpdateMethods.add_event_handler` | — |
 | `UpdateMethods.catch_up` | — |
 | `UpdateMethods.list_event_handlers` | — |
@@ -259,6 +332,7 @@
 | `UpdateMethods.remove_event_handler` | — |
 | `UpdateMethods.run_until_disconnected` | — |
 | `UpdateMethods.set_receive_updates` | — |
+| `UpdateMethods.update_pipeline_stats` | — |
 | `UploadMethods.send_audio` | — |
 | `UploadMethods.send_document` | — |
 | `UploadMethods.send_file` | — |

{soroushthon-0.2.93.dev0 → soroushthon-0.2.95}/MANIFEST.in

@@ -3,6 +3,9 @@ include .gitignore
 include PROTOCOL.md AUDIT.md PARITY.md
 include CAPABILITIES.md CAPABILITIES.json
 include MEDIA.md
+include ADAPTIVE_UPDATES.md
+include SHORTCUTS.md
+include PERFORMANCE_095.md
 include INTERACTIONS.md RUBIKA_REVIEW.md
 include FRAMEWORK.md ECOSYSTEM_REVIEW.md
 include CONFERENCE.md CALL_RESEARCH.md FULL_COVERAGE.md

soroushthon-0.2.95/PERFORMANCE_095.md

@@ -0,0 +1,14 @@
+# پایش سرعت پردازش رویدادها
+
+در `0.2.95` بسته‌های رویداد بدون کاربر یا گفتگوی تازه دیگر در صف ذخیرهٔ موجودیت‌ها نگه داشته نمی‌شوند. هنگام قطع اتصال نیز موجودیت‌های معوق قبل از بستن نشست ذخیره می‌شوند. برای فهمیدن گلوگاه واقعی در حساب‌های شلوغ، یک نمای آماری محلی به کلاینت اضافه شده است؛ خواندن آن درخواست شبکه ارسال نمی‌کند.
+
+```python
+print(client.update_pipeline_stats())
+print(client.adaptive_update_stats())
+```
+
+خروجی اول چهار مقدار دارد: `socket_queue` تعداد بسته‌های منتظر پردازش، `running_handlers` شمار وظیفه‌های فعال هندلرها، `deferred_entity_batches` تعداد بسته‌های دارای موجودیت منتظر ذخیره و `tracked_channels` تعداد گفتگوهای کانال‌پایه در وضعیت به‌روزرسانی کلاینت. این اعداد **تصویر همان لحظه** هستند؛ از یک عدد تنها نمی‌شود عملکرد کل سیستم را نتیجه گرفت.
+
+برای مقایسهٔ عملی، هنگام ترافیک معمول حساب هر ۱۰ ثانیه چند نمونه بگیر. اگر `socket_queue` پیوسته زیاد می‌شود، مسیر دریافت و پردازش رویداد عقب افتاده است. اگر هم‌زمان `running_handlers` رشد می‌کند، زمان اجرای هندلرهای برنامه را بررسی کن. اگر صف‌ها کوچک هستند ولی `lag_p95_seconds` در آمار بازیابی انتخابی بالاست، تأخیر می‌تواند پیش از رسیدن رویداد به دستگاه رخ داده باشد. ساعت دستگاه را هم با زمان شبکه هماهنگ نگه دار.
+
+پس از دیدن اندازه‌گیریِ حساب واقعی، می‌شود سراغ کنترل تعداد وظیفه‌های هم‌زمان، ذخیرهٔ کمترِ وضعیت‌های بدون تغییر در SQLite، یا تنظیم فاصلهٔ بازیابی انتخابی رفت. هیچ‌کدام را بدون سنجش و محافظت از ترتیب/عدم گم‌شدن پیام‌ها به‌عنوان افزایش قطعی سرعت در نظر نگیر.