mirror of
https://github.com/kuhyx/utils.git
synced 2026-11-13 19:11:00 +01:00
Krzysztof kuhy Rudnicki
6154dc09bf
The three Python packages pinned ruff twice at different versions: requirements.txt at 0.16.7, .pre-commit-config.yaml at v0.15.2. Only the older one ever ran, so `select = ["ALL"]` was enforced two minor versions behind. Measured before aligning: v0.15.2 reports 0 findings, every 0.16.x reports CPY001 on each file -- 70 crdt-sync, 23 freedays, 71 gatelock, and no other rule. Resolved by adding the notice rather than ignoring the rule, so the gate keeps its teeth. Two gatelock modules sat at exactly the 250-line cap, so a one-line header tipped them to 251. Both are split along a real seam rather than shaved: _widget_fills.py colour arithmetic over LockConfig, no tkinter import _surfaces_focus.py selects among existing surfaces, never mutates them The focus split keeps _surfaces.py's documented containment (it stays the only module that creates, moves or destroys windows), and the static guard in test_recovery_invariants.py globs _surfaces*.py, so the new sibling is covered with no list to extend. widgets.py re-exports the fills helpers, which keeps gatelock.widgets the single public surface its tests import. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019kMvSMtsVMB3d2uoZ56pbp
41 lines
1.4 KiB
Python
41 lines
1.4 KiB
Python
# Copyright (c) 2026 Krzysztof Rudnicki
|
|
"""Which surface takes keyboard focus, and moving it there.
|
|
|
|
Split from ``_surfaces.py`` (250-line cap). Focus is a read-then-point
|
|
concern: it selects among surfaces that already exist and never creates,
|
|
moves or destroys one, so it sits outside the structural-change containment
|
|
that ``_surfaces`` module docstring describes -- and the static invariant in
|
|
``test_recovery_invariants.py`` globs ``_surfaces*.py``, so this sibling is
|
|
covered by that guard the moment it exists, with no list to extend.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import TYPE_CHECKING
|
|
|
|
if TYPE_CHECKING:
|
|
from collections.abc import Mapping
|
|
|
|
from gatelock._placement import _Surface
|
|
from gatelock._surface_types import SurfaceInfo
|
|
|
|
|
|
def focus_surface(surfaces: Mapping[str, _Surface], index: int) -> SurfaceInfo | None:
|
|
"""Move keyboard focus to the surface at ``index``, returning what got it."""
|
|
for surface in surfaces.values():
|
|
if surface.info.index == index:
|
|
surface.window.focus_force()
|
|
return surface.info
|
|
return None
|
|
|
|
|
|
def preferred_focus_index(surfaces: Mapping[str, _Surface]) -> int:
|
|
"""Index of the surface that should take initial focus.
|
|
|
|
The live primary output if there is one, else the first surface.
|
|
"""
|
|
for surface in surfaces.values():
|
|
if surface.info.is_primary:
|
|
return surface.info.index
|
|
return 0
|