devalerts 0.2.1__tar.gz → 0.2.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devalerts
-Version: 0.2.1
+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
@@ -151,16 +151,28 @@ 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:
 
-@devalerts.capture(extra={"job": "nightly-sync"})
-def run_job(): ...
+```python
+@devalerts.capture()
+def nightly_sync(): ...
 ```
 
+```
+🔴 ValueError: boom
+🖥️ prod-web-2 (job=nightly_sync)
+```
+
+Pass `extra={"job": "..."}` explicitly to override the auto-detected name.
+
 ## Manually reporting a caught exception
 
 ```python

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

@@ -124,16 +124,28 @@ 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:
 
-@devalerts.capture(extra={"job": "nightly-sync"})
-def run_job(): ...
+```python
+@devalerts.capture()
+def nightly_sync(): ...
 ```
 
+```
+🔴 ValueError: boom
+🖥️ prod-web-2 (job=nightly_sync)
+```
+
+Pass `extra={"job": "..."}` explicitly to override the auto-detected name.
+
 ## Manually reporting a caught exception
 
 ```python

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

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