mm-telegram 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

mm_telegram/bot.py

@@ -22,16 +22,22 @@ type TelegramHandler = BaseHandler[Any, CallbackContext[ExtBot[None], dict[Any,
 
 
 async def ping(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
+    """Responds with 'pong' to /ping command."""
     if update.effective_chat is not None:
         await context.bot.send_message(chat_id=update.effective_chat.id, text="pong")
 
 
 async def unknown(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
+    """Handles unknown commands with a default response."""
     if update.effective_chat is not None:
         await context.bot.send_message(chat_id=update.effective_chat.id, text="Sorry, I didn't understand that command.")
 
 
 async def is_admin(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
+    """Checks if user is admin and blocks access if not.
+
+    Raises ApplicationHandlerStop if user is not in the admins list.
+    """
     admins: list[int] = context.bot_data.get("admins", [])
 
     if update.effective_user is None or update.message is None:
@@ -44,14 +50,21 @@ async def is_admin(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
 
 
 class TelegramBot:
+    """Telegram bot wrapper that manages application lifecycle and handlers."""
+
     app: Application[Any, Any, Any, Any, Any, Any] | None
 
     def __init__(self, handlers: list[TelegramHandler], bot_data: dict[str, object]) -> None:
+        """Initialize bot with custom handlers and initial bot data."""
         self.handlers = handlers
         self.bot_data = bot_data
         self.app = None
 
     async def start(self, token: str, admins: list[int]) -> None:
+        """Start the bot with given token and admin list.
+
+        Raises ValueError if no admins are provided.
+        """
         if not admins:
             raise ValueError("No admins provided")
         logger.debug("Starting telegram bot...")
@@ -75,6 +88,7 @@ class TelegramBot:
         self.app = app
 
     async def shutdown(self) -> None:
+        """Stop the bot and clean up resources."""
         if self.app is not None:
             await self.app.shutdown()
             self.app = None

mm_telegram/message.py

@@ -1,6 +1,7 @@
 import asyncio
 
-from mm_std import Result, http_request
+from mm_http import http_request
+from mm_result import Result
 
 
 async def send_message(

mm_telegram-0.3.0.dist-info/METADATA

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: mm-telegram
+Version: 0.3.0
+Requires-Python: >=3.13
+Requires-Dist: mm-http>=0.0.1
+Requires-Dist: mm-result>=0.0.2
+Requires-Dist: python-telegram-bot~=22.1

mm_telegram-0.3.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+mm_telegram/__init__.py,sha256=MfDt-Y42ew8LaQW34MElvgrpkPcs_RWCW_coQSyFYOE,142
+mm_telegram/bot.py,sha256=VNs2yPulCQosIe_Db9HKPQ7IAGLaVbZaoDAT0i7d3oE,3186
+mm_telegram/message.py,sha256=bEJl_ctSEdTjFQbY14g3dlwZKcTef7RfaM-8Jqn4INA,2307
+mm_telegram/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mm_telegram-0.3.0.dist-info/METADATA,sha256=6vzPzU_D0XFfhmyuayP0wvaEXeWPWXSkneBJkr1lx64,182
+mm_telegram-0.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mm_telegram-0.3.0.dist-info/RECORD,,

mm_telegram-0.2.0.dist-info/METADATA

@@ -1,6 +0,0 @@
-Metadata-Version: 2.4
-Name: mm-telegram
-Version: 0.2.0
-Requires-Python: >=3.12
-Requires-Dist: mm-std~=0.4.13
-Requires-Dist: python-telegram-bot~=22.1

mm_telegram-0.2.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-mm_telegram/__init__.py,sha256=MfDt-Y42ew8LaQW34MElvgrpkPcs_RWCW_coQSyFYOE,142
-mm_telegram/bot.py,sha256=ZQeKONCiFkmuinCpgvbfYc1clvd2lB26YR9NAuL8eMs,2614
-mm_telegram/message.py,sha256=nbBWG58PjKU74NYqxwMANBLax0HJqgJ0B6r3FOAeVxg,2285
-mm_telegram/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mm_telegram-0.2.0.dist-info/METADATA,sha256=o0WxxaffFumRugRsp9zfbrXpNy8-fUn0QipGaCupXjw,150
-mm_telegram-0.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mm_telegram-0.2.0.dist-info/RECORD,,