devalerts 0.3.0__tar.gz → 0.4.0__tar.gz

{devalerts-0.3.0 → devalerts-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devalerts
-Version: 0.3.0
+Version: 0.4.0
 Summary: Send unhandled Python exceptions straight to a Telegram chat (or Slack). No backend, no account, no database — just your own bot token or webhook URL.
 Keywords: telegram,error-tracking,exception-monitoring,alerts,logging,monitoring,asgi
 Author: sslinNn
@@ -139,6 +139,34 @@ resend doubles the effective `rate_limit_seconds` for that group (capped at
 forever. A group that goes quiet and reappears once resets to the base rate
 immediately. The dashboard shows the active multiplier (`● sending ×4`).
 
+## Crash streak badge
+
+`devalerts dashboard` also reports how long it's been since the last
+recorded incident (sent or suppressed by rate-limiting) — same idea as the
+classic "days since last workplace accident" sign, applied to your crashes:
+
+```
+🟢 14 days since the last incident.
+```
+
+Get the same number as a shareable SVG badge for your README:
+
+```
+uv run devalerts badge --out docs/streak.svg
+```
+
+![devalerts crash streak badge](https://raw.githubusercontent.com/sslinNn/devalerts/main/docs/streak-badge.svg)
+
+No hosting, no cron job built in — regenerate and commit it yourself,
+e.g. on a schedule with GitHub Actions:
+
+```yaml
+- run: uv run devalerts badge --out docs/streak.svg
+- run: git add docs/streak.svg && git commit -m "Update crash streak badge" || true
+```
+
+Pass `--label` to customize the left-hand text (default `"crash streak"`).
+
 ## Context: hostname and tags
 
 Every alert automatically includes the sending host, so you can tell which

{devalerts-0.3.0 → devalerts-0.4.0}/README.md

@@ -112,6 +112,34 @@ resend doubles the effective `rate_limit_seconds` for that group (capped at
 forever. A group that goes quiet and reappears once resets to the base rate
 immediately. The dashboard shows the active multiplier (`● sending ×4`).
 
+## Crash streak badge
+
+`devalerts dashboard` also reports how long it's been since the last
+recorded incident (sent or suppressed by rate-limiting) — same idea as the
+classic "days since last workplace accident" sign, applied to your crashes:
+
+```
+🟢 14 days since the last incident.
+```
+
+Get the same number as a shareable SVG badge for your README:
+
+```
+uv run devalerts badge --out docs/streak.svg
+```
+
+![devalerts crash streak badge](https://raw.githubusercontent.com/sslinNn/devalerts/main/docs/streak-badge.svg)
+
+No hosting, no cron job built in — regenerate and commit it yourself,
+e.g. on a schedule with GitHub Actions:
+
+```yaml
+- run: uv run devalerts badge --out docs/streak.svg
+- run: git add docs/streak.svg && git commit -m "Update crash streak badge" || true
+```
+
+Pass `--label` to customize the left-hand text (default `"crash streak"`).
+
 ## Context: hostname and tags
 
 Every alert automatically includes the sending host, so you can tell which

{devalerts-0.3.0 → devalerts-0.4.0}/pyproject.toml

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

devalerts-0.4.0/src/devalerts/_badge.py

@@ -0,0 +1,55 @@
+"""Crash-streak SVG badge rendering for `devalerts badge` -- no network call,
+no shields.io dependency, just a hand-rolled flat badge."""
+
+from __future__ import annotations
+
+from xml.sax.saxutils import escape
+
+_BAND_COLORS = {
+    "grey": "#9f9f9f",
+    "red": "#e05d44",
+    "yellow": "#dfb317",
+    "green": "#4c1",
+}
+
+
+def _streak_band(days: int | None) -> str:
+    if days is None:
+        return "grey"
+    if days < 1:
+        return "red"
+    if days < 7:
+        return "yellow"
+    return "green"
+
+
+def _streak_text(days: int | None) -> str:
+    if days is None:
+        return "no incidents yet"
+    if days < 1:
+        return "today"
+    return f"{days} day{'' if days == 1 else 's'}"
+
+
+def _render_badge(label: str, days: int | None) -> str:
+    """Flat shields.io-style badge. Character width is a fixed-per-glyph
+    approximation, not real font metrics -- fine for a README image, not
+    meant to be pixel-perfect."""
+    value = _streak_text(days)
+    color = _BAND_COLORS[_streak_band(days)]
+    label_width = 10 + 7 * len(label)
+    value_width = 10 + 7 * len(value)
+    width = label_width + value_width
+    height = 20
+    label_esc = escape(label)
+    value_esc = escape(value)
+    return (
+        f'<svg xmlns="http://www.w3.org/2000/svg" width="{width}" height="{height}">'
+        f'<rect width="{label_width}" height="{height}" fill="#555"/>'
+        f'<rect x="{label_width}" width="{value_width}" height="{height}" fill="{color}"/>'
+        f'<g fill="#fff" font-family="Verdana,Geneva,sans-serif" font-size="11">'
+        f'<text x="{label_width / 2}" y="14" text-anchor="middle">{label_esc}</text>'
+        f'<text x="{label_width + value_width / 2}" y="14" text-anchor="middle">'
+        f"{value_esc}</text>"
+        f"</g></svg>"
+    )

{devalerts-0.3.0 → devalerts-0.4.0}/src/devalerts/_store.py

@@ -152,6 +152,18 @@ def _should_send(
         return True, 0, True
 
 
+def _last_incident() -> float | None:
+    """Unix timestamp of the most recent occurrence across all groups (sent or
+    suppressed -- last_seen is updated either way), or None if the state DB
+    has no groups recorded (fresh install, or everything cleared)."""
+    conn = _get_connection()
+    try:
+        row = conn.execute("SELECT MAX(last_seen) FROM error_groups").fetchone()
+    finally:
+        conn.close()
+    return row[0]
+
+
 def _match_fingerprints(prefix: str) -> list[str]:
     """Fingerprints starting with prefix, for CLI mute/unmute/clear commands."""
     conn = _get_connection()

{devalerts-0.3.0 → devalerts-0.4.0}/src/devalerts/cli.py

@@ -1,6 +1,7 @@
 """CLI: `devalerts dashboard` reports grouped/rate-limited errors from the local
 state DB; `devalerts test` sends a one-off message to verify bot_token/chat_id
-and/or slack_webhook_url."""
+and/or slack_webhook_url; `devalerts badge` renders a 'days since last
+incident' SVG badge."""
 
 from __future__ import annotations
 
@@ -11,13 +12,16 @@ import sqlite3
 import sys
 import time
 from importlib.metadata import version as _pkg_version
+from pathlib import Path
 
+from ._badge import _render_badge, _streak_band
 from ._slack import _send_slack_message
 from ._store import (
     _DB_PATH,
     _DEFAULT_RATE_LIMIT_SECONDS,
     _clear,
     _clear_all,
+    _last_incident,
     _match_fingerprints,
     _set_muted,
 )
@@ -54,6 +58,23 @@ def _relative_time(ts: float, now: float) -> str:
     return f"{int(delta // 86400)}d ago"
 
 
+def _streak_line(last_incident: float, now: float, unicode_ok: bool) -> str:
+    days = int((now - last_incident) // 86400)
+    band = _streak_band(days)
+    icons = (
+        {"red": "🔴", "yellow": "🟡", "green": "🟢"}
+        if unicode_ok
+        else {"red": "[RESET]", "yellow": "[WARN]", "green": "[OK]"}
+    )
+    if band == "red":
+        return (
+            f"{icons['red']} New incident {_relative_time(last_incident, now)}"
+            " — streak reset to 0 days."
+        )
+    plural = "" if days == 1 else "s"
+    return f"{icons[band]} {days} day{plural} since the last incident."
+
+
 def _color_enabled() -> bool:
     if os.environ.get("NO_COLOR") is not None or not sys.stdout.isatty():
         return False
@@ -157,6 +178,9 @@ def _dashboard(as_json: bool = False) -> int:
     ellipsis = "…" if unicode_ok else "..."
     times_char = "×" if unicode_ok else "x"
 
+    print(_streak_line(rows[0][3], now, unicode_ok))
+    print()
+
     style = _Style(_color_enabled())
     type_width = max(len("TYPE"), *(len(r[1]) for r in rows))
 
@@ -255,6 +279,18 @@ def _clear_command(prefix: str | None, clear_all: bool) -> int:
     return 0
 
 
+def _badge_command(out: str | None, label: str) -> int:
+    incident = _last_incident()
+    days = int((time.time() - incident) // 86400) if incident is not None else None
+    svg = _render_badge(label, days)
+    if out:
+        Path(out).write_text(svg, encoding="utf-8")
+        print(f"Wrote badge to {out}.")
+    else:
+        print(svg)
+    return 0
+
+
 def _test(
     bot_token: str | None, chat_id: str | None, slack_webhook_url: str | None
 ) -> int:
@@ -330,6 +366,17 @@ def main(argv: list[str] | None = None) -> int:
     clear_target.add_argument(
         "--all", action="store_true", help="Delete all error groups"
     )
+    badge_parser = subparsers.add_parser(
+        "badge", help="Print or write an SVG 'days since last incident' badge"
+    )
+    badge_parser.add_argument(
+        "--out", help="Write the SVG to this path instead of stdout"
+    )
+    badge_parser.add_argument(
+        "--label",
+        default="crash streak",
+        help="Badge label text (default: 'crash streak')",
+    )
     args = parser.parse_args(argv)
 
     if args.command == "dashboard":
@@ -342,6 +389,8 @@ def main(argv: list[str] | None = None) -> int:
         return _mute_command(args.fingerprint, muted=False)
     if args.command == "clear":
         return _clear_command(args.fingerprint, args.all)
+    if args.command == "badge":
+        return _badge_command(args.out, args.label)
     return 1