expr-tracker 0.2.1__tar.gz → 0.2.2__tar.gz

{expr_tracker-0.2.1 → expr_tracker-0.2.2}/.gitignore

@@ -14,3 +14,8 @@ test.ipynb
 .coverage
 htmlcov/
 site/
+
+# Tracker run output: the default dir, and whatever people point --dir at
+tracker/
+outputs/
+runs/

expr_tracker-0.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hangxing Wei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -1,8 +1,28 @@
 Metadata-Version: 2.4
 Name: expr_tracker
-Version: 0.2.1
-Summary: Add your description here
+Version: 0.2.2
+Summary: Local-first experiment tracking with queryable history and expression-based alerts on your training metrics
+Project-URL: Homepage, https://hspk.github.io/expr_tracker/
+Project-URL: Documentation, https://hspk.github.io/expr_tracker/
+Project-URL: Repository, https://github.com/HSPK/expr_tracker
+Project-URL: Issues, https://github.com/HSPK/expr_tracker/issues
+Project-URL: Changelog, https://github.com/HSPK/expr_tracker/releases
 Author-email: HSPK <whxway@whu.edu.cn>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: alerting,deep-learning,experiment-tracking,machine-learning,mlops,monitoring,training,wandb
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Monitoring
+Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: click>=8.1.0
 Requires-Dist: loguru>=0.7.3
@@ -27,6 +47,11 @@ Description-Content-Type: text/markdown
 
 # Experiment Tracker
 
