devalerts 0.2.1__tar.gz → 0.2.3__tar.gz

{devalerts-0.2.1 → devalerts-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devalerts
-Version: 0.2.1
+Version: 0.2.3
 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
@@ -51,6 +51,8 @@ That's the whole setup. Two minutes with [@BotFather](https://t.me/BotFather)
 and every unhandled crash — including ones raised in threads — lands in your
 chat instead of a log file nobody's watching.
 
+![devalerts demo](https://raw.githubusercontent.com/sslinNn/devalerts/main/docs/demo.gif)
+
 ## Why devalerts
 
 - **Zero infrastructure.** No SaaS signup, no ingestion server, no API key
@@ -151,15 +153,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.1 → devalerts-0.2.3}/README.md

@@ -24,6 +24,8 @@ That's the whole setup. Two minutes with [@BotFather](https://t.me/BotFather)
 and every unhandled crash — including ones raised in threads — lands in your
 chat instead of a log file nobody's watching.
 
+![devalerts demo](https://raw.githubusercontent.com/sslinNn/devalerts/main/docs/demo.gif)
+
 ## Why devalerts
 
 - **Zero infrastructure.** No SaaS signup, no ingestion server, no API key
@@ -124,15 +126,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.1 → devalerts-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "devalerts"
-version = "0.2.1"
+version = "0.2.3"
 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.1 → devalerts-0.2.3}/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.1 → devalerts-0.2.3}/src/devalerts/cli.py

@@ -27,7 +27,7 @@ _LOCATION_WIDTH = 34
 def _supports_unicode() -> bool:
     encoding = getattr(sys.stdout, "encoding", None) or ""
     try:
-        "─●…".encode(encoding)
+        "─●…×".encode(encoding)
         return True
     except (LookupError, UnicodeEncodeError, TypeError):
         return False
@@ -153,6 +153,7 @@ def _dashboard(as_json: bool = False) -> int:
     sep_char = "─" if unicode_ok else "-"
     dot_char = "●" if unicode_ok else "*"
     ellipsis = "…" if unicode_ok else "..."
+    times_char = "×" if unicode_ok else "x"
 
     style = _Style(_color_enabled())
     type_width = max(len("TYPE"), *(len(r[1]) for r in rows))
@@ -178,7 +179,9 @@ def _dashboard(as_json: bool = False) -> int:
         muted,
         backoff_multiplier,
     ) in rows:
-        backoff_suffix = f" ×{backoff_multiplier}" if backoff_multiplier > 1 else ""
+        backoff_suffix = (
+            f" {times_char}{backoff_multiplier}" if backoff_multiplier > 1 else ""
+        )
         if muted:
             muted_count += 1
             status = style.dim(f"{dot_char} muted")