devalerts 0.2.0__tar.gz → 0.2.2__tar.gz

{devalerts-0.2.0 → devalerts-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devalerts
-Version: 0.2.0
+Version: 0.2.2
 Summary: Send unhandled Python exceptions straight to a Telegram chat. No backend, no account, no database — just your own bot token.
 Keywords: telegram,error-tracking,exception-monitoring,alerts,logging,monitoring,asgi
 Author: sslinNn
@@ -94,6 +94,10 @@ devalerts.init(bot_token="123456:ABC-DEF...", chat_id=123456789)
 That's it — any unhandled exception (including ones raised in threads) now
 also lands in your Telegram chat.
 
+The traceback itself arrives folded into a collapsed quote — the exception
+type, message, and host are visible right away, tap to expand the full
+traceback. Keeps a big stack trace from taking over the chat.
+
 ## Grouping, rate limiting, and the dashboard
 
 Exceptions are grouped by fingerprint (exception type + file + line where it
@@ -147,15 +151,27 @@ devalerts.init(bot_token="...", chat_id=123456789, tags={"env": "production"})
 🖥️ prod-web-2 (env=production)
 ```
 
-Add ad-hoc tags to a single call — they override `init()`'s tags on a key
-collision:
+Add ad-hoc tags to a single call — they override `init()`'s tags (and each
+other) on a key collision:
 
 ```python
 devalerts.report(extra={"request_id": "abc123"})
+```
+
+Used as a decorator, `capture()` tags the alert with the wrapped function's
+name as `job` automatically — no `extra` needed:
+
+```python
+@devalerts.capture()
+def nightly_sync(): ...
+```
 
-@devalerts.capture(extra={"job": "nightly-sync"})
-def run_job(): ...
 ```
+🔴 ValueError: boom
+🖥️ prod-web-2 (job=nightly_sync)
+```
+
+Pass `extra={"job": "..."}` explicitly to override the auto-detected name.
 
 ## Manually reporting a caught exception
 

{devalerts-0.2.0 → devalerts-0.2.2}/README.md

@@ -67,6 +67,10 @@ devalerts.init(bot_token="123456:ABC-DEF...", chat_id=123456789)
 That's it — any unhandled exception (including ones raised in threads) now
 also lands in your Telegram chat.
 
+The traceback itself arrives folded into a collapsed quote — the exception
+type, message, and host are visible right away, tap to expand the full
+traceback. Keeps a big stack trace from taking over the chat.
+
 ## Grouping, rate limiting, and the dashboard
 
 Exceptions are grouped by fingerprint (exception type + file + line where it
@@ -120,15 +124,27 @@ devalerts.init(bot_token="...", chat_id=123456789, tags={"env": "production"})
 🖥️ prod-web-2 (env=production)
 ```
 
-Add ad-hoc tags to a single call — they override `init()`'s tags on a key
-collision:
+Add ad-hoc tags to a single call — they override `init()`'s tags (and each
+other) on a key collision:
 
 ```python
 devalerts.report(extra={"request_id": "abc123"})
+```
+
+Used as a decorator, `capture()` tags the alert with the wrapped function's
+name as `job` automatically — no `extra` needed:
+
+```python
+@devalerts.capture()
+def nightly_sync(): ...
+```
 
-@devalerts.capture(extra={"job": "nightly-sync"})
-def run_job(): ...
 ```
+🔴 ValueError: boom
+🖥️ prod-web-2 (job=nightly_sync)
+```
+
+Pass `extra={"job": "..."}` explicitly to override the auto-detected name.
 
 ## Manually reporting a caught exception
 

{devalerts-0.2.0 → devalerts-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "devalerts"
-version = "0.2.0"
+version = "0.2.2"
 description = "Send unhandled Python exceptions straight to a Telegram chat. No backend, no account, no database — just your own bot token."
 readme = "README.md"
 license = "MIT"

{devalerts-0.2.0 → devalerts-0.2.2}/src/devalerts/__init__.py

@@ -130,17 +130,29 @@ def report(
 class capture(contextlib.ContextDecorator):
     """Context manager / decorator: report any exception raised inside the block or
     function, then re-raise it. Use ``@capture()`` on a function instead of wrapping
-    its body in a manual ``try/except`` or ``with`` block."""
+    its body in a manual ``try/except`` or ``with`` block.
+
+    Used as a decorator, the wrapped function's name is tagged automatically as
+    ``job`` -- no need to pass ``extra={"job": ...}`` by hand. Used as a bare
+    ``with capture():`` block, there's no function to name, so only explicit
+    ``extra`` tags apply."""
 
     def __init__(self, *, extra: dict[str, str] | None = None) -> None:
         self._extra = extra
+        self._job_name: str | None = None
+
+    def __call__(self, func):
+        self._job_name = func.__qualname__
+        return super().__call__(func)
 
     def __enter__(self) -> "capture":
         return self
 
     def __exit__(self, exc_type, exc_value, tb) -> Literal[False]:
         if exc_type is not None:
-            _send_exception(exc_type, exc_value, tb, extra=self._extra)
+            tags = {"job": self._job_name} if self._job_name else {}
+            tags.update(self._extra or {})
+            _send_exception(exc_type, exc_value, tb, extra=tags)
         return False
 
 

{devalerts-0.2.0 → devalerts-0.2.2}/src/devalerts/_alert.py

@@ -9,6 +9,10 @@ import traceback
 _MAX_MESSAGE_LENGTH = 4096
 
 
+def _escape_html(text: str) -> str:
+    return text.replace("&", "&amp;").replace("<", "&lt;").replace(">", "&gt;")
+
+
 def _format_context(tags: dict[str, str] | None) -> str:
     try:
         hostname = socket.gethostname()
@@ -27,16 +31,25 @@ def _format_alert(
     if skipped:
         header += f"\n⚠️ Повторилась ещё {skipped} раз(а) с последнего алерта"
     body = "".join(traceback.format_exception(exc_type, exc_value, tb))
-    message = f"{header}\n\n{body}"
-    if len(message) <= _MAX_MESSAGE_LENGTH:
-        return message
-    marker = "\n\n...(truncated)...\n"
-    # ponytail: header itself can exceed the limit if exc_value's str() is huge
-    # (e.g. a validation error echoing a large payload) — keep can go negative,
-    # so clamp it and hard-truncate the final result as a backstop guarantee.
-    keep = max(_MAX_MESSAGE_LENGTH - len(header) - len(marker), 0)
-    truncated = f"{header}{marker}{body[-keep:]}" if keep else header
-    return truncated[:_MAX_MESSAGE_LENGTH]
+
+    if len(header) + 2 + len(body) > _MAX_MESSAGE_LENGTH:
+        marker = "\n\n...(truncated)...\n"
+        # ponytail: header itself can exceed the limit if exc_value's str() is huge
+        # (e.g. a validation error echoing a large payload) — keep can go negative,
+        # so clamp it; the header itself gets hard-truncated as a backstop. The "2"
+        # accounts for the "\n\n" separator joined in below.
+        keep = max(_MAX_MESSAGE_LENGTH - len(header) - 2 - len(marker), 0)
+        body = f"{marker}{body[-keep:]}" if keep else ""
+        header = header[:_MAX_MESSAGE_LENGTH]
+
+    # Budgeted above against the plain text -- Telegram's 4096-char limit
+    # applies to the parsed (tag-stripped) text, not the raw HTML we send.
+    escaped_header = _escape_html(header)
+    if not body:
+        return escaped_header
+    return (
+        f"{escaped_header}\n\n<blockquote expandable>{_escape_html(body)}</blockquote>"
+    )
 
 
 # ponytail: fixed pattern list, not exhaustive — catches common

{devalerts-0.2.0 → devalerts-0.2.2}/src/devalerts/_telegram.py

@@ -40,7 +40,9 @@ def _log_failed_delivery(text: str) -> None:
 
 def _send_telegram_message(bot_token: str, chat_id: int | str, text: str) -> bool:
     url = f"https://api.telegram.org/bot{bot_token}/sendMessage"
-    payload = json.dumps({"chat_id": chat_id, "text": text}).encode("utf-8")
+    payload = json.dumps(
+        {"chat_id": chat_id, "text": text, "parse_mode": "HTML"}
+    ).encode("utf-8")
     last_error: Exception | None = None
 
     for attempt in range(_MAX_ATTEMPTS):