testsAndMisc/python_pkg/phone_lease/_model.py
Krzysztof kuhy Rudnicki 24503e9197
Some checks are pending
md-naming / markdown naming convention (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (mypy, mypy) (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (pylint, pylint) (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (rest, ) (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (shellcheck, shellcheck) (push) Waiting to run
Python tests / test (push) Waiting to run
repo-contract / repo contract (push) Waiting to run
Shell tests / shell-tests (push) Waiting to run
Shell tests / lib-tests (push) Waiting to run
Shell tests / arch-tests (push) Waiting to run
phone_lease: fair FIFO queue; drop fix_waifu2x
Finish the queue left uncommitted on 2026-11-17: callers that find a
scope taken get a ticket and are granted in arrival order, dead
sessions are reaped at once. The CLI keeps exit 3 for a held scope.
fix_waifu2x.sh patched the CUDA waifu2x build, now uninstalled.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WzxdWV2U9cEtTMTf7iQWin
2026-11-21 11:50:32 +01:00

110 lines
3.5 KiB
Python

"""The lease file's records, its constants, and the errors ``acquire`` raises.
Split out of ``lease.py`` so the pure queue core (:mod:`._queue`) and the
file layer (:mod:`.lease`) share one definition without importing each other.
"""
from __future__ import annotations
from dataclasses import dataclass, field
import time
from typing import TYPE_CHECKING
if TYPE_CHECKING:
from collections.abc import Callable
@dataclass(frozen=True)
class Clock:
"""The two things ``acquire`` needs from ``time``; tests hand in fakes."""
now: Callable[[], float] = time.time
sleep: Callable[[float], None] = time.sleep
# Seconds a lease outlives its last refresh; a quiet session frees the phone.
DEFAULT_TTL = 180.0
# Seconds ``acquire`` waits in the queue before answering "queued, retry".
# Every Claude tool call is capped at 60 s, so a wait must end well before.
DEFAULT_WAIT = 50.0
# A whole-phone hold stops everyone else: 30 s from its first grant, however
# often the holder refreshes it.
WHOLE_PHONE_MAX_TTL = 30.0
# Seconds a queue ticket survives its owner's last attempt, so a caller that
# got "queued" and reruns the same command keeps its place in line.
TICKET_TTL = 90.0
# Exit code for "queued, retry": EX_TEMPFAIL from sysexits.h.
QUEUED_EXIT = 75
SCREEN = "__screen__"
WHOLE_PHONE = "whole-phone"
class PhoneBusyError(RuntimeError):
"""Raised when a fresh, conflicting lease belongs to another owner."""
class PhoneQueuedError(PhoneBusyError):
"""The wait ran out with the caller still in line; its ticket is kept."""
def __init__(self, message: str, *, position: int, number: int) -> None:
"""Keep the place in line next to the message."""
super().__init__(message)
self.position = position
self.number = number
def conflicts(scope: str, other: str) -> bool:
"""Whether two owners may not hold ``scope`` and ``other`` at once."""
return WHOLE_PHONE in (scope, other) or scope == other
@dataclass(frozen=True)
class Lease:
"""One entry of the lease file."""
serial: str
owner: str
expires: float
note: str
scope: str = f"pkg:{SCREEN}"
cleanup: tuple[str, ...] = field(default_factory=tuple)
def is_expired(self, now: float) -> bool:
"""True once ``now`` has passed the expiry."""
return now >= self.expires
def conflicts_with(self, owner: str, scope: str) -> bool:
"""Whether this lease stops ``owner`` from taking ``scope``."""
return self.owner != owner and conflicts(self.scope, scope)
def describe(self) -> str:
"""One line for an error or a status readout."""
until = time.strftime("%H:%M:%S", time.localtime(self.expires))
what = "" if self.scope == f"pkg:{SCREEN}" else f" [{self.scope}]"
return (
f"phone {self.serial}{what} held by {self.owner} ({self.note}) "
f"until {until}"
)
@dataclass(frozen=True)
class Ticket:
"""One caller waiting in line for a scope; ``number`` orders the line."""
owner: str
scope: str
number: int
seen: float
note: str = ""
def describe(self) -> str:
"""One line for an error or a status readout."""
return f"queued #{self.number} {self.owner} [{self.scope}] ({self.note})"
def scope_of(package: str | None = None, *, whole_phone: bool = False) -> str:
"""The scope string for a package, the whole phone, or the real screen."""
if whole_phone:
return WHOLE_PHONE
return f"pkg:{package or SCREEN}"