utils/holds
Krzysztof kuhy Rudnicki c75f6310b0
Some checks are pending
app_errors tests / test (push) Waiting to run
crdt-sync pre-commit / pre-commit (push) Waiting to run
crdt-sync tests / test (push) Waiting to run
earned_time pre-commit / pre-commit (push) Waiting to run
earned_time tests / test (push) Waiting to run
file length / file-length (push) Waiting to run
focus-project pre-commit / pre-commit (push) Waiting to run
focus-project tests / test (push) Waiting to run
freedays pre-commit / pre-commit (push) Waiting to run
freedays tests / test (push) Waiting to run
game_recording pre-commit / pre-commit (push) Waiting to run
game_recording tests / test (push) Waiting to run
gatelock pre-commit / pre-commit (push) Waiting to run
gatelock tests / test (push) Waiting to run
holds pre-commit / pre-commit (push) Waiting to run
holds tests / test (push) Waiting to run
leetcode-coach pre-commit / pre-commit (push) Waiting to run
leetcode-coach tests / test (push) Waiting to run
md-naming / markdown naming convention (push) Waiting to run
music_theory tests / test (push) Waiting to run
omniroute_offload pre-commit / pre-commit (push) Waiting to run
palette drift / palette (push) Waiting to run
repo-contract / repo contract (push) Waiting to run
shared gate tests / gate unit tests (push) Waiting to run
sickdays pre-commit / pre-commit (push) Waiting to run
sickdays tests / test (push) Waiting to run
sql-drills pre-commit / pre-commit (push) Waiting to run
sql-drills tests / test (push) Waiting to run
get rid of github ci/cd version check of package…
Todo: 2556952d
2026-11-19 18:11:07 +01:00
..
holds holds 0.1.0: declared time-boxed holds 2026-11-03 20:25:10 +01:00
.pre-commit-config.yaml pylint 4.1.4, one job; focus_project deps 2026-11-16 08:58:01 +01:00
install.sh holds 0.1.0: declared time-boxed holds 2026-11-03 20:25:10 +01:00
pyproject.toml holds 0.1.0: declared time-boxed holds 2026-11-03 20:25:10 +01:00
README.md holds 0.1.0: declared time-boxed holds 2026-11-03 20:25:10 +01:00
requirements.txt get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00

holds

Declared time-boxed holds (contract v1): while a hold is active every gate (focus-guard, diet-guard, screen-locker prompts) stands down so the PC stays usable, e.g. for a proctored test. Stdlib only; gates import it from the system python.

import holds

holds.active(now=None)        # Hold | None  (corrupt file -> None, logged: fail closed)
holds.covers("diet-guard")    # bool; v1: every gate
holds.next_change(now=None)   # datetime | None: active hold's end, else next start
holds.add(start, end, "reason of 10+ chars")   # raises HoldsError on a ratchet breach
holds.remove(hold_id)         # only before it starts

Ratchet (R11): each hold <= 15 h, <= 3 per ISO week (by start), start >= now + 30 min, reason >= 10 chars, no overlaps, whole-minute times, existing holds are never edited. Data: $HOLDS_DATA or ~/.local/share/holds/holds.json, local naive times. Install: ./install.sh (editable, /usr/bin/python3). Tests: python3 -m pytest.