testsAndMisc/python_pkg/diet_guard/tests/test_gate.py
Krzysztof kuhy Rudnicki 31992b2a90 feat(diet_guard): add meal-logging screen-lock gate with trigger fix
Add the diet_guard package: a screen-locking meal-logging gate that fires
on 4-hour slots (08/12/16/20) and records calories/macros, persisting an
autocompleting food bank.

- Trigger fix: the systemd timer fires at session start (Persistent=true)
  before lightdm has written ~/.Xauthority, so the gate crashed with a
  TclError instead of locking the screen. Add wait_for_display() /
  _display_is_ready() in _gatelock.py and wire it into _cli._cmd_gate so the
  gate retries on the next tick instead of crashing; add
  Environment=XAUTHORITY=%h/.Xauthority to the service as belt-and-suspenders.
- Food-bank hardening: a transiently corrupt food_bank.json was warned about
  on every keystroke and then silently overwritten (data loss). _read_bank
  now quarantines it via _quarantine_corrupt_bank() (warn-once + timestamped
  backup) before starting fresh.
- Multi-item meals: new _meal.py (MealItem, meal_total, MEAL_SOURCE),
  remember_meal() + _upsert() in _foodbank.py, and a "+ Add item" control in
  the gate that logs both the individual items and the composite meal.
- Bundle resolve_nutrition's manual macros into a ManualMacros dataclass to
  stay within the argument-count limit.

diet_guard at 100% branch coverage; full pre-commit suite passes.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-10 22:32:39 +02:00

80 lines
2.5 KiB
Python

"""Tests for _gate.py — the slot/state composition that decides locking.
The slot arithmetic and the logged-slot state are both exercised elsewhere, so
here the logged set is mocked and ``now`` is injected to drive each decision.
"""
from __future__ import annotations
from datetime import datetime, timezone
from unittest.mock import patch
from python_pkg.diet_guard._gate import due_slots, gate_is_due, gate_message
def _at(hour: int) -> datetime:
"""Return a fixed local datetime at ``hour``."""
return datetime(2026, 1, 1, hour, 0, tzinfo=timezone.utc)
def _logged(slots: set[int]) -> object:
"""Patch the logged-slots source so the decision is deterministic."""
return patch(
"python_pkg.diet_guard._gate.logged_slots_today",
return_value=slots,
)
class TestDueSlots:
"""Elapsed-but-unlogged slots."""
def test_injected_now(self) -> None:
"""With 08:00 logged at 13:00, only 12:00 is due."""
with _logged({8}):
assert due_slots(_at(13)) == (12,)
def test_default_now_uses_clock(self) -> None:
"""Omitting ``now`` reads the real clock (mocked here for determinism)."""
with (
_logged(set()),
patch(
"python_pkg.diet_guard._gate.now_local",
return_value=_at(9),
),
):
assert due_slots() == (8,)
class TestGateIsDue:
"""The boolean lock decision."""
def test_due_when_a_slot_is_missing(self) -> None:
"""A missing elapsed slot warrants a lock."""
with _logged(set()):
assert gate_is_due(_at(13)) is True
def test_not_due_when_all_logged(self) -> None:
"""Everything elapsed is logged -> no lock."""
with _logged({8, 12}):
assert gate_is_due(_at(13)) is False
class TestGateMessage:
"""The human-readable reason line."""
def test_all_logged(self) -> None:
"""Nothing missing -> the up-to-date message."""
with _logged({8, 12}):
assert "up to date" in gate_message(_at(13))
def test_single_missing(self) -> None:
"""One missing slot -> singular phrasing."""
with _logged({8}):
assert gate_message(_at(13)) == "Log your 12:00 meal to unlock."
def test_multiple_missing(self) -> None:
"""Several missing slots -> plural phrasing listing them."""
with _logged(set()):
message = gate_message(_at(17))
assert message == "Log your meals for 08:00, 12:00, 16:00 to unlock."