tgdata 0.0.6__tar.gz → 0.0.7__tar.gz

{tgdata-0.0.6 → tgdata-0.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tgdata
-Version: 0.0.6
+Version: 0.0.7
 Summary: A production-grade Python library for extracting and processing Telegram group and channel messages
 Author: enes kuzucu
 Classifier: Development Status :: 3 - Alpha

{tgdata-0.0.6 → tgdata-0.0.7}/tgdata/__init__.py

@@ -33,7 +33,7 @@ from .utils import (
 # Progress tracking
 from .progress import ProgressTracker
 
-__version__ = "0.0.6"
+__version__ = "0.0.7"
 
 __all__ = [
     # Main class
@@ -60,4 +60,5 @@ __all__ = [
     
     # Progress
     "ProgressTracker"
-]
+]
+from tgdata.connection_engine import AuthRequiredError  # noqa: E402,F401

{tgdata-0.0.6 → tgdata-0.0.7}/tgdata/connection_engine.py

@@ -67,6 +67,14 @@ class ConnectionPool:
         self.connections.clear()
 
 
+class AuthRequiredError(RuntimeError):
+    """The session is not authorized and this code path is non-interactive.
+
+    Raised by ephemeral_client() instead of Telethon's start() prompt —
+    a headless process must FAIL LOUDLY here, never sit on input().
+    Fix: run an interactive login for this account once, by hand."""
+
+
 class ConnectionEngine:
     """
     Manages Telegram connections with advanced features.
@@ -189,6 +197,34 @@ class ConnectionEngine:
         yield client
         # Intentionally NO disconnect here — the connection is persistent.
 
+    @asynccontextmanager
+    async def ephemeral_client(self):
+        """USE-AND-CLOSE (2026-08-05): a fresh client on the same resolved
+        session, connected WITHOUT start() (never interactive), disconnected
+        in finally — for short, human-triggered lookups (identity fetch,
+        access probe) that must not park a live transport next to a standing
+        loop sharing the session file. The persistent session()/pool path
+        above is untouched — it remains correct for the loop's own fetches,
+        where ONE process owns the session for its lifetime.
+
+        Raises AuthRequiredError when the session is not authorized: the
+        one situation start() would have prompted for a login code and hung
+        a headless process on stdin forever."""
+        config = self._load_config()
+        client = TelegramClient(config.session_file, config.api_id, config.api_hash)
+        try:
+            await client.connect()
+            if not await client.is_user_authorized():
+                raise AuthRequiredError(
+                    f"session {config.session_file!r} is not authorized — "
+                    f"run an interactive login for this account once, then retry")
+            yield client
+        finally:
+            try:
+                await client.disconnect()
+            except Exception:  # noqa: BLE001 — teardown must never mask the work
+                pass
+
     async def _init_primary_client(self):
         """Create and authenticate the primary client once (may be interactive)."""
         config = self._load_config()

{tgdata-0.0.6 → tgdata-0.0.7}/tgdata.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tgdata
-Version: 0.0.6
+Version: 0.0.7
 Summary: A production-grade Python library for extracting and processing Telegram group and channel messages
 Author: enes kuzucu
 Classifier: Development Status :: 3 - Alpha