mirror of
https://github.com/kuhyx/steam-backlog-enforcer.git
synced 2026-11-22 23:02:19 +01:00
GET /api/compat serves every installed game's compat-tool decision as rows from the installer's own code (steam_installer/compat_rows.py, the rows --map-installed now logs from), cached by file stats. The Library page gets a Proton map view (sortable, filterable, fuzzy search, hash state, 30 s poll) and a map-installed job: POST checks the ids, the phrase "map N games" and the game-running guard; the job re-checks them and streams --map-installed --apply --yes --appids. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WzxdWZCxnNWLtpVwFLVk9w
81 lines
3.0 KiB
Python
81 lines
3.0 KiB
Python
"""Typed-phrase friction shared by the CLI, the web job runner and the daemon.
|
|
|
|
One table, so a phrase cannot be strict in one front end and lax in another.
|
|
The phrase is checked wherever the action is actually carried out (the job
|
|
subprocess or the root daemon), never only in the browser: a check that
|
|
``curl`` can skip is decoration, not friction.
|
|
|
|
Templates use ``str.format`` fields; the caller supplies every field the
|
|
template names (``days``, ``minutes``, ``game_name``, ``count``, ``backup_id``).
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
from typing import Final
|
|
|
|
from steam_backlog_enforcer._store_window import DEFAULT_WINDOW_MINUTES
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class Friction:
|
|
"""The friction attached to one command.
|
|
|
|
Attributes:
|
|
phrase_template: Text the user must type, with ``{field}`` slots.
|
|
countdown_seconds: Armed wait with heartbeats before commit (0 = none).
|
|
"""
|
|
|
|
phrase_template: str
|
|
countdown_seconds: int = 0
|
|
|
|
|
|
GAMING_RESET_COUNTDOWN_SECONDS: Final = 300
|
|
|
|
_STORE_WINDOW_PHRASE: Final = "unblock the store for {minutes} minutes"
|
|
|
|
FRICTION: Final[dict[str, Friction]] = {
|
|
"gaming-reset": Friction(
|
|
"reset today's gaming budget", GAMING_RESET_COUNTDOWN_SECONDS
|
|
),
|
|
"block-gaming": Friction("block all gaming for {days} days"),
|
|
"unblock": Friction(_STORE_WINDOW_PHRASE),
|
|
# buy-dlc takes no params: it is always the default-length window, and the
|
|
# daemon checks it as an ``unblock`` of that length. So its phrase is that
|
|
# exact sentence with the number already in it, not a ``{minutes}`` slot
|
|
# that nothing could fill.
|
|
"buy-dlc": Friction(_STORE_WINDOW_PHRASE.format(minutes=DEFAULT_WINDOW_MINUTES)),
|
|
"gaming-unblock": Friction("force release playtime mounts"),
|
|
"abandon-pick": Friction("abandon {game_name}"),
|
|
"pick-manual": Friction("lock in {game_name}"),
|
|
"add-exception": Friction("request exception for {game_name}"),
|
|
"uninstall": Friction("uninstall {count} games"),
|
|
"reset": Friction("wipe all enforcer state"),
|
|
"restore-backup": Friction("restore backup {backup_id}"),
|
|
# Checked at POST /api/jobs too (_web_jobs._PRECHECKED), then again by the job.
|
|
"repair-ghosts": Friction("delete ghost manifests"),
|
|
# appid_count, not count: the UI fills ``count`` with the uninstall count.
|
|
"map-installed": Friction("map {appid_count} games"),
|
|
}
|
|
|
|
|
|
def expected_phrase(command: str, **fields: object) -> str | None:
|
|
"""Return the exact phrase *command* requires, or ``None`` if it has none.
|
|
|
|
Raises:
|
|
KeyError: If the template names a field missing from *fields*.
|
|
"""
|
|
friction = FRICTION.get(command)
|
|
if friction is None:
|
|
return None
|
|
return friction.phrase_template.format(**fields)
|
|
|
|
|
|
def phrase_matches(expected: str, typed: str) -> bool:
|
|
"""Compare a typed phrase to the expected one.
|
|
|
|
Only surrounding whitespace is forgiven. Case and inner spacing must
|
|
match: retyping the sentence exactly is the point.
|
|
"""
|
|
return typed.strip() == expected
|