spluspy 1.0.2__tar.gz → 1.0.4__tar.gz

{spluspy-1.0.2 → spluspy-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spluspy
-Version: 1.0.2
+Version: 1.0.4
 Summary: Soroush Plus library for Python
 Home-page: https://github.com/Itskillmaster/spluspy
 Download-URL: https://github.com/Itskillmaster/spluspy/releases
@@ -89,7 +89,7 @@ Install the latest version from PyPI:
 
 .. code-block:: sh
 
-   pip install -U splusthon
+   pip install -U spluspy
 
 For faster encryption (recommended):
 

{spluspy-1.0.2 → spluspy-1.0.4}/README.rst

@@ -49,7 +49,7 @@ Install the latest version from PyPI:
 
 .. code-block:: sh
 
-   pip install -U splusthon
+   pip install -U spluspy
 
 For faster encryption (recommended):
 

{spluspy-1.0.2 → spluspy-1.0.4}/spluspy/client/auth.py

@@ -19,8 +19,8 @@ class AuthMethods:
 
     def start(
             self: 'SoroushClient',
-            phone: typing.Union[typing.Callable[[], str], str] = lambda: input('Please enter your phone (or bot token): '),
-            password: typing.Union[typing.Callable[[], str], str] = lambda: getpass.getpass('Please enter your password: '),
+            phone: typing.Union[typing.Callable[[], str], str] = lambda: input('Please Enter The Phone Number Like This ( 989123456789 ): '),
+            password: typing.Union[typing.Callable[[], str], str] = lambda: getpass.getpass('Please Enter The Password: '),
             *,
             bot_token: str = None,
             force_sms: bool = False,
@@ -99,7 +99,7 @@ class AuthMethods:
         """
         if code_callback is None:
             def code_callback():
-                return input('Please enter the code you received: ')
+                return input('Please Enter The Code: ')
         elif not callable(code_callback):
             raise ValueError(
                 'The code_callback parameter needs to be a callable '
@@ -333,7 +333,7 @@ class AuthMethods:
                 phone = '+34 123 123 123'
                 await client.sign_in(phone)  # send code
 
-                code = input('enter code: ')
+                code = input('Please Enter The Code: ')
                 await client.sign_in(phone, code)
         """
         me = None

{spluspy-1.0.2 → spluspy-1.0.4}/spluspy/client/soroushclient.py

@@ -636,6 +636,358 @@ class SoroushClient(
 
     # endregion
 
+    # region Convenience methods - Messages
+
+    async def edit_message(self, *args, **kwargs):
+        """Edit a message. Shortcut for client.edit_message(...)."""
+        return await super().edit_message(*args, **kwargs)
+
+    async def delete_message(self, message):
+        """
+        Delete a single message.
+
+        Arguments
+            message: The message to delete (ID, Message object, or list).
+
+        Example
+            .. code-block:: python
+
+                await client.delete_message(msg)
+                await client.delete_message(12345)
+        """
+        return await self.delete_messages(message)
+
+    async def delete_messages(self, *args, **kwargs):
+        """Delete one or more messages."""
+        return await super().delete_messages(*args, **kwargs)
+
+    async def forward_message(self, entity, messages, from_peer=None):
+        """
+        Forward a single message.
+
+        Arguments
+            entity: Destination chat.
+            messages: The message to forward.
+            from_peer: Source chat (required if messages is an ID).
+
+        Example
+            .. code-block:: python
+
+                await client.forward_message(chat, message)
+                await client.forward_message(chat, 12345, from_peer=source_chat)
+        """
+        return await self.forward_messages(entity, messages, from_peer=from_peer)
+
+    async def mark_as_read(self, entity, message=None, max_id=0):
+        """
+        Mark messages as read.
+
+        Arguments
+            entity: The chat to mark as read.
+            message: Specific message to mark as read.
+            max_id: Mark all messages up to this ID as read.
+
+        Example
+            .. code-block:: python
+
+                await client.mark_as_read(chat)
+                await client.mark_as_read(chat, message)
+        """
+        if message is not None:
+            msg_id = self._get_message_id(message)
+            return await self.send_read_acknowledge(entity, max_id=msg_id)
+        return await self.send_read_acknowledge(entity, max_id=max_id)
+
+    # endregion
+
+    # region Convenience methods - Send Media
+
+    async def send_voice(self, entity, file, *, caption=None, **kwargs):
+        """
+        Send a voice note. Shortcut for send_audio with voice_note=True.
+
+        Example
+            .. code-block:: python
+
+                await client.send_voice(chat, 'voice.ogg')
+        """
+        return await self.send_audio(entity, file, caption=caption, voice_note=True, **kwargs)
+
+    async def send_video_note(self, entity, file, **kwargs):
+        """
+        Send a round video note.
+
+        Example
+            .. code-block:: python
+
+                await client.send_video_note(chat, 'round.mp4')
+        """
+        return await self.send_file(entity, file, video_note=True, **kwargs)
+
+    async def send_sticker(self, entity, sticker, **kwargs):
+        """
+        Send a sticker.
+
+        Example
+            .. code-block:: python
+
+                await client.send_sticker(chat, 'sticker.webp')
+        """
+        return await self.send_file(entity, sticker, **kwargs)
+
+    async def send_gif(self, entity, gif, *, caption=None, **kwargs):
+        """
+        Send an animated GIF.
+
+        Example
+            .. code-block:: python
+
+                await client.send_gif(chat, 'animation.gif')
+        """
+        return await self.send_file(entity, gif, caption=caption, **kwargs)
+
+    async def send_animation(self, entity, file, *, caption=None, **kwargs):
+        """
+        Send an animation (GIF). Alias for send_gif.
+
+        Example
+            .. code-block:: python
+
+                await client.send_animation(chat, 'animation.gif')
+        """
+        return await self.send_gif(entity, file, caption=caption, **kwargs)
+
+    async def send_location(self, entity, latitude, longitude, **kwargs):
+        """
+        Send a geographic location.
+
+        Arguments
+            entity: Who will receive the location.
+            latitude: Latitude coordinate.
+            longitude: Longitude coordinate.
+
+        Example
+            .. code-block:: python
+
+                await client.send_location(chat, 35.6892, 51.3890)
+        """
+        from ..tl import types
+        media = types.InputMediaGeoPoint(
+            types.InputGeoPoint(latitude, longitude)
+        )
+        return await self.send_file(entity, media, **kwargs)
+
+    async def send_contact(self, entity, phone_number, first_name, last_name='', **kwargs):
+        """
+        Send a contact.
+
+        Arguments
+            entity: Who will receive the contact.
+            phone_number: Phone number of the contact.
+            first_name: First name of the contact.
+            last_name: Last name of the contact.
+
+        Example
+            .. code-block:: python
+
+                await client.send_contact(chat, '+989123456789', 'Ali')
+        """
+        from ..tl import types
+        media = types.InputMediaContact(
+            phone_number=phone_number,
+            first_name=first_name,
+            last_name=last_name,
+            vcard=''
+        )
+        return await self.send_file(entity, media, **kwargs)
+
+    async def send_poll(self, entity, question, options, **kwargs):
+        """
+        Send a poll.
+
+        Arguments
+            entity: Who will receive the poll.
+            question: The poll question.
+            options: List of answer options (strings).
+
+        Example
+            .. code-block:: python
+
+                await client.send_poll(chat, 'Favorite color?', ['Red', 'Blue', 'Green'])
+        """
+        from ..tl import types
+        poll = types.InputMediaPoll(
+            poll=types.Poll(
+                id=0,
+                question=question,
+                answers=[
+                    types.PollAnswer(text=opt, option=bytes([i]))
+                    for i, opt in enumerate(options)
+                ],
+                multiple_answers=False,
+                closed=False,
+                public_voters=False,
+                native=True,
+                quiz=False
+            )
+        )
+        return await self.send_file(entity, poll, **kwargs)
+
+    async def send_dice(self, entity, emoji='🎲', **kwargs):
+        """
+        Send a dice animation.
+
+        Arguments
+            entity: Who will receive the dice.
+            emoji: The emoji for the dice ('🎲', '🏀', '⚽', '🎯', '🎰', '🎳').
+
+        Example
+            .. code-block:: python
+
+                await client.send_dice(chat)
+                await client.send_dice(chat, emoji='🎯')
+        """
+        from ..tl import types
+        media = types.InputMediaDice(emoji)
+        return await self.send_file(entity, media, **kwargs)
+
+    # endregion
+
+    # region Convenience methods - Chat Info
+
+    async def get_chat(self, entity):
+        """
+        Get full chat/channel information.
+
+        Arguments
+            entity: The chat or channel entity.
+
+        Example
+            .. code-block:: python
+
+                chat = await client.get_chat(chat)
+                print(chat.title)
+        """
+        return await self.get_entity(entity)
+
+    async def leave_chat(self, entity):
+        """
+        Leave a chat or channel.
+
+        Arguments
+            entity: The chat or channel to leave.
+
+        Example
+            .. code-block:: python
+
+                await client.leave_chat(chat)
+        """
+        from .. import helpers
+        entity = await self.get_input_entity(entity)
+        ty = helpers._entity_type(entity)
+        if ty == helpers._EntityType.CHANNEL:
+            from ..tl import functions
+            return await self(functions.channels.LeaveChannelRequest(entity))
+        else:
+            from ..tl import functions, types
+            return await self(functions.messages.DeleteChatUserRequest(
+                entity.chat_id,
+                types.InputPeerSelf()
+            ))
+
+    async def get_me(self, input_peer=False):
+        """
+        Get the current logged-in user.
+
+        Arguments
+            input_peer: If True, return InputPeer instead of User.
+
+        Example
+            .. code-block:: python
+
+                me = await client.get_me()
+                print(me.first_name)
+        """
+        return await super().get_me(input_peer=input_peer)
+
+    async def get_entity(self, *args, **kwargs):
+        """Get an entity by ID, username, phone, or peer."""
+        return await super().get_entity(*args, **kwargs)
+
+    async def get_input_entity(self, *args, **kwargs):
+        """Get an InputPeer for the given entity."""
+        return await super().get_input_entity(*args, **kwargs)
+
+    async def get_peer_id(self, *args, **kwargs):
+        """Get the integer ID for the given entity."""
+        return await super().get_peer_id(*args, **kwargs)
+
+    # endregion
+
+    # region Convenience methods - Chat Actions
+
+    async def start_typing(self, entity):
+        """Show typing indicator."""
+        return await self.action(entity, 'typing').__aenter__()
+
+    async def stop_typing(self, entity):
+        """Cancel typing indicator."""
+        return await self.action(entity, 'cancel')
+
+    # endregion
+
+    # region Convenience methods - File Download
+
+    async def download_media(self, *args, **kwargs):
+        """Download media from a message."""
+        return await super().download_media(*args, **kwargs)
+
+    async def download_file(self, *args, **kwargs):
+        """Download a file. Alias for download_media."""
+        return await self.download_media(*args, **kwargs)
+
+    # endregion
+
+    # region Convenience methods - Iterators
+
+    def iter_messages(self, *args, **kwargs):
+        """Iterator over messages."""
+        return super().iter_messages(*args, **kwargs)
+
+    def iter_participants(self, *args, **kwargs):
+        """Iterator over chat participants."""
+        return super().iter_participants(*args, **kwargs)
+
+    def iter_dialogs(self, *args, **kwargs):
+        """Iterator over dialogs."""
+        return super().iter_dialogs(*args, **kwargs)
+
+    # endregion
+
+    # region Convenience methods - Aliases
+
+    # send_message already exists in MessageMethods
+    # send_file already exists in UploadMethods
+    # edit_message already exists in MessageMethods
+    # delete_messages already exists in MessageMethods
+    # forward_messages already exists in MessageMethods
+    # get_messages already exists in MessageMethods
+    # send_read_acknowledge already exists in MessageMethods
+
+    async def get_messages(self, *args, **kwargs):
+        """Get messages from a chat."""
+        return await super().get_messages(*args, **kwargs)
+
+    async def get_dialogs(self, *args, **kwargs):
+        """Get list of dialogs."""
+        return await super().get_dialogs(*args, **kwargs)
+
+    async def get_participants(self, *args, **kwargs):
+        """Get list of participants."""
+        return await super().get_participants(*args, **kwargs)
+
+    # endregion
+
     def __repr__(self):
         connected = self.is_connected()
         try:

{spluspy-1.0.2 → spluspy-1.0.4}/spluspy/client/telegrambaseclient.py

@@ -251,7 +251,7 @@ class TelegramBaseClient(abc.ABC):
             local_addr: typing.Union[str, tuple] = None,
             timeout: int = 10,
             request_retries: int = 5,
-            connection_retries: int = 5,
+            connection_retries: int = 10,
             retry_delay: int = 1,
             auto_reconnect: bool = True,
             sequential_updates: bool = False,
@@ -680,6 +680,13 @@ class TelegramBaseClient(abc.ABC):
         self._updates_handle = self.loop.create_task(self._update_loop())
         self._keepalive_handle = self.loop.create_task(self._keepalive_loop())
 
+        # Check for library updates in background
+        try:
+            from ..updater import check_for_updates
+            self.loop.create_task(check_for_updates())
+        except Exception:
+            pass
+
     def is_connected(self: 'SoroushClient') -> bool:
         """
         Returns `True` if the user has connected.

{spluspy-1.0.2 → spluspy-1.0.4}/spluspy/network/mtprotosender.py

@@ -313,8 +313,13 @@ class MTProtoSender:
             self._log.debug('auth_key generation success!')
             return True
         except (SecurityError, AssertionError) as e:
-            self._log.warning('Attempt %d at new auth_key failed: %s', attempt, e)
-            await asyncio.sleep(self._delay)
+            # Exponential backoff: 2s, 4s, 8s, 16s, 30s (max)
+            delay = min(2 ** attempt, 30)
+            self._log.warning(
+                'Attempt %d at new auth_key failed: %s (retrying in %ds)',
+                attempt, e, delay
+            )
+            await asyncio.sleep(delay)
             return False
 
     async def _disconnect(self, error=None):

spluspy-1.0.4/spluspy/updater.py

@@ -0,0 +1,72 @@
+"""
+Automatic update checker for SPlusPy.
+
+Checks PyPI for new versions and prints a notice to the user.
+Non-blocking, runs in background, checks once per session.
+"""
+import asyncio
+import logging
+
+from .version import __version__
+
+logger = logging.getLogger(__name__)
+
+PYPI_URL = 'https://pypi.org/pypi/spluspy/json'
+_timeout = 10
+
+
+def _parse_version(version_str):
+    """Parse version string into tuple of ints."""
+    try:
+        return tuple(int(p) for p in version_str.strip().split('.')[:3])
+    except (ValueError, AttributeError):
+        return (0, 0, 0)
+
+
+async def check_for_updates():
+    """
+    Check PyPI for newer version. Prints notice if update available.
+    Runs silently in background, never crashes the app.
+    """
+    try:
+        import urllib.request
+        import json
+
+        loop = asyncio.get_event_loop()
+
+        def _fetch():
+            try:
+                req = urllib.request.Request(
+                    PYPI_URL,
+                    headers={'Accept': 'application/json'}
+                )
+                with urllib.request.urlopen(req, timeout=_timeout) as resp:
+                    data = json.loads(resp.read().decode())
+                    return data.get('info', {}).get('version')
+            except Exception:
+                return None
+
+        latest = await asyncio.wait_for(
+            loop.run_in_executor(None, _fetch),
+            timeout=_timeout
+        )
+
+        if not latest:
+            return
+
+        current = _parse_version(__version__)
+        new = _parse_version(latest)
+
+        if new > current:
+            print(
+                f'\n'
+                f'========================================\n'
+                f'  SPlusPy Update Available!\n'
+                f'  Current version: v{__version__}\n'
+                f'  Latest version:  v{latest}\n'
+                f'  Update command:  pip install -U spluspy=={latest}\n'
+                f'========================================\n'
+            )
+
+    except Exception:
+        pass  # Never let update check crash the app

{spluspy-1.0.2 → spluspy-1.0.4}/spluspy/version.py

@@ -1,3 +1,3 @@
 # Versions should comply with PEP440.
 # This line is parsed in setup.py:
-__version__ = '1.0.2'
+__version__ = '1.0.4'

{spluspy-1.0.2 → spluspy-1.0.4}/spluspy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spluspy
-Version: 1.0.2
+Version: 1.0.4
 Summary: Soroush Plus library for Python
 Home-page: https://github.com/Itskillmaster/spluspy
 Download-URL: https://github.com/Itskillmaster/spluspy/releases
@@ -89,7 +89,7 @@ Install the latest version from PyPI:
 
 .. code-block:: sh
 
-   pip install -U splusthon
+   pip install -U spluspy
 
 For faster encryption (recommended):
 

{spluspy-1.0.2 → spluspy-1.0.4}/spluspy.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ spluspy/password.py
 spluspy/requestiter.py
 spluspy/sync.py
 spluspy/types.py
+spluspy/updater.py
 spluspy/utils.py
 spluspy/version.py
 spluspy.egg-info/PKG-INFO