aiuse 3.2.1__tar.gz → 3.2.2__tar.gz

{aiuse-3.2.1/src/aiuse.egg-info → aiuse-3.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiuse
-Version: 3.2.1
+Version: 3.2.2
 Summary: Aggregate AI subscription/API usage and flag use-it-or-lose-it allotments
 Author: djbclark
 License-Expression: MIT

{aiuse-3.2.1 → aiuse-3.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aiuse"
-version = "3.2.1"
+version = "3.2.2"
 description = "Aggregate AI subscription/API usage and flag use-it-or-lose-it allotments"
 readme = "README.md"
 requires-python = ">=3.11"

{aiuse-3.2.1 → aiuse-3.2.2}/src/aiuse/__init__.py

@@ -1,3 +1,3 @@
 """Aggregate provider quotas and flag use-it-or-lose-it allotments."""
 
-__version__ = "3.2.1"
+__version__ = "3.2.2"

{aiuse-3.2.1 → aiuse-3.2.2}/src/aiuse/report.py

@@ -280,7 +280,7 @@ def render_report(
     lines.append(s.bold("=" * width))
     title = "AI USAGE — USE IT OR LOSE IT (full)"
     lines.append(s.bold(s.cyan(title)))
-    meta = f"Collected at {snapshot.collected_at.isoformat()}"
+    meta = f"Collected at {format_clock(snapshot.collected_at, date=True)}"
     meta += f" · {n_accounts} account{'s' if n_accounts != 1 else ''}"
     if n_actionable:
         meta += f" · {n_actionable} alert{'s' if n_actionable != 1 else ''}"
@@ -1703,6 +1703,14 @@ def _priority_account_line(
     return f"{_priority_tag(s, band)} {body}"
 
 
+def format_clock(when: datetime, *, seconds: bool = False, date: bool = False) -> str:
+    """Local 12-hour time as people say it: ``9:02pm``, ``9:02:07pm``, ``Sat Oct 5 9:02pm``."""
+    local = when.astimezone()
+    clock = f"{local.hour % 12 or 12}:{local:%M}" + (f":{local:%S}" if seconds else "")
+    clock += "am" if local.hour < 12 else "pm"
+    return f"{local:%a %b} {local.day} {clock}" if date else clock
+
+
 def render_stderr_meta(
     snapshot: Snapshot,
     alerts: list[UseOrLoseAlert],
@@ -1715,7 +1723,7 @@ def render_stderr_meta(
     n_accounts = len(accounts)
     n_actionable = sum(1 for a in alerts if a.urgency not in (Urgency.INFO, Urgency.NONE))
     lines: list[str] = []
-    meta = f"Collected at {snapshot.collected_at.isoformat()}"
+    meta = f"Collected at {format_clock(snapshot.collected_at, date=True)}"
     meta += f" · {n_accounts} account{'s' if n_accounts != 1 else ''}"
     if n_actionable:
         meta += f" · {n_actionable} alert{'s' if n_actionable != 1 else ''}"

{aiuse-3.2.1 → aiuse-3.2.2}/src/aiuse/watch.py

@@ -20,7 +20,7 @@ from aiuse.analysis.local_runtimes import maybe_local_runtime_alerts
 from aiuse.analysis.use_or_lose import analyze_use_or_lose
 from aiuse.collectors.runner import run_collectors
 from aiuse.models import Snapshot, UseOrLoseAlert, utcnow
-from aiuse.report import render_clock_matrix, render_stderr_meta
+from aiuse.report import _strip_ansi, format_clock, render_clock_matrix, render_stderr_meta
 
 DEFAULT_INTERVAL_S = 600.0
 MIN_INTERVAL_S = 5.0
@@ -188,10 +188,10 @@ def render_watch_board(
     """
     header_bits = ["aiuse watch"]
     if now is not None:
-        header_bits.append(f"now: {now.astimezone().strftime('%H:%M:%S')}")
+        header_bits.append(f"now: {format_clock(now, seconds=True)}")
     data_at = snapshot.collected_at if snapshot is not None else last_at
     if data_at is not None:
-        header_bits.append(f"last: {data_at.astimezone().strftime('%H:%M:%S')}")
+        header_bits.append(f"last: {format_clock(data_at, seconds=True)}")
     else:
         header_bits.append("last: —")
     if collecting_for is not None:
@@ -205,17 +205,21 @@ def render_watch_board(
         previous, due, tier = sample_schedule
         overdue = " (due)" if now is not None and due <= now else ""
         lines.append(
-            f"sampler: previous {previous.astimezone().strftime('%H:%M:%S')}"
-            f" · next {due.astimezone().strftime('%H:%M:%S')}{overdue} · {tier} tier"
+            f"sampler: previous {format_clock(previous, seconds=True)}"
+            f" · next {format_clock(due, seconds=True)}{overdue} · {tier} tier"
         )
     if error:
         lines.append(f"collect error: {error}")
     if snapshot is not None:
-        lines.append(render_clock_matrix(alerts, snapshot=snapshot, config=config, color=color).rstrip())
+        matrix = render_clock_matrix(alerts, snapshot=snapshot, config=config, color=color).rstrip()
+        lines.append(matrix)
         if not quiet:
             footer = render_stderr_meta(snapshot, alerts, color=color).rstrip()
             if footer:
-                lines.append(footer)
+                # Centered under the table, like the legend lines above it.
+                width = max((len(_strip_ansi(row)) for row in matrix.splitlines()), default=0)
+                for row in footer.splitlines():
+                    lines.append(" " * max(0, (width - len(_strip_ansi(row))) // 2) + row)
     else:
         lines.append("waiting for first collection…")
     return "\n".join(lines)

{aiuse-3.2.1 → aiuse-3.2.2/src/aiuse.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiuse
-Version: 3.2.1
+Version: 3.2.2
 Summary: Aggregate AI subscription/API usage and flag use-it-or-lose-it allotments
 Author: djbclark
 License-Expression: MIT

{aiuse-3.2.1 → aiuse-3.2.2}/tests/test_watch.py

@@ -344,6 +344,7 @@ def test_board_header_shows_now_data_time_and_the_sampler_schedule():
     from datetime import datetime, timedelta, timezone
 
     from aiuse import sampler
+    from aiuse.report import format_clock
     from aiuse.watch import render_watch_board
 
     snap = _snap()
@@ -356,7 +357,7 @@ def test_board_header_shows_now_data_time_and_the_sampler_schedule():
     header, sampler_line = board.splitlines()[:2]
 
     def hms(value):
-        return value.astimezone().strftime("%H:%M:%S")
+        return format_clock(value, seconds=True)
 
     assert f"now: {hms(now)}" in header and f"last: {hms(snap.collected_at)}" in header
     assert sampler_line == f"sampler: previous {hms(snap.collected_at)} · next {hms(schedule[1])} · active tier"
@@ -393,3 +394,27 @@ def test_watch_frame_overlays_newer_burst_samples_on_the_full_snapshot(monkeypat
     used = {a.provider: a.windows[0].used_percent for a in snapshot.accounts}
     assert used == {"clinepass": 47, "codex": 10}
     assert seen == [snapshot], "alerts are re-derived from the overlaid readings"
+
+
+def test_format_clock_is_twelve_hour_without_leading_zeros():
+    from datetime import datetime
+
+    from aiuse.report import format_clock
+
+    evening = datetime(2026, 10, 3, 21, 2, 7).astimezone()
+    assert format_clock(evening) == "9:02pm"
+    assert format_clock(evening, seconds=True) == "9:02:07pm"
+    assert format_clock(evening, date=True) == "Sat Oct 3 9:02pm"
+    assert format_clock(datetime(2026, 10, 3, 0, 5).astimezone()) == "12:05am"
+    assert format_clock(datetime(2026, 10, 3, 12, 0).astimezone()) == "12:00pm"
+
+
+def test_board_footer_is_centered_under_the_table():
+    from aiuse.watch import render_watch_board
+
+    rows = render_watch_board(_snap(), [], color=False).splitlines()
+    width = max(len(r) for r in rows[: rows.index(next(r for r in rows if "Collected at" in r))] if "watch" not in r)
+    meta = next(r for r in rows if "Collected at" in r)
+    left = len(meta) - len(meta.lstrip())
+    assert left == max(0, (width - len(meta.strip())) // 2)
+    assert "am ·" in meta or "pm ·" in meta