hypergram 1.0.3__tar.gz → 1.0.4__tar.gz

{hypergram-1.0.3 → hypergram-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypergram
-Version: 1.0.3
+Version: 1.0.4
 Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
 Project-URL: Homepage, https://hypergram.icu
 Project-URL: Documentation, https://docs.hypergram.icu

{hypergram-1.0.3 → hypergram-1.0.4}/hypergram/__init__.py

@@ -16,7 +16,7 @@
 #  You should have received a copy of the GNU Lesser General Public License
 #  along with hypergram.  If not, see <http://www.gnu.org/licenses/>.
 
-__version__ = "1.0.3"
+__version__ = "1.0.4"
 __license__ = "GNU Lesser General Public License v3.0 (LGPL-3.0)"
 __copyright__ = "Copyright (C) 2017-present Dan <https://github.com/delivrance>"
 

{hypergram-1.0.3 → hypergram-1.0.4}/hypergram/client.py

@@ -322,6 +322,18 @@ class Client(Methods):
     ):
         super().__init__()
 
+        # 🚀 حقن المحرك عالي الأداء قبل ما الكلاينت يسحب الـ Loop الافتراضي
+        if loop is None:
+            try:
+                import uvloop
+                asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())
+            except ImportError:
+                try:
+                    import winloop
+                    asyncio.set_event_loop_policy(winloop.EventLoopPolicy())
+                except ImportError:
+                    pass
+
         self.name = name
         self.api_id = int(api_id) if api_id else None
         self.api_hash = api_hash
@@ -428,10 +440,11 @@ class Client(Methods):
         self.__config: "raw.types.Config" = None
 
     @property
-    def loop(self) -> asyncio.AbstractEventLoop:
-        if not self._loop:
-            self._loop = utils.get_event_loop()
-        return self._loop
+    def loop(self):
+        try:
+            return asyncio.get_running_loop()
+        except RuntimeError:
+            return asyncio.get_event_loop()
 
     @loop.setter
     def loop(self, value: asyncio.AbstractEventLoop):

{hypergram-1.0.3 → hypergram-1.0.4}/hypergram/enums/chat_action.py

@@ -69,4 +69,4 @@ class ChatAction(AutoName):
     "Choosing sticker"
 
     CANCEL = raw.types.SendMessageCancelAction
-    "Cancel ongoing chat action"
+    "Cancel ongoing chat action"

{hypergram-1.0.3 → hypergram-1.0.4}/hypergram/methods/messages/copy_message.py

@@ -165,4 +165,4 @@ class CopyMessage:
             reply_to_message_id=reply_to_message_id,
             quote_text=quote_text,
             quote_entities=quote_entities,
-        )
+        )

{hypergram-1.0.3 → hypergram-1.0.4}/hypergram/methods/payments/place_gift_auction_bid.py

