mm-telegram 0.1.1__py3-none-any.whl → 0.1.2__py3-none-any.whl

mm_telegram/simple_message.py

@@ -3,30 +3,60 @@ import asyncio
 from mm_std import Result, http_request
 
 
-async def send_message(bot_token: str, chat_id: int, message: str, long_message_delay: int = 3) -> Result[list[int]]:
+async def send_message(
+    bot_token: str,
+    chat_id: int,
+    message: str,
+    timeout: float = 5,
+    inter_message_delay_seconds: int = 3,
+) -> Result[list[int]]:
+    """
+    Sends a message to a Telegram chat.
+
+    If the message exceeds the Telegram character limit (4096),
+    it will be split into multiple messages and sent sequentially
+    with a delay between each part.
+
+    Args:
+        bot_token: The Telegram bot token.
+        chat_id: The target chat ID.
+        message: The message text to send.
+        timeout: The HTTP request timeout in seconds. Defaults to 5.
+        inter_message_delay_seconds: The delay in seconds between sending
+            parts of a long message. Defaults to 3.
+
+    Returns:
+        A Result object containing a list of message IDs for the sent messages
+        on success, or an error details on failure. The 'extra' field in the
+        Result contains the raw responses from the Telegram API.
+    """
     messages = _split_string(message, 4096)
     responses = []
-    result = []
+    result_message_ids = []
     while True:
-        text = messages.pop(0)
-        params = {"chat_id": chat_id, "text": text}
-        res = await http_request(f"https://api.telegram.org/bot{bot_token}/sendMessage", method="post", json=params)
+        text_part = messages.pop(0)
+        params = {"chat_id": chat_id, "text": text_part}
+        res = await http_request(
+            f"https://api.telegram.org/bot{bot_token}/sendMessage", method="post", json=params, timeout=timeout
+        )
         responses.append(res.to_dict())
         if res.is_err():
-            return Result.err(res.error or "error", extra={"responses": [responses]})
+            return Result.err(res.error or "error sending message", extra={"responses": responses})
 
         message_id = res.parse_json_body("result.message_id", none_on_error=True)
         if message_id:
-            result.append(message_id)
+            result_message_ids.append(message_id)
         else:
-            return Result.err("unknown_response", extra={"responses": responses})
+            # Log the unexpected response for debugging?
+            return Result.err("unknown_response_structure", extra={"responses": responses})
 
         if len(messages):
-            await asyncio.sleep(long_message_delay)
+            await asyncio.sleep(inter_message_delay_seconds)
         else:
             break
-    return Result.ok(result, extra={"responses": responses})
+    return Result.ok(result_message_ids, extra={"responses": responses})
 
 
 def _split_string(text: str, chars_per_string: int) -> list[str]:
+    """Splits a string into a list of strings, each with a maximum length."""
     return [text[i : i + chars_per_string] for i in range(0, len(text), chars_per_string)]

{mm_telegram-0.1.1.dist-info → mm_telegram-0.1.2.dist-info}/METADATA

@@ -1,5 +1,5 @@
 Metadata-Version: 2.4
 Name: mm-telegram
-Version: 0.1.1
+Version: 0.1.2
 Requires-Python: >=3.12
-Requires-Dist: mm-std~=0.4.8
+Requires-Dist: mm-std~=0.4.11

mm_telegram-0.1.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+mm_telegram/__init__.py,sha256=Nl5I50id12u28Q0H_uHziyd2t_bjySeZAH1etBOVW3A,57
+mm_telegram/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mm_telegram/simple_message.py,sha256=nbBWG58PjKU74NYqxwMANBLax0HJqgJ0B6r3FOAeVxg,2285
+mm_telegram-0.1.2.dist-info/METADATA,sha256=SX9nfEVX-V_8fdzTahfrY_RuDRMpNR0yq_BXugWXDd0,109
+mm_telegram-0.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mm_telegram-0.1.2.dist-info/RECORD,,

mm_telegram-0.1.1.dist-info/RECORD

@@ -1,6 +0,0 @@
-mm_telegram/__init__.py,sha256=Nl5I50id12u28Q0H_uHziyd2t_bjySeZAH1etBOVW3A,57
-mm_telegram/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mm_telegram/simple_message.py,sha256=fT0zhmUPqq_w2EvTdOKLC0JhVMh3nZmthApY8dmY_fk,1193
-mm_telegram-0.1.1.dist-info/METADATA,sha256=8Iusxz_r-QCJMu7dN8BNW9VN2EFNUZBxO3G0NwNYnEc,108
-mm_telegram-0.1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mm_telegram-0.1.1.dist-info/RECORD,,