mirror of
https://github.com/kuhyx/wake-alarm.git
synced 2026-11-10 19:27:02 +01:00
Krzysztof kuhy Rudnicki
9e0cd123ff
Item 14: the fan ramp is gone entirely. It caused anxiety without helping anyone wake up. Deletes _max_fans/_restore_fans/_find_fan_hwmon, the _AlarmHardware.fan_state field, both call sites, and their tests. wake-alarm-fans.sh and its NOPASSWD sudoers entry come out in the install.sh pass -- dropping a passwordless root helper is a bonus. _alarm.py was 478 lines and the 250-line gate fires on any commit that stages it, so this carries the split it has owed for a while. New modules, each a real seam rather than an arbitrary cut: _gating should-it-run-today + CLI (no time gate; that is _trigger's) _beep_loop the sounding thread, now driving _escalation's planner _alarm_timers self-rescheduling challenge refresh / skip window (mixin) _alarm_state the progress + hardware dataclasses _rounds challenge presentation, re-exporting the view helpers _countdown skip-window arithmetic and demo/production intervals _dismiss_view the post-dismissal banner _screen_flash the ~1.3 Hz attention flash (kept under the 3 Hz threshold) _lock_setup gatelock config + arbiter claim _startup wake display, brightness, plug _tone tone synthesis and cache (out of _audio) _brightness xrandr brightness (was in _audio, never belonged there) main() deliberately stays in _alarm.py: morning_routine/_orchestrator.py:39 hardcodes "wake_alarm._alarm", and moving it is the exact mistake that caused a month-long silent production failure once already. Verified after the split that the module still resolves and accepts --production. Also fixes the plug pre-roll found while researching speakers: main() fired turn_on_plug() and the first beep in the same instant, so an amplifier's soft-start relay swallowed the opening of the alarm. PLUG_PREROLL_SECONDS=4 now sits between them. Two bugs found by running the code rather than by lint: - ruff stripped `struct` from the extracted _tone.py because the import landed before its first usage; only executing it caught the NameError. - test fixtures patched _play_on_all_sinks/_set_max_brightness at wake_alarm._alarm, which silently stopped intercepting once those moved. 404 tests, 100% branch coverage, no new noqa/type-ignore suppressions. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EckWmyfetYq3Mi8MAnUudh
49 lines
1.5 KiB
Python
49 lines
1.5 KiB
Python
"""Synthesise and cache the alarm tone.
|
|
|
|
Split out of ``_audio.py`` for the 250-line cap.
|
|
|
|
Note the pylint ``generated-members`` entries for ``wave.Wave_write`` in
|
|
pyproject.toml: pylint infers the read-mode overload of ``wave.open`` and
|
|
wrongly reports ``setnchannels`` and friends as missing. Keep them.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
import math
|
|
from pathlib import Path
|
|
import struct
|
|
import tempfile
|
|
import wave
|
|
|
|
_logger = logging.getLogger(__name__)
|
|
|
|
# Generated WAVs are reused for the life of the process.
|
|
_TONE_CACHE: dict[int, Path] = {}
|
|
_TONE_DURATION_SECONDS: float = 1.5
|
|
_TONE_FRAMERATE: int = 48000
|
|
_TONE_AMPLITUDE: int = 32760 # near s16 max for the loudest sine we can emit
|
|
|
|
|
|
def _ensure_tone_wav(frequency: int) -> Path:
|
|
"""Generate (and cache) a mono 48 kHz sine WAV at *frequency* Hz."""
|
|
cached = _TONE_CACHE.get(frequency)
|
|
if cached is not None and cached.exists():
|
|
return cached
|
|
path = Path(tempfile.gettempdir()) / f"wake_alarm_tone_{frequency}.wav"
|
|
n_frames = int(_TONE_FRAMERATE * _TONE_DURATION_SECONDS)
|
|
with wave.open(str(path), "wb") as wav:
|
|
wav.setnchannels(1)
|
|
wav.setsampwidth(2)
|
|
wav.setframerate(_TONE_FRAMERATE)
|
|
frames = bytearray()
|
|
for i in range(n_frames):
|
|
sample = int(
|
|
_TONE_AMPLITUDE
|
|
* math.sin(2 * math.pi * frequency * i / _TONE_FRAMERATE),
|
|
)
|
|
frames.extend(struct.pack("<h", sample))
|
|
wav.writeframesraw(bytes(frames))
|
|
_TONE_CACHE[frequency] = path
|
|
return path
|