Add terminate_session

and the corresponding bound methods

Author: SpEcHiDe

compiler/docs/compiler.py

@@ -164,6 +164,7 @@ def get_title_list(s: str) -> list:
             terminate
             get_me
             get_active_sessions
+            terminate_session
         """,
         messages="""
         Messages
@@ -778,6 +779,10 @@ def get_title_list(s: str) -> list:
             Story.react
             Story.download
         """,
+        active_session="""
+        ActiveSession
+            ActiveSession.terminate
+        """,
     )
 
     root = PYROGRAM_API_DEST + "/bound-methods"

compiler/docs/template/bound-methods.rst

@@ -139,3 +139,16 @@ Story
     :hidden:
 
     {story_toctree}
+
+ActiveSession
+-------------
+
+.. hlist::
+    :columns: 2
+
+    {active_session_hlist}
+
+.. toctree::
+    :hidden:
+
+    {active_session_toctree}

docs/source/releases/changes-in-this-fork.rst

@@ -25,7 +25,7 @@ If you found any issue or have any suggestions, feel free to make `an issue <htt
 +------------------------+
 
 - Updated :obj:`~pyrogram.filters.via_bot`, to optionally support filtering invalid bot ``user_id``.
-- Added the :meth:`~pyrogram.Client.get_active_sessions`.
+- Added the :meth:`~pyrogram.Client.get_active_sessions`, :meth:`~pyrogram.Client.terminate_session`, :meth:`~pyrogram.types.ActiveSession.terminate`.
 - Added the ``is_automatic_forward`` to the :obj:`~pyrogram.types.Message`.
 - Added the parameters ``offset_id`` to the :meth:`~pyrogram.Client.search_messages` and the parameters ``min_date``, ``max_date``, ``min_id``, ``max_id``, ``saved_messages_topic_id`` to the :meth:`~pyrogram.Client.search_messages_count`.
 - Dynamic session ReStart + restart optimizations (`#56 <https://github.com/TelegramPlayGround/pyrogram/pull/56>`__)

pyrogram/methods/auth/__init__.py

@@ -32,6 +32,7 @@
 from .sign_in_bot import SignInBot
 from .sign_up import SignUp
 from .terminate import Terminate
+from .terminate_session import TerminateSession
 
 
 class Auth(
@@ -50,6 +51,7 @@ class Auth(
     SignIn,
     SignInBot,
     SignUp,
-    Terminate
+    Terminate,
+    TerminateSession,
 ):
     pass

pyrogram/methods/auth/terminate_session.py

@@ -0,0 +1,45 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+import pyrogram
+from pyrogram import raw
+
+
+class TerminateSession:
+    async def terminate_session(
+        self: "pyrogram.Client",
+        session_id: int
+    ) -> bool:
+        """Terminates a session of the current user.
+
+        .. include:: /_includes/usable-by/users.rst
+
+        Parameters:
+            session_id (``int``):
+                Session identifier.
+
+        Returns:
+            ``bool``: On success, in case the session is destroyed, True is returned. Otherwise, False is returned.
+
+        Raises:
+            RPCError: In case of a Telegram RPC error.
+
+        """
+        return await self.invoke(
+            raw.functions.account.ResetAuthorization(hash=session_id)
+        )

pyrogram/types/authorization/active_session.py

@@ -148,3 +148,28 @@ def _parse(session: "raw.types.Authorization") -> "ActiveSession":
             can_accept_calls=not getattr(session, "call_requests_disabled", False),
             is_official_application=getattr(session, "official_app", None)
         )
+
+    async def terminate(self):
+        """Bound method *reset* of :obj:`~pyrogram.types.ActiveSession`.
+
+        Use as a shortcut for:
+
+        .. code-block:: python
+
+            await client.terminate_session(123456789)
+
+        Example:
+
+        .. code-block:: python
+
+            await session.reset()
+
+        Returns:
+            True on success.
+
+        Raises:
+            RPCError: In case of a Telegram RPC error.
+
+        """
+
+        return await self._client.terminate_session(self.id)