steam-backlog-enforcer/steam_backlog_enforcer/tests/test_shadow_log.py
Krzysztof kuhy Rudnicki 7721b8716e Group playtime shadow and budget breakdown fields
PlaytimeState keeps its shadow_* keys on disk through a ShadowLedger
group (flat, prefix shadow_); PlaytimeRules carries the per-earner split
in a BudgetBreakdown. The golden round-trip test still passes.

Todo: 9b9342ba

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 08:36:21 +01:00

76 lines
3.1 KiB
Python

"""Tests for the shadow verdict journal: one budget.jsonl record per change."""
from __future__ import annotations
import json
from steam_backlog_enforcer import _playtime_log as log_mod
from steam_backlog_enforcer._budget_log_tail import last_verdict
from steam_backlog_enforcer._playtime_log import BudgetLog
from steam_backlog_enforcer._playtime_record import ShadowLedger
from steam_backlog_enforcer._playtime_state import PlaytimeState
from steam_backlog_enforcer._shadow import ShadowVerdict
from steam_backlog_enforcer._shadow_log import EVENT_SHADOW_CHANGE, ShadowJournal
_STATE = PlaytimeState(
day_key="2026-10-19",
shadow=ShadowLedger(
seconds=30.0,
budget_seconds=36000.0,
per_source={"app:440": 30.0},
paused_seconds=6.0,
),
)
def _records() -> list[dict[str, object]]:
"""Return every record in the budget log, oldest first."""
text = log_mod.BUDGET_LOG_FILE.read_text(encoding="utf-8")
return [json.loads(line) for line in text.splitlines()]
def _journal() -> ShadowJournal:
"""Return a shadow journal writing to the production budget log."""
return ShadowJournal(BudgetLog(path=log_mod.BUDGET_LOG_FILE))
class TestShadowJournal:
"""The shadow journal writes one record per verdict change."""
def test_writes_on_change_only(self) -> None:
"""A repeated verdict is not written again."""
journal = _journal()
leisure = ShadowVerdict(paused_by=None, keys=("app:440",))
journal.observe(leisure, _STATE)
journal.observe(leisure, _STATE)
journal.observe(ShadowVerdict(paused_by="i3lock", keys=()), _STATE)
records = _records()
assert [r["shadow_state"] for r in records] == ["leisure", "paused"]
assert {r["event"] for r in records} == {EVENT_SHADOW_CHANGE}
def test_a_new_source_is_a_change(self) -> None:
"""A different source set counts as a change."""
journal = _journal()
journal.observe(ShadowVerdict(None, ("a",)), _STATE)
journal.observe(ShadowVerdict(None, ("b",)), _STATE)
assert [r["sources"] for r in _records()] == [["a"], ["b"]]
def test_carries_the_shadow_fields(self) -> None:
"""Each record carries the shadow budget fields."""
_journal().observe(ShadowVerdict(None, ("app:440",)), _STATE)
record = _records()[0]
assert record["day_key"] == "2026-10-19"
assert record["shadow_seconds"] == 30.0
assert record["shadow_budget_seconds"] == 36000.0
assert record["shadow_remaining_seconds"] == 35970.0
assert record["shadow_paused_seconds"] == 6.0
assert record["shadow_per_source"] == {"app:440": 30.0}
assert record["paused_by"] is None
def test_live_status_skips_shadow_records(self) -> None:
"""The web UI's live game view reads the last *game* verdict."""
log = BudgetLog(path=log_mod.BUDGET_LOG_FILE)
log.record("verdict_change", state="engaged", qualifying=[])
ShadowJournal(log).observe(ShadowVerdict(None, ("a",)), _STATE)
assert last_verdict(demo=False).state == "engaged"