@@ -71,7 +71,7 @@ class PlaceGiftAuctionBid:
                 await app.place_gift_auction_bid(
                     gift_id=12345,
                     star_count=250,
-                    user_id="@KurimuzonAkuma",
+                    user_id="@hypergram",
                     text=types.FormattedText(
                         text="Here's a gift for you!"
                     )

{hypergram-1.0.3 → hypergram-1.0.4}/hypergram/methods/utilities/run.py

@@ -16,6 +16,7 @@
 #  You should have received a copy of the GNU Lesser General Public License
 #  along with hypergram.  If not, see <http://www.gnu.org/licenses/>.
 
+import asyncio
 import inspect
 from typing import List
 
@@ -58,6 +59,16 @@ class Run:
                 ...  # Set handlers up
                 app.run()
         """
+        try:
+            import uvloop
+            asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())
+        except ImportError:
+            try:
+                import winloop
+                asyncio.set_event_loop_policy(winloop.EventLoopPolicy())
+            except ImportError:
+                pass
+
         run = self.loop.run_until_complete
 
         if inspect.iscoroutinefunction(self.start):
@@ -67,4 +78,4 @@ class Run:
         else:
             self.start(use_qr=use_qr, except_ids=except_ids)
             run(idle())
-            self.stop()
+            self.stop()

{hypergram-1.0.3 → hypergram-1.0.4}/hypergram/session/__init__.py

@@ -17,4 +17,4 @@
 #  along with hypergram.  If not, see <http://www.gnu.org/licenses/>.
 
 from .auth import Auth
-from .session import Session
+from .session import Session

{hypergram-1.0.3 → hypergram-1.0.4}/hypergram/session/session.py

@@ -1,5 +1,5 @@
 #  hypergram - Telegram MTProto API Client Library for Python
-#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#  Copyright (C) 2026-present Saif <https://github.com/Shadowc89>
 #
 #  This file is part of hypergram.
 #
@@ -7,19 +7,12 @@
 #  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.
-#
-#  hypergram 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 hypergram.  If not, see <http://www.gnu.org/licenses/>.
 
 import asyncio
 import bisect
 import logging
 import os
+import sys
 from enum import Enum, auto
 from hashlib import sha1
 from io import BytesIO
@@ -47,7 +40,6 @@ from .internals import MsgFactory
 
 log = logging.getLogger(__name__)
 
-
 class SessionState(Enum):
     STARTING = auto()
     STARTED = auto()
@@ -160,6 +152,9 @@ class Session:
 
         await self._set_state(SessionState.STARTING)
 
+        current_loop = asyncio.get_running_loop()
+        log.info("Using Event Loop: %s", current_loop.__class__.__name__)
+
         self.connection = self.client.connection_factory(
             dc_id=self.dc_id,
             server_address=self.server_address,
@@ -240,11 +235,8 @@ class Session:
         await self._set_state(SessionState.STOPPING)
 
         self.ignore_count = 0
-
         self.is_started.clear()
-
         self.stored_msg_ids.clear()
-
         self.ping_task_event.set()
 
         if self.ping_task is not None:
@@ -252,7 +244,8 @@ class Session:
 
         self.ping_task_event.clear()
 
-        await self.connection.close()
+        if self.connection:
+            await self.connection.close()
 
         if self.recv_task:
             await self.recv_task
@@ -271,7 +264,7 @@ class Session:
     async def restart(self):
         async with self.restart_lock:
             if self.stored_msg_ids:
-               self.recent_msg_ids = self.stored_msg_ids[:30]
+                self.recent_msg_ids = self.stored_msg_ids[:30].copy()
 
             await self.stop()
             await self.start()
@@ -315,10 +308,10 @@ class Session:
                     del self.stored_msg_ids[:Session.STORED_MSG_IDS_MAX_SIZE // 2]
 
                 if msg.msg_id in self.recent_msg_ids:
-                   self.recent_msg_ids.remove(msg.msg_id)
-                   raise SecurityCheckMismatch(
-                         "The msg_id is belong to most recent closed connection."
-                   )
+                    self.recent_msg_ids.remove(msg.msg_id)
+                    raise SecurityCheckMismatch(
+                        "The msg_id belongs to the most recent closed connection."
+                    )
 
                 if self.stored_msg_ids:
                     if msg.msg_id < self.stored_msg_ids[0]:
@@ -331,30 +324,26 @@ class Session:
                             "The msg_id is equal to any of the stored values"
                         )
 
-                    time_diff = (msg.msg_id - (await self.msg_factory.allocate_message_identity())) / 2 ** 32
+                time_diff = (msg.msg_id - (await self.msg_factory.allocate_message_identity())) / 2 ** 32
 
-                    if time_diff > 30:
-                        raise SecurityCheckMismatch(
-                            "The msg_id belongs to over 30 seconds in the future. "
-                            "Most likely the client time has to be synchronized."
-                        )
+                if time_diff > 30:
+                    raise SecurityCheckMismatch(
+                        "The msg_id belongs to over 30 seconds in the future. Client time sync needed."
+                    )
 
-                    if time_diff < -300:
-                        raise SecurityCheckMismatch(
-                            "The msg_id belongs to over 300 seconds in the past. "
-                            "Most likely the client time has to be synchronized."
-                        )
+                if time_diff < -300:
+                    raise SecurityCheckMismatch(
+                        "The msg_id belongs to over 300 seconds in the past. Client time sync needed."
+                    )
 
-                    self.ignore_count = 0
+                self.ignore_count = 0
             except SecurityCheckMismatch as e:
                 log.info("Discarding packet: %s", e)
-
                 self.ignore_count += 1
 
                 if self.ignore_count >= self.MAX_CONSECUTIVE_IGNORED:
-                    log.info("Restarting session due to - %s - %s", e.__class__.__name__, e)
+                    log.info("Restarting session due to excessive ignored packets - %s - %s", e.__class__.__name__, e)
                     self.client.loop.create_task(self.restart())
-
                 return
             else:
                 bisect.insort(self.stored_msg_ids, msg.msg_id)
@@ -384,7 +373,6 @@ class Session:
 
         if len(self.pending_acks) >= self.ACKS_THRESHOLD:
             log.debug("Sending %s acks", len(self.pending_acks))
-
             try:
                 await self.send(raw.types.MsgsAck(msg_ids=list(self.pending_acks)), False)
             except OSError:
@@ -394,7 +382,6 @@ class Session:
 
     async def ping_worker(self):
         log.info("PingTask started")
-
         while True:
             try:
                 await asyncio.wait_for(self.ping_task_event.wait(), self.PING_INTERVAL)
@@ -412,7 +399,7 @@ class Session:
                     wait_response=False
                 )
             except OSError as e:
-                log.info("Restarting session due to - %s - %s", e.__class__.__name__, e)
+                log.info("Restarting session due to ping failure - %s - %s", e.__class__.__name__, e)
                 self.client.loop.create_task(self.restart())
                 break
             except RPCError:
@@ -422,49 +409,36 @@ class Session:
 
     async def recv_worker(self):
         log.info("NetworkTask started")
-
         while True:
             packet = await self.connection.recv()
 
             if packet is None or len(packet) == 4:
-                if packet:
-                    error_code = -Int.read(BytesIO(packet))
-                    error_msg = "unknown error"
-
-                    if error_code == 404:
-                        raise AuthKeyNotFound(
-                            "Auth key not found in the system. Try again or delete your session file "
-                            "and log in again with your phone number or bot token."
-                        )
+                error_code = -Int.read(BytesIO(packet)) if packet else 0
+                error_msg = "unknown error"
 
-                    try:
-                        if error_code == 429:
-                            raise TransportFlood(
-                                "Transport flood. Please slow down your requests."
-                            )
-                        elif error_code == 444:
-                            raise InvalidDC(
-                                "Invalid data center. Please check your configuration."
-                            )
-                    except TransportError as e:
-                        error_msg = str(e)
+                if error_code == 404:
+                    raise AuthKeyNotFound(
+                        "Auth key not found in the system. Try again or delete your session file "
+                        "and log in again with your phone number or bot token."
+                    )
 
-                    log.warning("Server sent transport error: %s (%s)", error_code, error_msg)
+                try:
+                    if error_code == 429:
+                        raise TransportFlood("Transport flood. Please slow down your requests.")
+                    elif error_code == 444:
+                        raise InvalidDC("Invalid data center. Please check your configuration.")
+                except TransportError as e:
+                    error_msg = str(e)
 
+                log.warning("Server sent transport error: %s (%s)", error_code, error_msg)
 
                 if self.is_started.is_set():
-                    if packet:
-                        error = f"Server sent transport error - {error_code} - ({error_msg})."
-                    else:
-                        error = "Server sent a null packet."
-
+                    error = f"Server sent transport error - {error_code} - ({error_msg})." if packet else "Server sent a null packet."
                     log.info("Restarting session due to - %s", error)
                     self.client.loop.create_task(self.restart())
-
                 break
 
             self.client.loop.create_task(self.handle_packet(packet))
-
         log.info("NetworkTask stopped")
 
     async def send(
@@ -506,17 +480,12 @@ class Session:
                 raise TimeoutError("Request timed out")
 
             if isinstance(result, raw.types.RpcError):
-                if isinstance(
-                    data, (raw.functions.InvokeWithoutUpdates, raw.functions.InvokeWithTakeout)
-                ):
+                if isinstance(data, (raw.functions.InvokeWithoutUpdates, raw.functions.InvokeWithTakeout)):
                     data = data.query
-
                 RPCError.raise_it(result, type(data))
 
             if isinstance(result, raw.types.BadMsgNotification):
-                log.warning(
-                    "%s: %s", BadMsgNotification.__name__, BadMsgNotification(result.error_code)
-                )
+                log.warning("%s: %s", BadMsgNotification.__name__, BadMsgNotification(result.error_code))
 
             if isinstance(result, raw.types.BadServerSalt):
                 self.salt = result.new_server_salt
@@ -537,9 +506,7 @@ class Session:
         except asyncio.TimeoutError:
             pass
 
-        if isinstance(
-            query, (raw.functions.InvokeWithoutUpdates, raw.functions.InvokeWithTakeout)
-        ):
+        if isinstance(query, (raw.functions.InvokeWithoutUpdates, raw.functions.InvokeWithTakeout)):
             inner_query = query.query
         else:
             inner_query = query
@@ -551,26 +518,20 @@ class Session:
                 return await self.send(query, timeout=timeout)
             except (FloodWait, FloodPremiumWait) as e:
                 amount = e.value
-
                 if amount > sleep_threshold >= 0:
                     raise
-
                 log.warning(
                     '[%s] Waiting for %s seconds before continuing (required by "%s")',
                     self.client.name,
                     amount,
                     query_name,
                 )
-
                 await asyncio.sleep(amount)
             except (OSError, InternalServerError, ServiceUnavailable) as e:
-                log.warning(
-                    '[%s] Retrying "%s" due to: %s', attempt, query_name, str(e) or repr(e)
-                )
-
+                log.warning('[Attempt %s] Retrying "%s" due to: %s', attempt, query_name, str(e) or repr(e))
                 await asyncio.sleep(retry_delay)
 
         raise TimeoutError(f'Failed to invoke "{query_name}" after {retries} retries')
 
     def __str__(self) -> str:
-        return f"Session(dc_id={self.dc_id}, test_mode={self.test_mode}, is_media={self.is_media}, is_cdn={self.is_cdn}, state={self._state.name})"
+        return f"Session(dc_id={self.dc_id}, test_mode={self.test_mode}, is_media={self.is_media}, is_cdn={self.is_cdn}, state={self._state.name})"

hypergram-1.0.3/hypergram/enums/folder_color.py

@@ -1,47 +0,0 @@
-#  hypergram - Telegram MTProto API Client Library for Python
-#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
-#
-#  This file is part of hypergram.
-#
-#  hypergram 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.
-#
-#  hypergram 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 hypergram.  If not, see <http://www.gnu.org/licenses/>.
-
-from .auto_name import AutoName
-
-
-class FolderColor(AutoName):
-    """Folder color enumeration used in :obj:`~hypergram.types.Folder`."""
-
-    NO_COLOR = None
-    "No color."
-
-    RED = 0
-    "Red color."
-
-    ORANGE = 1
-    "Orange color."
-
-    VIOLET = 2
-    "Violet color."
-
-    GREEN = 3
-    "Green color."
-
-    CYAN = 4
-    "Cyan color."
-
-    BLUE = 5
-    "Blue color."
-
-    PINK = 6
-    "Pink color."