mirror of
https://github.com/kuhyx/diet-guard.git
synced 2026-11-11 13:07:40 +01:00
Krzysztof kuhy Rudnicki
419ada929a
due_slots() returns nothing on a sick day, like a free day: no lock, no debt; logging still works. Unreadable pool reads as not sick (fail closed). Pins sickdays-v0.1.0 and freedays-v0.4.0 (pyproject, requirements, pylint hook env). Phone gap documented in docs/DOCS-sick-days.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Xfj1sxKH9VBPqpcAni8Jry
91 lines
3.4 KiB
Python
91 lines
3.4 KiB
Python
"""Decision logic for the diet_guard slot-based log-to-unlock gate.
|
|
|
|
This module is GUI-free and side-effect-free so the lock/no-lock decision can
|
|
be verified headlessly: the fullscreen window in ``_gatelock.py`` is only a
|
|
thin shell around :func:`gate_is_due` and :func:`due_slots`. It composes the
|
|
pure slot arithmetic in :mod:`diet_guard._slots` with the logged-slot
|
|
state in :mod:`diet_guard._state`; ``now`` is injectable so the
|
|
time-of-day rules stay deterministically testable.
|
|
|
|
The gate fires when any *elapsed* meal slot for today carries no logged meal.
|
|
Coming home late therefore surfaces several unlogged slots at once -- a single
|
|
lock that backfills the whole day before the PC is usable -- while a normal day
|
|
prompts one slot at a time, with no separate weekday code path.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import TYPE_CHECKING
|
|
|
|
import freedays
|
|
import sickdays
|
|
|
|
from diet_guard._meal_schedule_store import current_schedule
|
|
from diet_guard._slots import missing_slots, slot_label
|
|
from diet_guard._state import (
|
|
now_local,
|
|
)
|
|
from diet_guard._state_today import (
|
|
logged_slots_today,
|
|
)
|
|
|
|
if TYPE_CHECKING:
|
|
from datetime import datetime
|
|
|
|
|
|
def due_slots(now: datetime | None = None) -> tuple[int, ...]:
|
|
"""Return today's elapsed-but-unlogged meal slots, ascending.
|
|
|
|
Args:
|
|
now: Reference time (defaults to the current local time); injectable.
|
|
|
|
Returns:
|
|
The slot minutes that still need a meal logged (empty == nothing due).
|
|
|
|
Empty on a shared free day or a sick day, whatever the schedule says: the
|
|
gate stands down, so no lock opens and nothing accrues -- unlogged meals
|
|
leave no debt, and logging a meal still works as on any day. Each pool is
|
|
read from a single local file and never the network, so this cannot hang
|
|
the systemd-fired gate, and an unreadable pool reads as "not free" / "not
|
|
sick" -- the normal rules apply rather than the gate switching itself off.
|
|
"""
|
|
reference = now if now is not None else now_local()
|
|
day = reference.date()
|
|
if freedays.is_free_day(day) or sickdays.is_sick_day(day):
|
|
return ()
|
|
# One schedule for both halves: snapping the log onto a different schedule
|
|
# than the one deriving the due slots would leave a logged meal covering a
|
|
# checkpoint that is not on the list -- and the real one nagging.
|
|
schedule = current_schedule()
|
|
return missing_slots(reference, logged_slots_today(schedule), schedule)
|
|
|
|
|
|
def gate_is_due(now: datetime | None = None) -> bool:
|
|
"""Return True if the screen should lock until the missing slots are filled.
|
|
|
|
Args:
|
|
now: Reference time (defaults to the current local time); injectable.
|
|
|
|
Returns:
|
|
True if at least one elapsed slot today is unlogged, else False.
|
|
"""
|
|
return bool(due_slots(now))
|
|
|
|
|
|
def gate_message(now: datetime | None = None) -> str:
|
|
"""Return the lock-screen reason line listing the slots to backfill.
|
|
|
|
Args:
|
|
now: Reference time (defaults to the current local time); injectable.
|
|
|
|
Returns:
|
|
A short human-readable explanation of which meals are missing.
|
|
"""
|
|
missing = due_slots(now)
|
|
if not missing:
|
|
return "All meals are logged. You're up to date."
|
|
labels = ", ".join(slot_label(slot) for slot in missing)
|
|
if len(missing) == 1:
|
|
return f"Log your {labels} meal to unlock."
|
|
return f"Log your meals for {labels} to unlock."
|