spluspy 2.2.8__tar.gz → 2.2.10__tar.gz

{spluspy-2.2.8/spluspy.egg-info → spluspy-2.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spluspy
-Version: 2.2.8
+Version: 2.2.10
 Summary: High-performance Python Self-Bot Framework for Soroush Plus
 Author: Ali Mirshekari
 License: MIT
@@ -26,7 +26,7 @@ Requires-Dist: rsa
 Requires-Dist: pyaes
 Dynamic: license-file
 
-# SplusPy v2.2.8
+# SplusPy v2.2.10
 
 
 **A fast, minimal, and fully-featured self-bot framework**
@@ -37,7 +37,7 @@ Dynamic: license-file
 
 SplusPy is a Python library designed specifically for building **Soroush Plus self-bots** (userbots). It provides a clean, intuitive API for automating your personal Soroush Plus account with ease.
 
-> ⚠️ **Note:** This is a **self-bot framework** — it operates on your personal account, not a bot account. Please adhere to Telegram's Terms of Service.
+> ⚠️ **Note:** This is a **self-bot framework** — it operates on your personal account, not a bot account. Please adhere to Soroush's Terms of Service.
 
 ---
 

{spluspy-2.2.8 → spluspy-2.2.10}/README.md

@@ -1,4 +1,4 @@
-# SplusPy v2.2.8
+# SplusPy v2.2.10
 
 
 **A fast, minimal, and fully-featured self-bot framework**
@@ -9,7 +9,7 @@
 
 SplusPy is a Python library designed specifically for building **Soroush Plus self-bots** (userbots). It provides a clean, intuitive API for automating your personal Soroush Plus account with ease.
 
-> ⚠️ **Note:** This is a **self-bot framework** — it operates on your personal account, not a bot account. Please adhere to Telegram's Terms of Service.
+> ⚠️ **Note:** This is a **self-bot framework** — it operates on your personal account, not a bot account. Please adhere to Soroush's Terms of Service.
 
 ---
 

{spluspy-2.2.8 → spluspy-2.2.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "spluspy"
-version = "2.2.8"
+version = "2.2.10"
 description = "High-performance Python Self-Bot Framework for Soroush Plus"
 readme = "README.md"
 license = {text = "MIT"}

{spluspy-2.2.8 → spluspy-2.2.10}/spluspy/client/extra.py

@@ -1,3 +1,4 @@
+import asyncio
 import typing
 from ..tl import functions, types
 from .. import helpers, utils, hints, errors
@@ -834,3 +835,147 @@ class ExtraMethods:
         return result
 
     # endregion
+
+    # =====================================================================
+    # region Bulk Account Maintenance Methods
+    # =====================================================================
+
+    async def get_all_groups(
+        self: 'SoroushClient'
+    ) -> typing.List[dict]:
+        """
+        Lists every group/channel the account is a member of.
+
+        Returns:
+            A list of dicts with keys:
+                - ``id``: marked chat ID (int)
+                - ``title``: display title (str)
+                - ``type``: ``'channel'`` or ``'group'``
+                - ``username``: public username or None
+        """
+        groups = []
+        async for dialog in self.iter_dialogs():
+            entity = getattr(dialog, 'entity', None)
+            if entity is None or isinstance(entity, types.User):
+                continue
+            if isinstance(entity, types.Channel) and not entity.megagroup:
+                kind = 'channel'
+            else:
+                kind = 'group'
+            groups.append({
+                'id': dialog.id,
+                'title': dialog.name,
+                'type': kind,
+                'username': getattr(entity, 'username', None),
+            })
+        return groups
+
+    async def leave_all(self, delay: float = 0.5) -> dict:
+        """
+        Leaves every group/channel; private chats are skipped.
+
+        Args:
+            delay: Pause in seconds between leave requests (flood control).
+
+        Returns:
+            A dict with counts and per-chat details:
+            ``{'success', 'failed', 'skipped',
+               'details': [{'id', 'title', 'status'}]}``
+            where status is ``'left'``, ``'failed'`` or ``'skipped'``.
+        """
+        success = failed = skipped = 0
+        details = []
+        async for dialog in self.iter_dialogs():
+            entity = getattr(dialog, 'entity', None)
+            if entity is None or isinstance(entity, types.User):
+                skipped += 1
+                details.append({
+                    'id': dialog.id,
+                    'title': dialog.name,
+                    'status': 'skipped'
+                })
+                continue
+            try:
+                await self.leave_chat(dialog.input_entity)
+                status = 'left'
+                success += 1
+            except Exception:
+                status = 'failed'
+                failed += 1
+            details.append({
+                'id': dialog.id,
+                'title': dialog.name,
+                'status': status
+            })
+            await asyncio.sleep(delay)
+        return {
+            'success': success,
+            'failed': failed,
+            'skipped': skipped,
+            'details': details
+        }
+
+    async def delete_all_private(
+        self: 'SoroushClient',
+        revoke: bool = True,
+        delay: float = 1.0,
+        on_progress: typing.Callable[[int, int, str], typing.Any] = None
+    ) -> dict:
+        """
+        Deletes the history of all private chats (optionally revoking them).
+
+        Args:
+            revoke: Also delete the messages for the other side.
+            delay: Pause in seconds between requests (flood control).
+            on_progress: Optional callback ``(current, total, name)``;
+                may be sync or async.
+
+        Returns:
+            A dict with counts and per-chat details:
+            ``{'success', 'failed', 'skipped',
+               'details': [{'id', 'title', 'status'}]}``
+            where status is ``'deleted'``, ``'failed'`` or ``'skipped'``.
+        """
+        dialogs = []
+        async for dialog in self.iter_dialogs():
+            if isinstance(getattr(dialog, 'entity', None), types.User):
+                if getattr(dialog.entity, 'is_self', False):
+                    continue
+                dialogs.append(dialog)
+
+        total = len(dialogs)
+        success = failed = skipped = 0
+        details = []
+
+        for current, dialog in enumerate(dialogs, start=1):
+            title = dialog.name or ''
+            try:
+                await self(functions.messages.DeleteHistoryRequest(
+                    peer=dialog.input_entity,
+                    max_id=0,
+                    revoke=revoke
+                ))
+                status = 'deleted'
+                success += 1
+            except Exception:
+                status = 'failed'
+                failed += 1
+            details.append({
+                'id': dialog.id,
+                'title': title,
+                'status': status
+            })
+            if on_progress:
+                result = on_progress(current, total, title)
+                if asyncio.iscoroutine(result):
+                    await result
+            await asyncio.sleep(delay)
+
+        return {
+            'success': success,
+            'failed': failed,
+            'skipped': skipped,
+            'details': details
+        }
+
+    # endregion