+[![PyPI](https://img.shields.io/pypi/v/expr-tracker)](https://pypi.org/project/expr-tracker/)
+[![Python](https://img.shields.io/pypi/pyversions/expr-tracker)](https://pypi.org/project/expr-tracker/)
+[![License](https://img.shields.io/pypi/l/expr-tracker)](LICENSE)
+[![Docs](https://img.shields.io/badge/docs-github.io-blue)](https://hspk.github.io/expr_tracker/)
+
 A local-first experiment tracker. Metrics land in a JSONL file you own, stay
 queryable while the run is live, and can trigger alerts from an expression language.
 `wandb` and `trackio` are optional mirrors, not requirements.
@@ -141,3 +166,7 @@ Published to GitHub Pages by `.github/workflows/docs.yaml` on every push to `mai
 Internals: [`docs/design.md`](docs/design.md) (data model and key invariants) and
 [`docs/architecture.md`](docs/architecture.md) (module map, read/write paths,
 concurrency model).
+
+## License
+
+[MIT](LICENSE)

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

@@ -1,5 +1,10 @@
 # Experiment Tracker
 
+[![PyPI](https://img.shields.io/pypi/v/expr-tracker)](https://pypi.org/project/expr-tracker/)
+[![Python](https://img.shields.io/pypi/pyversions/expr-tracker)](https://pypi.org/project/expr-tracker/)
+[![License](https://img.shields.io/pypi/l/expr-tracker)](LICENSE)
+[![Docs](https://img.shields.io/badge/docs-github.io-blue)](https://hspk.github.io/expr_tracker/)
+
 A local-first experiment tracker. Metrics land in a JSONL file you own, stay
 queryable while the run is live, and can trigger alerts from an expression language.
 `wandb` and `trackio` are optional mirrors, not requirements.
@@ -114,3 +119,7 @@ Published to GitHub Pages by `.github/workflows/docs.yaml` on every push to `mai
 Internals: [`docs/design.md`](docs/design.md) (data model and key invariants) and
 [`docs/architecture.md`](docs/architecture.md) (module map, read/write paths,
 concurrency model).
+
+## License
+
+[MIT](LICENSE)

{expr_tracker-0.2.1 → expr_tracker-0.2.2}/docs/guide/alerts.md

@@ -93,6 +93,69 @@ Built-in types: `lark`, `slack`, `dingtalk`, `wecom`, `webhook` (a generic JSON
 template), `email`, `callable`. All but `lark` use only the standard library. Add
 your own with `register_backend()`.
 
+### Email
+
+Email needs an SMTP server to send *from*, even when the recipient is Gmail.
+
+```python
+et.init(
+    project="demo",
+    alert={
+        "channels": [
+            {
+                "type": "email",
+                "name": "inbox",
+                "options": {
+                    "host": "smtp.gmail.com",
+                    "port": 587,
+                    "tls": True,
+                    "user": "you@gmail.com",
+                    "password": os.environ["SMTP_PASSWORD"],
+                    "sender": "you@gmail.com",
+                    "to": ["you@gmail.com", "teammate@example.com"],
+                },
+                "min_level": "error",
+            }
+        ]
+    },
+    alert_rules=["isnan(loss) => critical: loss diverged"],
+)
+```
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `host` | — | SMTP server, **required** |
+| `to` | — | one address or a list, **required** |
+| `port` | 465 with `ssl`, else 25 | |
+| `tls` | `false` | STARTTLS on a plain connection (port 587) |
+| `ssl` | `false` | implicit TLS from the start (port 465) |
+| `user` / `password` | — | omit both for an unauthenticated relay |
+| `sender` | `user`, else `expr-tracker` | the `From` address |
+| `html` | `true` | send the HTML part as well as the text |
+
+Use `tls` **or** `ssl`, not both: `tls` upgrades a plain connection, `ssl` starts
+encrypted.
+
+!!! warning "Keep the password out of your code"
+    Read it from the environment, as above. Gmail additionally rejects account
+    passwords for SMTP — turn on 2-step verification and create an
+    [app password](https://myaccount.google.com/apppasswords), which you can
+    revoke independently of your account.
+
+Mail is sent as `multipart/alternative`: a severity-coloured HTML card with the
+fields as a table, plus the plain text as a fallback for clients that will not
+render HTML. Set `html: false` for text only.
+
+Common servers:
+
+| Provider | host | port | setting |
+| --- | --- | --- | --- |
+| Gmail | `smtp.gmail.com` | 587 | `tls: true` (app password required) |
+| Outlook / Office 365 | `smtp.office365.com` | 587 | `tls: true` |
+| QQ / 163 | `smtp.qq.com`, `smtp.163.com` | 465 | `ssl: true` (authorisation code) |
+| SendGrid | `smtp.sendgrid.net` | 587 | `tls: true`, user `apikey` |
+| Internal relay | your host | 25 | often no `user`/`password` |
+
 ### Routing
 
 Each channel filters independently:

{expr_tracker-0.2.1 → expr_tracker-0.2.2}/docs/reference/configuration.md

@@ -79,6 +79,7 @@ alert:
 | `levels` | an exact allowlist, overriding `min_level` |
 | `tags` | deliver only if the message tags intersect |
 | `options` | backend-specific settings |
+| `options.html` | email only: send an HTML part alongside the text (default `true`) |
 | `policy` | overrides the default delivery policy |
 
 ### Delivery policy
@@ -104,7 +105,7 @@ alert:
 | `condition` | — | the expression (alias: `expr`) |
 | `name` | derived | identifies the rule (alias: `alert`) |
 | `level` | `warning` | `debug`, `info`, `warning`, `error`, `critical` |
-| `title` / `message` | derived | supports templates |
+| `title` / `message` | derived | supports templates; the title defaults to `name` when you set one, else to the condition |
 | `mode` | `"edge"` | `edge` fires on transition, `level` keeps firing |
 | `for_steps` | 1 | must hold this many consecutive steps (alias: `for`) |
 | `cooldown` | 300.0 | seconds between repeats in level mode |

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

@@ -1,9 +1,35 @@
 [project]
 name = "expr_tracker"
-description = "Add your description here"
+description = "Local-first experiment tracking with queryable history and expression-based alerts on your training metrics"
 readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
 authors = [{ name = "HSPK", email = "whxway@whu.edu.cn" }]
 requires-python = ">=3.10"
+keywords = [
+    "machine-learning",
+    "experiment-tracking",
+    "mlops",
+    "monitoring",
+    "alerting",
+    "training",
+    "deep-learning",
+    "wandb",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: System :: Monitoring",
+    "Typing :: Typed",
+]
 dependencies = [
     "click>=8.1.0",
     "loguru>=0.7.3",
@@ -27,6 +53,13 @@ all = [
     "polars>=0.20",
 ]
 
+[project.urls]
+Homepage = "https://hspk.github.io/expr_tracker/"
+Documentation = "https://hspk.github.io/expr_tracker/"
+Repository = "https://github.com/HSPK/expr_tracker"
+Issues = "https://github.com/HSPK/expr_tracker/issues"
+Changelog = "https://github.com/HSPK/expr_tracker/releases"
+
 [project.scripts]
 et = "expr_tracker.cli:main"
 

{expr_tracker-0.2.1 → expr_tracker-0.2.2}/src/expr_tracker/alerts/backends/__init__.py

@@ -13,6 +13,7 @@ from .base import (
     create_backend,
     post_json,
     register_backend,
+    render_html,
     render_text,
 )
 
@@ -189,7 +190,10 @@ class EmailBackend(AlertBackend):
         mail["Subject"] = f"[{message.level.value}] {message.title}"
         mail["From"] = options.get("sender") or options.get("user") or "expr-tracker"
         mail["To"] = ", ".join(recipients)
-        mail.set_content(render_text(message))
+        # multipart/alternative: rich clients show the card, the rest see the text
+        mail.set_content(f"{message.title}\n\n{render_text(message)}")
+        if options.get("html", True):
+            mail.add_alternative(render_html(message), subtype="html")
         policy_timeout = self.config.policy.timeout if self.config.policy else 10.0
         try:
             factory = smtplib.SMTP_SSL if options.get("ssl") else smtplib.SMTP

{expr_tracker-0.2.1 → expr_tracker-0.2.2}/src/expr_tracker/alerts/backends/base.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import html
 import json
 import urllib.error
 import urllib.parse
@@ -85,7 +86,7 @@ def post_json(
 
 def render_text(message: AlertMessage, include_fields: bool = True) -> str:
     """Render a message as plain text for channels without rich cards."""
-    parts = [message.text]
+    parts = [message.subtitle, message.text] if message.subtitle else [message.text]
     if include_fields and message.fields:
         parts.append("")
         parts.extend(f"{key}: {value}" for key, value in message.fields.items())
@@ -97,6 +98,74 @@ def render_text(message: AlertMessage, include_fields: bool = True) -> str:
     return "\n".join(parts)
 
 
+LEVEL_COLORS = {
+    "debug": "#616161",
+    "info": "#0288d1",
+    "warning": "#ed6c02",
+    "error": "#d32f2f",
+    "critical": "#b71c1c",
+}
+
+
+def render_html(message: AlertMessage) -> str:
+    """Render a message as self-contained HTML for email.
+
+    Everything is inline-styled and table-based: mail clients strip stylesheets,
+    and several of them ignore ``div`` layout entirely.
+    """
+    color = LEVEL_COLORS.get(message.level.value, "#616161")
+    esc = html.escape
+    rows = "".join(
+        f'<tr><td style="padding:4px 12px 4px 0;color:#666;'
+        f'white-space:nowrap;vertical-align:top">{esc(str(key))}</td>'
+        f'<td style="padding:4px 0;color:#111">{esc(str(value))}</td></tr>'
+        for key, value in message.fields.items()
+    )
+    blocks = [
+        f'<tr><td style="background:{color};padding:14px 20px;color:#fff">'
+        f'<div style="font-size:17px;font-weight:600">{esc(message.title)}</div>'
+        f'<div style="font-size:12px;opacity:.85;text-transform:uppercase;'
+        f'letter-spacing:.05em">{esc(message.level.value)}'
+        + (f" &middot; {esc(message.subtitle)}" if message.subtitle else "")
+        + "</div></td></tr>"
+    ]
+    if message.text:
+        blocks.append(
+            '<tr><td style="padding:18px 20px 0;font-size:14px;line-height:1.5;'
+            f'color:#111">{esc(message.text)}</td></tr>'
+        )
+    if rows:
+        blocks.append(
+            '<tr><td style="padding:16px 20px 0"><table cellpadding="0" '
+            f'cellspacing="0" style="font-size:13px">{rows}</table></td></tr>'
+        )
+    if message.traceback:
+        blocks.append(
+            '<tr><td style="padding:16px 20px 0"><pre style="margin:0;padding:12px;'
+            "background:#f6f6f6;border-radius:4px;font-size:12px;overflow:auto;"
+            f'white-space:pre-wrap">{esc(message.traceback)}</pre></td></tr>'
+        )
+    if message.link:
+        link = esc(message.link)
+        blocks.append(
+            f'<tr><td style="padding:18px 20px 0"><a href="{link}" '
+            f'style="display:inline-block;padding:8px 16px;background:{color};'
+            'color:#fff;text-decoration:none;border-radius:4px;font-size:13px">'
+            "Open run</a></td></tr>"
+        )
+    blocks.append('<tr><td style="padding:20px"></td></tr>')
+    return (
+        '<html><body style="margin:0;background:#f4f4f4;'
+        'font-family:-apple-system,Segoe UI,Roboto,Helvetica,Arial,sans-serif">'
+        '<table cellpadding="0" cellspacing="0" width="100%" '
+        'style="background:#f4f4f4;padding:24px 0"><tr><td align="center">'
+        '<table cellpadding="0" cellspacing="0" width="520" '
+        'style="background:#fff;border-radius:6px;overflow:hidden;max-width:520px">'
+        + "".join(blocks)
+        + "</table></td></tr></table></body></html>"
+    )
+
+
 def _parse_retry_after(value) -> float | None:
     try:
         return float(value)

{expr_tracker-0.2.1 → expr_tracker-0.2.2}/src/expr_tracker/alerts/engine.py

@@ -209,7 +209,12 @@ class AlertEngine:
         except Exception as e:  # pragma: no cover - format_map already tolerates gaps
             logger.warning(f"Failed to render message for rule {rule.name!r}: {e}")
             rendered = rule.condition
-        title = _format(rule.title, values) if rule.title else rule.name
+        if rule.title:
+            title = _format(rule.title, values)
+        else:
+            # An auto-generated name is a hash; the condition says far more,
+            # especially as an email subject line
+            title = rule.condition if getattr(rule, "auto_named", False) else rule.name
         level = AlertLevel.INFO if recovered else rule.level
         message = AlertMessage(
             title=f"[recovered] {title}" if recovered else title,

{expr_tracker-0.2.1 → expr_tracker-0.2.2}/src/expr_tracker/alerts/models.py

@@ -230,6 +230,9 @@ class AlertRule:
                 f"Unknown alert rule mode {self.mode!r}; use 'edge' or 'level'."
             )
         self.for_steps = max(1, int(self.for_steps))
+        # A generated name identifies the rule but reads badly as a headline, so
+        # remember whether the user chose it. Not a field: it stays out of to_dict().
+        self.auto_named = not self.name
         if not self.name:
             self.name = f"rule_{self._auto_digest()}"
         if not self.message:

{expr_tracker-0.2.1 → expr_tracker-0.2.2}/tests/test_alert_backends.py

@@ -1,5 +1,6 @@
 """Channel payload construction and HTTP error mapping."""
 
+import json
 import urllib.error
 import urllib.request
 
@@ -8,7 +9,7 @@ import pytest
 from expr_tracker.alerts import backends as backend_module
 from expr_tracker.alerts.backends import create_backend
 from expr_tracker.alerts.backends.base import SendError, post_json
-from expr_tracker.alerts.models import AlertMessage, ChannelConfig
+from expr_tracker.alerts.models import AlertLevel, AlertMessage, ChannelConfig
 
 
 @pytest.fixture
@@ -179,3 +180,180 @@ def test_email_backend_sends(monkeypatch):
     assert mail["Subject"] == "[error] Title"
     assert mail["To"] == "a@b.c"
     assert "tls" in sent
+
+
+# ---------------------------------------------------------------------- subtitle
+
+
+def test_the_subtitle_reaches_the_rendered_text():
+    """Every channel but Lark renders through render_text, which used to drop it."""
+    from expr_tracker.alerts.backends.base import render_text
+
+    message = AlertMessage(
+        title="T", text="body", subtitle="run-42", level=AlertLevel.INFO
+    )
+    rendered = render_text(message)
+    assert "run-42" in rendered
+    assert rendered.startswith("run-42")  # context first, then the body
+
+
+def test_a_message_without_a_subtitle_is_unchanged():
+    from expr_tracker.alerts.backends.base import render_text
+
+    assert render_text(AlertMessage(title="T", text="body")) == "body"
+
+
+@pytest.mark.parametrize("backend_type", ["slack", "dingtalk", "wecom"])
+def test_text_channels_carry_the_subtitle(captured, backend_type):
+    backend = create_backend(
+        ChannelConfig(type=backend_type, name="c", url="https://hook.test/x")
+    )
+    backend.send(
+        AlertMessage(title="T", text="body", subtitle="run-42", level=AlertLevel.ERROR)
+    )
+    assert "run-42" in json.dumps(captured[-1])
+
+
+# ---------------------------------------------------------------------- html mail
+
+
+def sent_mail(monkeypatch, message, **options):
+    """Send through the real EmailBackend with SMTP stubbed out."""
+    import smtplib
+
+    box = {}
+
+    class FakeSMTP:
+        def __init__(self, *args, **kwargs):
+            pass
+
+        def __enter__(self):
+            return self
+
+        def __exit__(self, *args):
+            return False
+
+        def starttls(self):
+            box["tls"] = True
+
+        def login(self, user, password):
+            box["login"] = (user, password)
+
+        def send_message(self, mail):
+            box["mail"] = mail
+
+    monkeypatch.setattr(smtplib, "SMTP", FakeSMTP)
+    monkeypatch.setattr(smtplib, "SMTP_SSL", FakeSMTP)
+    backend = create_backend(
+        ChannelConfig(
+            type="email",
+            name="m",
+            options={"host": "smtp.test", "to": "a@b.c", **options},
+        )
+    )
+    backend.send(message)
+    return box
+
+
+def test_email_is_multipart_with_a_text_fallback(monkeypatch):
+    box = sent_mail(monkeypatch, AlertMessage(title="T", text="body"))
+    mail = box["mail"]
+    assert mail.is_multipart()
+    assert [p.get_content_type() for p in mail.walk()] == [
+        "multipart/alternative",
+        "text/plain",
+        "text/html",
+    ]
+
+
+def test_the_plain_part_carries_the_title_and_body(monkeypatch):
+    message = AlertMessage(
+        title="Loss spike", text="diverged", subtitle="run-42", fields={"step": 3}
+    )
+    box = sent_mail(monkeypatch, message)
+    text = box["mail"].get_body(("plain",)).get_content()
+    assert "Loss spike" in text and "diverged" in text
+    assert "run-42" in text and "step: 3" in text
+
+
+def test_the_html_part_carries_everything(monkeypatch):
+    message = AlertMessage(
+        title="Loss spike",
+        text="diverged",
+        subtitle="run-42",
+        level=AlertLevel.ERROR,
+        fields={"step": 3, "loss": 8.42},
+        link="https://example.test/run",
+        traceback="Traceback: demo",
+    )
+    box = sent_mail(monkeypatch, message)
+    body = box["mail"].get_body(("html",)).get_content()
+    for fragment in (
+        "Loss spike",
+        "run-42",
+        "diverged",
+        "step",
+        "8.42",
+        "https://example.test/run",
+        "Traceback: demo",
+        "error",
+    ):
+        assert fragment in body, fragment
+
+
+@pytest.mark.parametrize(
+    ("level", "color"),
+    [
+        ("info", "#0288d1"),
+        ("warning", "#ed6c02"),
+        ("error", "#d32f2f"),
+        ("critical", "#b71c1c"),
+    ],
+)
+def test_the_html_header_is_coloured_by_severity(monkeypatch, level, color):
+    box = sent_mail(
+        monkeypatch, AlertMessage(title="T", text="b", level=AlertLevel.parse(level))
+    )
+    assert color in box["mail"].get_body(("html",)).get_content()
+
+
+def test_html_content_is_escaped(monkeypatch):
+    """A metric name or message must never inject markup into the mail."""
+    message = AlertMessage(
+        title="<script>alert(1)</script>",
+        text="a & b < c",
+        fields={"<k>": "<v>"},
+    )
+    box = sent_mail(monkeypatch, message)
+    body = box["mail"].get_body(("html",)).get_content()
+    assert "<script>" not in body
+    assert "&lt;script&gt;" in body and "a &amp; b &lt; c" in body
+    assert "&lt;k&gt;" in body and "&lt;v&gt;" in body
+
+
+def test_html_can_be_switched_off(monkeypatch):
+    box = sent_mail(monkeypatch, AlertMessage(title="T", text="b"), html=False)
+    mail = box["mail"]
+    assert not mail.is_multipart()
+    assert mail.get_content_type() == "text/plain"
+
+
+def test_the_smtp_session_uses_the_configured_options(monkeypatch):
+    box = sent_mail(
+        monkeypatch,
+        AlertMessage(title="T", text="b"),
+        tls=True,
+        user="me@x.y",
+        password="secret",
+        sender="from@x.y",
+    )
+    assert box["tls"] is True
+    assert box["login"] == ("me@x.y", "secret")
+    assert box["mail"]["From"] == "from@x.y"
+
+
+def test_several_recipients(monkeypatch):
+    box = sent_mail(
+        monkeypatch, AlertMessage(title="T", text="b"), to=["a@x.y", "b@x.y"]
+    )
+    assert box["mail"]["To"] == "a@x.y, b@x.y"

{expr_tracker-0.2.1 → expr_tracker-0.2.2}/tests/test_rule_lifecycle.py

@@ -451,3 +451,34 @@ def test_a_metric_that_appears_late_is_not_a_typo(run):
     assert not next(iter(instance.info()["alerts"]["rules"].values()))[
         "unresolved_metrics"
     ]
+
+
+# ------------------------------------------------------------------ headlines
+
+
+def test_an_unnamed_rule_is_headlined_by_its_condition(run):
+    """A generated name is a hash, which reads badly as an email subject."""
+    instance, received = run(["isnan(loss) => critical: diverged"])
+    instance.log({"loss": float("nan")})
+    assert received[0].title == "isnan(loss)"
+
+
+def test_a_named_rule_is_headlined_by_its_name(run):
+    instance, received = run([{"condition": "loss > 1", "name": "loss_high"}])
+    instance.log({"loss": 5.0})
+    assert received[0].title == "loss_high"
+
+
+def test_an_explicit_title_wins_and_is_templated(run):
+    instance, received = run([{"condition": "loss > 1", "title": "Spike @ {step}"}])
+    instance.log({"loss": 5.0}, step=7, commit=True)
+    assert received[0].title == "Spike @ 7"
+
+
+def test_the_auto_named_flag_is_not_serialised():
+    import dataclasses
+
+    rule = AlertRule(condition="loss > 1")
+    assert rule.auto_named is True
+    assert "auto_named" not in dataclasses.asdict(rule)
+    assert AlertRule(condition="loss > 1", name="mine").auto_named is False

expr_tracker-0.2.1/outputs/hello/test/metrics.jsonl

@@ -1,5 +0,0 @@
-{"_step": 0, "_time": 1785984521.3747878, "val/loss": 10, "train/loss": 20}
-{"_step": 1, "_time": 1785984578.8073661, "val/loss": 10, "train/loss": 25}
-{"_step": 2, "_time": 1785984751.5897822, "val/loss": 10, "train/loss": 25}
-{"_step": 3, "_time": 1785984760.5739543, "val/loss": 10, "train/loss": 25}
-{"_step": 4, "_time": 1785984823.973783, "train": 30, "loss": 1}

expr_tracker-0.2.1/outputs/hello/test/metrics.meta.json

@@ -1 +0,0 @@
-{"schema": 2, "size": 369, "lines": 5, "last_step": 4, "max_step": 4, "sorted": true, "has_duplicate_steps": false, "index": [[0, 0, 0]], "run": {"project": "hello", "name": "test", "started_at": 1785984737.2126129}}

expr_tracker-0.2.1/outputs/hello/test/summary.json

@@ -1,6 +0,0 @@
-{
-  "val/loss": 10,
-  "train/loss": 25,
-  "train": 30,
-  "loss": 1
-}