mirror of
https://github.com/kuhyx/wake-alarm.git
synced 2026-11-10 18:07:05 +01:00
Krzysztof kuhy Rudnicki
c1dbdcda22
`requires-python` and the CI pin already said 3.14, but ruff, mypy and pylint were still grading against 3.10/3.11 -- three tools judging an interpreter nothing runs any more, and ruff withholding the pyupgrade fixes that only become safe at the newer target. `pin_ci_python.py` rewrites these three knobs. What the stale target was hiding: `datetime.timezone.utc` where `datetime.UTC` is now correct (UP017), `socket.timeout` where `TimeoutError` is (UP041), and ruff's stable formatter applying PEP 758 -- `except (A, B):` becomes `except A, B:`. That makes the source 3.14-only at the syntax level, which is what `requires-python = ">=3.14"` already promised; kuhy chose it deliberately over holding ruff a release back (2026-08-29). ruff, ruff-format, mypy --strict and pylint all clean at the new target. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SfnJmxxsZ534AKk16rC2Gr
82 lines
2.5 KiB
Python
82 lines
2.5 KiB
Python
"""Decide whether the alarm should run, and parse its CLI.
|
|
|
|
Split out of ``_alarm.py`` so the gate is testable without constructing a
|
|
window, and to keep that module under the 250-line cap.
|
|
|
|
Note ``_should_run_alarm`` has deliberately **no time gate**: the trigger owns
|
|
"is it time?", and this owns "should it run at all today?". That separation is
|
|
why ``wake-alarm.service`` must never get an ``[Install]`` section -- with no
|
|
time gate, a ``WantedBy=`` would fire the alarm at login.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
from datetime import UTC, datetime
|
|
import logging
|
|
|
|
from wake_alarm._constants import ALARM_DAYS
|
|
from wake_alarm._state import was_alarm_dismissed_today, was_workout_logged_today
|
|
|
|
_logger = logging.getLogger(__name__)
|
|
|
|
|
|
def is_alarm_day(*, now: datetime | None = None) -> bool:
|
|
"""Report whether today is configured as an alarm day.
|
|
|
|
Args:
|
|
now: Instant to test; defaults to the current local time.
|
|
|
|
Returns:
|
|
True when today's weekday is in ``ALARM_DAYS``.
|
|
"""
|
|
moment = now if now is not None else datetime.now(tz=UTC).astimezone()
|
|
return moment.weekday() in ALARM_DAYS
|
|
|
|
|
|
def should_run_alarm() -> bool:
|
|
"""Decide whether the alarm should sound at all today.
|
|
|
|
Returns:
|
|
True unless today is not an alarm day, the alarm was already
|
|
dismissed, or the workout was already logged.
|
|
"""
|
|
if not is_alarm_day():
|
|
_logger.info("Not an alarm day. Exiting.")
|
|
return False
|
|
if was_alarm_dismissed_today():
|
|
_logger.info("Alarm already dismissed today. Exiting.")
|
|
return False
|
|
if was_workout_logged_today():
|
|
_logger.info("Workout already logged today. Skipping alarm.")
|
|
return False
|
|
return True
|
|
|
|
|
|
def parse_args(argv: list[str]) -> argparse.Namespace:
|
|
"""Parse CLI arguments for the alarm daemon.
|
|
|
|
Args:
|
|
argv: Argument list without the program name.
|
|
|
|
Returns:
|
|
The parsed namespace.
|
|
"""
|
|
parser = argparse.ArgumentParser(description="Wake alarm daemon.")
|
|
parser.add_argument(
|
|
"--production",
|
|
action="store_true",
|
|
help="Production mode (default; kept for systemd compatibility).",
|
|
)
|
|
parser.add_argument(
|
|
"--demo",
|
|
action="store_true",
|
|
help="Run with a smaller window and shorter timers.",
|
|
)
|
|
parser.add_argument(
|
|
"--trigger-now",
|
|
action="store_true",
|
|
help="Bypass the day/dismiss gate and fire the alarm immediately.",
|
|
)
|
|
return parser.parse_args(argv)
|