PyPI - trcc-linux - Versions diffs - 9.7.0__tar.gz → 9.7.2__tar.gz - Mend

trcc-linux 9.7.0tar.gz → 9.7.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (983) hide show

{trcc_linux-9.7.0 → trcc_linux-9.7.2}/.gitignore RENAMED Viewed

@@ -77,33 +77,16 @@ src/trcc/data/settings.json
 src/trcc/data/ui_*.json
 # ──────────────────────────────────────────────
-# Dev / reference files (not for distribution)
+# Dev / reference files
 # ──────────────────────────────────────────────
-# Block /dev/* per-file so the !-negations below can re-include
-# the shared mock harness. (`/dev/` directory-level rule wouldn't
-# allow re-include — git can't unignore a file under an ignored
-# directory.)
-/dev/*
-# Mock harness IS shared tooling — every developer benefits from
-# the same MockPlatform-backed CLI / API / GUI entry points.
-!/dev/mock_cli.py
-!/dev/mock_api.py
-!/dev/mock_gui.py
-!/dev/_mock_bootstrap.py
-!/dev/_mock_daemon.py
-!/dev/smoke_rotation_mask.py
-!/dev/smoke_daemon_gui.py
-!/dev/smoke_sleep_cycle.py
-!/dev/smoke_linux.py
-!/dev/smoke_windows.py
-!/dev/smoke_macos.py
-!/dev/smoke_macos_parsers.py
-!/dev/smoke_platforms.py
-!/dev/smoke_variant_resolution.py
-!/dev/smoke_bsd.py
-!/dev/_smoke_runtime.py
-!/dev/parity_smoke.py
-!/dev/smoke_full_pipeline.py
+# dev/ is SHARED contributor tooling — track it ALL by default so a new dev
+# script is never silently hidden behind a whitelist.  Ignore ONLY the runtime
+# artifacts the mock writes (dev/.trcc*, bytecode) and each developer's LOCAL
+# fleet config (devices.json — seed it from the committed devices.json.example).
+/dev/.trcc/
+/dev/.trcc-user/
+/dev/__pycache__/
+/dev/devices.json
 /dev_*
 # Dev scripts at root
 /test_*.py

{trcc_linux-9.7.0 → trcc_linux-9.7.2}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 9.7.0
+Version: 9.7.2
 Summary: Linux implementation of Thermalright LCD Control Center
 Project-URL: Homepage, https://github.com/Lexonight1/thermalright-trcc-linux
 Project-URL: Documentation, https://github.com/Lexonight1/thermalright-trcc-linux#readme
@@ -32,6 +32,7 @@ Requires-Dist: prompt-toolkit>=3.0.0
 Requires-Dist: psutil>=5.9.0
 Requires-Dist: pyside6>=6.5.0
 Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: pyudev>=0.24.1; sys_platform == 'linux'
 Requires-Dist: pyusb>=1.2.0
 Requires-Dist: sounddevice>=0.4.6
 Requires-Dist: typer>=0.9.0
@@ -45,6 +46,7 @@ Requires-Dist: httpx>=0.24.0; extra == 'all'
 Requires-Dist: nvidia-ml-py>=11.0.0; extra == 'all'
 Requires-Dist: pygobject>=3.42.0; extra == 'all'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'all'
+Requires-Dist: pytest-qt>=4.0.0; extra == 'all'
 Requires-Dist: pytest>=7.0.0; extra == 'all'
 Requires-Dist: qrcode>=7.0; extra == 'all'
 Requires-Dist: ruff>=0.4.0; extra == 'all'
@@ -52,6 +54,7 @@ Requires-Dist: types-qrcode>=7.0; extra == 'all'
 Provides-Extra: dev
 Requires-Dist: httpx>=0.24.0; extra == 'dev'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-qt>=4.0.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.4.0; extra == 'dev'
 Requires-Dist: types-qrcode>=7.0; extra == 'dev'
@@ -118,7 +121,7 @@ Description-Content-Type: text/markdown
 [![Buy Me a Beer](https://img.shields.io/badge/Buy_Me_a_Beer-🍺-FF5F5F?style=flat)](https://buymeacoffee.com/Lexonight1)
 [![Ko-fi](https://img.shields.io/badge/Ko--fi-☕-FF5E5B?style=flat&logo=kofi&logoColor=white)](https://ko-fi.com/lexonight1)
-> Huge thanks to **[@Xentrino](https://github.com/Xentrino)**, **[@javisaman](https://github.com/javisaman)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@Reborn627](https://github.com/Reborn627)**, **[@Mr-Renegade](https://github.com/Mr-Renegade)**, **[@knappstar](https://github.com/knappstar)**, **[@woebygon](https://github.com/woebygon)**, **[@Smokemic](https://github.com/Smokemic)**, **[@chava-byte](https://github.com/chava-byte)**, **[@nihilistqueen](https://github.com/nihilistqueen)**, **[@rhuggins573-crypto](https://github.com/rhuggins573-crypto)**, **[@unfirthman](https://github.com/unfirthman)**, **Glyn**, **dugalex**, and **Dunvcpi** for the beers — you guys are legends.
+> Huge thanks to **[@Xentrino](https://github.com/Xentrino)**, **[@javisaman](https://github.com/javisaman)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@Reborn627](https://github.com/Reborn627)**, **[@Mr-Renegade](https://github.com/Mr-Renegade)**, **[@knappstar](https://github.com/knappstar)**, **[@woebygon](https://github.com/woebygon)**, **[@Smokemic](https://github.com/Smokemic)**, **[@chava-byte](https://github.com/chava-byte)**, **[@nihilistqueen](https://github.com/nihilistqueen)**, **[@rhuggins573-crypto](https://github.com/rhuggins573-crypto)**, **[@unfirthman](https://github.com/unfirthman)**, **Glyn**, **dugalex**, **Dunvcpi**, and **RichardK** for the beers — you guys are legends.
 Native Linux port of the Thermalright LCD Control Center (Windows TRCC 2.1.2). Control and customize the LCD displays and LED segment displays on Thermalright CPU coolers, AIO pump heads, and fan hubs — entirely from Linux.
@@ -172,7 +175,7 @@ sudo dnf install pipx libusb-1.0.0 sg3_utils p7zip                      # Fedora
 # Install trcc-linux
 pipx install trcc-linux
-trcc setup        # interactive wizard — udev rules, desktop entry
+trcc system setup        # interactive wizard — udev rules, desktop entry
 ```
 Then **unplug and replug the USB cable** and run `trcc gui`.
@@ -218,7 +221,7 @@ Full desktop app with theme browser, video player, overlay editor, LED control p
 ```bash
 trcc detect               # Show connected devices
 trcc send image.png       # Send image to LCD
-trcc color "#ff0000"      # Fill LCD with solid color
+trcc display color "#ff0000"      # Fill LCD with solid color
 trcc video clip.mp4       # Play video on LCD
 trcc screencast           # Live screen capture to LCD
 trcc brightness 2         # Set brightness (1=25%, 2=50%, 3=100%)
@@ -230,7 +233,7 @@ trcc led-color "#00ff00"  # Set LED color
 trcc led-mode breathing   # Set LED effect mode
 trcc report               # Generate diagnostic report
 trcc doctor               # Check system dependencies
-trcc setup                # Interactive setup wizard
+trcc system setup                # Interactive setup wizard
 trcc uninstall            # Remove TRCC completely
 ```

{trcc_linux-9.7.0 → trcc_linux-9.7.2}/README.md RENAMED Viewed

@@ -47,7 +47,7 @@
 [![Buy Me a Beer](https://img.shields.io/badge/Buy_Me_a_Beer-🍺-FF5F5F?style=flat)](https://buymeacoffee.com/Lexonight1)
 [![Ko-fi](https://img.shields.io/badge/Ko--fi-☕-FF5E5B?style=flat&logo=kofi&logoColor=white)](https://ko-fi.com/lexonight1)
-> Huge thanks to **[@Xentrino](https://github.com/Xentrino)**, **[@javisaman](https://github.com/javisaman)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@Reborn627](https://github.com/Reborn627)**, **[@Mr-Renegade](https://github.com/Mr-Renegade)**, **[@knappstar](https://github.com/knappstar)**, **[@woebygon](https://github.com/woebygon)**, **[@Smokemic](https://github.com/Smokemic)**, **[@chava-byte](https://github.com/chava-byte)**, **[@nihilistqueen](https://github.com/nihilistqueen)**, **[@rhuggins573-crypto](https://github.com/rhuggins573-crypto)**, **[@unfirthman](https://github.com/unfirthman)**, **Glyn**, **dugalex**, and **Dunvcpi** for the beers — you guys are legends.
+> Huge thanks to **[@Xentrino](https://github.com/Xentrino)**, **[@javisaman](https://github.com/javisaman)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@Reborn627](https://github.com/Reborn627)**, **[@Mr-Renegade](https://github.com/Mr-Renegade)**, **[@knappstar](https://github.com/knappstar)**, **[@woebygon](https://github.com/woebygon)**, **[@Smokemic](https://github.com/Smokemic)**, **[@chava-byte](https://github.com/chava-byte)**, **[@nihilistqueen](https://github.com/nihilistqueen)**, **[@rhuggins573-crypto](https://github.com/rhuggins573-crypto)**, **[@unfirthman](https://github.com/unfirthman)**, **Glyn**, **dugalex**, **Dunvcpi**, and **RichardK** for the beers — you guys are legends.
 Native Linux port of the Thermalright LCD Control Center (Windows TRCC 2.1.2). Control and customize the LCD displays and LED segment displays on Thermalright CPU coolers, AIO pump heads, and fan hubs — entirely from Linux.
@@ -101,7 +101,7 @@ sudo dnf install pipx libusb-1.0.0 sg3_utils p7zip                      # Fedora
 # Install trcc-linux
 pipx install trcc-linux
-trcc setup        # interactive wizard — udev rules, desktop entry
+trcc system setup        # interactive wizard — udev rules, desktop entry
 ```
 Then **unplug and replug the USB cable** and run `trcc gui`.
@@ -147,7 +147,7 @@ Full desktop app with theme browser, video player, overlay editor, LED control p
 ```bash
 trcc detect               # Show connected devices
 trcc send image.png       # Send image to LCD
-trcc color "#ff0000"      # Fill LCD with solid color
+trcc display color "#ff0000"      # Fill LCD with solid color
 trcc video clip.mp4       # Play video on LCD
 trcc screencast           # Live screen capture to LCD
 trcc brightness 2         # Set brightness (1=25%, 2=50%, 3=100%)
@@ -159,7 +159,7 @@ trcc led-color "#00ff00"  # Set LED color
 trcc led-mode breathing   # Set LED effect mode
 trcc report               # Generate diagnostic report
 trcc doctor               # Check system dependencies
-trcc setup                # Interactive setup wizard
+trcc system setup                # Interactive setup wizard
 trcc uninstall            # Remove TRCC completely
 ```

{trcc_linux-9.7.0 → trcc_linux-9.7.2}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 [project]
 name = "trcc-linux"
-version = "9.7.0"
+version = "9.7.2"
 description = "Linux implementation of Thermalright LCD Control Center"
 readme = "README.md"
 license = "GPL-3.0-or-later"
@@ -51,6 +51,12 @@ dependencies = [
     "sounddevice>=0.4.6",
     "wmi>=1.5.1; sys_platform == 'win32'",
     "certifi>=2023.7.22",
+    # Linux hotplug: live device attach/detach + boot-time coldplug.  Without
+    # it the udev monitor can't start, so a device plugged in after launch (or
+    # missed at the boot discover) never connects — hotplug silently no-ops.
+    # Core feature, not optional; the graceful-None fallback only covers exotic
+    # environments that strip libudev (#139).
+    "pyudev>=0.24.1; sys_platform == 'linux'",
 ]
 [project.optional-dependencies]
@@ -74,6 +80,7 @@ remote = [
 dev = [
     "pytest>=7.0.0",
     "pytest-cov>=4.0.0",
+    "pytest-qt>=4.0.0",
     "ruff>=0.4.0",
     "httpx>=0.24.0",
     "types-qrcode>=7.0",
@@ -129,6 +136,10 @@ artifacts = [
     "**/assets/**/*.service",
     "**/assets/**/*.policy",
     "**/assets/**/*.svg",
+    # SELinux policy source — `trcc system setup` builds + loads it on Fedora
+    # so source/pip installs can pass the USB/SCSI ioctls (packages ship the
+    # compiled .pp via the rpm).
+    "**/data/trcc_usb.te",
 ]
 [tool.pytest.ini_options]

{trcc_linux-9.7.0 → trcc_linux-9.7.2}/src/trcc/__main__.py RENAMED Viewed

@@ -42,7 +42,7 @@ _early_handler = _rotating_handler_cls(
 # Tag the early shim so ``adapters.infra.logging.configure_logging`` knows
 # to swap it out when it runs.  Without the tag, both handlers stay
 # attached and every log line gets written twice.
-_early_handler._trcc_next_handler = True  # type: ignore[attr-defined]
+_early_handler._trcc_handler = True  # type: ignore[attr-defined]
 logging.basicConfig(
     level=logging.DEBUG,
     format='%(asctime)s [%(levelname)s] %(name)s.%(funcName)s: %(message)s',

{trcc_linux-9.7.0 → trcc_linux-9.7.2}/src/trcc/__version__.py RENAMED Viewed

@@ -1,4 +1,4 @@
 """TRCC Linux version information. History in doc/CHANGELOG.md."""
-__version__ = "9.7.0"
+__version__ = "9.7.2"
 __version_info__ = tuple(int(x) for x in __version__.split("."))

{trcc_linux-9.7.0 → trcc_linux-9.7.2}/src/trcc/_boot.py RENAMED Viewed

@@ -2,8 +2,8 @@
 Routes to one of two backends based on the environment::
-    TRCC_NEXT_DAEMON unset     → real App, in-process
-    TRCC_NEXT_DAEMON=1         → AppProxy, talks to daemon over Unix socket
+    TRCC_DAEMON unset     → real App, in-process
+    TRCC_DAEMON=1         → AppProxy, talks to daemon over Unix socket
                                  (auto-spawns the daemon if not running)
 On Windows < build 17063 ``AF_UNIX`` is not available; the factory
@@ -27,10 +27,10 @@ if TYPE_CHECKING:
 log = logging.getLogger(__name__)
-_ENV_FLAG = "TRCC_NEXT_DAEMON"
+_ENV_FLAG = "TRCC_DAEMON"
-def trcc_next(
+def trcc(
     *,
     platform: Platform | None = None,
     renderer: Renderer | None = None,
@@ -39,9 +39,9 @@ def trcc_next(
     Three modes:
-      * ``TRCC_NEXT_DAEMON=1`` + ``AF_UNIX`` available → ``AppProxy``
+      * ``TRCC_DAEMON=1`` + ``AF_UNIX`` available → ``AppProxy``
         (auto-spawn daemon on first request).
-      * ``TRCC_NEXT_DAEMON=1`` on a platform without ``AF_UNIX`` →
+      * ``TRCC_DAEMON=1`` on a platform without ``AF_UNIX`` →
         warn once and fall back to in-process.
       * Default → in-process ``App`` built from ``platform`` /
         ``renderer`` (auto-detected when omitted).
@@ -50,7 +50,7 @@ def trcc_next(
     owns both.  Pass them when forcing in-process construction (tests,
     composition roots).
     """
-    log.info("trcc_next: env_flag=%s platform=%s renderer=%s",
+    log.info("trcc: env_flag=%s platform=%s renderer=%s",
              os.environ.get(_ENV_FLAG), platform is not None,
              renderer is not None)
     if os.environ.get(_ENV_FLAG) == "1":
@@ -79,7 +79,7 @@ def _build_local_app(
     platform: Platform | None = None,
     renderer: Renderer | None = None,
 ) -> App:
-    """Construct an in-process App.  Used by ``trcc_next`` and the daemon."""
+    """Construct an in-process App.  Used by ``trcc`` and the daemon."""
     log.info("_build_local_app: platform=%s renderer=%s",
              platform is not None, renderer is not None)
     from .adapters.system import PlatformFactory

{trcc_linux-9.7.0 → trcc_linux-9.7.2}/src/trcc/adapters/device/bulk_lcd.py RENAMED Viewed

@@ -21,7 +21,13 @@ from ...core.errors import (
 )
 from ...core.models import HandshakeResult, ProductInfo, Wire
 from ...core.ports import BulkTransport, Device
-from ...core.protocol import DeviceProfile, get_profile, pm_to_fbl
+from ...core.protocol import (
+    DeviceProfile,
+    get_profile,
+    pm_to_fbl,
+    resolve_encode_base,
+    resolve_encode_sub,
+)
 from . import DeviceFactory
 log = logging.getLogger(__name__)
@@ -50,6 +56,17 @@ _WRITE_CHUNK_SIZE = 16 * 1024
 # PM values that use raw RGB565 (cmd=3); everything else uses JPEG (cmd=2).
 _RGB565_PMS: set[int] = {32}
+# Bulk base FBL is 72 (480x480, hardcoded by USBLCDNew.exe).  C#
+# FormCZTVInit (myDeviceMode==2) overrides it only for this known PM set
+# (plus PM=1 with SUB 48/49); every other PM stays 480x480.  pm_to_fbl()
+# returns the PM itself for unrecognised values, which get_profile would
+# misread as a 320x320 panel — so unknown bulk PMs must clamp to FBL 72.
+# Mirrors legacy ``_bulk_resolution``. (#169)
+_BULK_BASE_FBL = 72
+_BULK_KNOWN_PMS: frozenset[int] = frozenset(
+    {5, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 32, 50, 63, 64, 65, 66, 68, 69}
+)
 @DeviceFactory.register(Wire.BULK)
 class BulkLcd(Device[BulkTransport]):
@@ -101,15 +118,39 @@ class BulkLcd(Device[BulkTransport]):
         # Build the cached profile. Resolution comes from the FBL tables
         # (mirrors legacy ``_bulk_resolution``); the jpeg flag is the
-        # Bulk-specific override (USBLCDNew → JPEG except PM=32).
-        fbl = pm_to_fbl(self._pm, self._sub)
+        # Bulk-specific override (USBLCDNew → JPEG except PM=32).  Unknown
+        # bulk PMs stay on the 480x480 base rather than letting pm_to_fbl
+        # echo the PM into get_profile as a bogus FBL (C# parity, #169).
+        if self._pm in _BULK_KNOWN_PMS or (
+            self._pm == 1 and self._sub in (48, 49)
+        ):
+            fbl = pm_to_fbl(self._pm, self._sub)
+        else:
+            log.info(
+                "BulkLcd %s: PM=%d SUB=%d not a known bulk model — "
+                "defaulting to FBL %d (480x480)",
+                self.info.key, self._pm, self._sub, _BULK_BASE_FBL,
+            )
+            fbl = _BULK_BASE_FBL
         base = get_profile(fbl, self._pm)
+        # Resolve the device-only encode baseline now that PM is known — e.g.
+        # the FW360 Ultra (PM=6) mounts 180° rotated and needs its wire frame
+        # pre-rotated so it reads upright on the glass. (#137)
+        encode_baseline = resolve_encode_base(base, self._pm)
+        if encode_baseline:
+            log.info("BulkLcd %s: PM=%d encode baseline %d° (wire-only)",
+                     self.info.key, self._pm, encode_baseline)
+        # Fold the sub-byte override into encode_base now that SUB is known, so
+        # the render-time resolve_encode_angle only needs the user orientation
+        # (C# ImageToJpg mySubMode branch — e.g. FBL 224 sub=2 → 180°). (#169)
+        encode_base = resolve_encode_sub(base, self._sub)
         self._profile = DeviceProfile(
             width=base.width, height=base.height,
             jpeg=(self._pm not in _RGB565_PMS),
             big_endian=base.big_endian, rotate=base.rotate,
-            encode_base=base.encode_base, encode_invert=base.encode_invert,
-            encode_sub_bases=base.encode_sub_bases,
+            encode_baseline=encode_baseline,
+            encode_base=encode_base, encode_invert=base.encode_invert,
+            encode_sub_bases=(),  # folded into encode_base above
             encode_pm_bases=base.encode_pm_bases,
         )

{trcc_linux-9.7.0 → trcc_linux-9.7.2}/src/trcc/adapters/device/ly_lcd.py RENAMED Viewed

@@ -15,6 +15,7 @@ ThreadSendDeviceDataLY / ThreadSendDeviceDataLY1.
 """
 from __future__ import annotations
+import dataclasses
 import logging
 import struct
@@ -25,7 +26,12 @@ from ...core.errors import (
 )
 from ...core.models import HandshakeResult, ProductInfo, Wire
 from ...core.ports import BulkTransport, Device
-from ...core.protocol import DeviceProfile, get_profile, pm_to_fbl
+from ...core.protocol import (
+    DeviceProfile,
+    get_profile,
+    pm_to_fbl,
+    resolve_encode_sub,
+)
 from . import DeviceFactory
 log = logging.getLogger(__name__)
@@ -113,7 +119,15 @@ class LyLcd(Device[BulkTransport]):
             self._sub = resp[22] if len(resp) > 22 else 0
         fbl = pm_to_fbl(self._pm, self._sub)
-        self._profile = get_profile(fbl, self._pm)
+        # Fold the sub-byte override into encode_base now that SUB is known so
+        # render-time resolve_encode_angle only needs the user orientation
+        # (C# ImageToJpg mySubMode branch — FBL 192 sub 2/3/4 → 0°). (#169)
+        base = get_profile(fbl, self._pm)
+        self._profile = dataclasses.replace(
+            base,
+            encode_base=resolve_encode_sub(base, self._sub),
+            encode_sub_bases=(),
+        )
         result = HandshakeResult(
             resolution=self._profile.resolution,

{trcc_linux-9.7.0 → trcc_linux-9.7.2}/src/trcc/adapters/diagnostics/health.py RENAMED Viewed

@@ -26,6 +26,7 @@ from pathlib import Path
 from typing import Literal
 from ...core.ports import Paths, Platform
+from ..sensors.nvml import NVML_RELOAD_HINT, nvml_init_state
 log = logging.getLogger(__name__)
@@ -175,6 +176,68 @@ def check_sensors_enumerable(platform: Platform) -> HealthCheckResult:
     )
+def nvidia_gpu_present() -> bool:
+    """Cheap probe: is a discrete NVIDIA (PCI vendor ``0x10de``) GPU present?
+    Reads ``/sys/bus/pci/devices/*/vendor`` — no subprocess, and works even
+    when the driver / pynvml are absent.  That's the point: detect the card
+    independently of the reader so we can advise *installing* the reader.
+    Non-Linux falls back to the driver proc node.
+    """
+    if sys.platform != "linux":
+        return Path("/proc/driver/nvidia/version").exists()
+    pci_root = Path("/sys/bus/pci/devices")
+    if not pci_root.is_dir():
+        return False
+    for dev in pci_root.iterdir():
+        try:
+            if dev.joinpath("vendor").read_text().strip().lower() != "0x10de":
+                continue
+            # PCI class 0x03xxxx == display controller (skip non-GPU NVIDIA
+            # functions like the bundled HDMI-audio device).
+            if dev.joinpath("class").read_text().strip().lower().startswith("0x03"):
+                return True
+        except OSError:
+            continue
+    return False
+def check_gpu_sensors(platform: Platform) -> HealthCheckResult:
+    """NVIDIA GPU present but no metrics → guide the user to the fix.
+    The foolproof-install check: a discrete NVIDIA card with empty GPU
+    readings is almost always (a) the pynvml reader not installed, or (b) an
+    NVML version mismatch after a driver update without reboot.  Both are
+    actionable, so this WARNs (not FAILs) with a distro-specific hint.  No
+    NVIDIA card → OK (AMD reads via hwmon, no extra package needed).
+    """
+    log.info("check_gpu_sensors: called")
+    reader_available, initialized, last_error = nvml_init_state()
+    if initialized:
+        return HealthCheckResult(
+            name="gpu-sensors", severity="OK",
+            message="NVIDIA GPU sensors available (NVML initialized)",
+        )
+    if not nvidia_gpu_present():
+        return HealthCheckResult(
+            name="gpu-sensors", severity="OK",
+            message="No discrete NVIDIA GPU detected (NVML check not applicable)",
+        )
+    if not reader_available:
+        return HealthCheckResult(
+            name="gpu-sensors", severity="WARN",
+            message="NVIDIA GPU detected but the pynvml reader is not installed "
+                    "— GPU metrics will be empty",
+            fix_hint=package_install_hint("python3-pynvml")
+                     + " (the trcc-linux package should pull this in)",
+        )
+    return HealthCheckResult(
+        name="gpu-sensors", severity="WARN",
+        message=f"NVIDIA GPU detected but NVML init failed: {last_error}",
+        fix_hint=NVML_RELOAD_HINT,
+    )
 def check_ffmpeg_present() -> HealthCheckResult:
     """ffmpeg is required for video themes; absence is WARN (still usable
     for image-only themes)."""
@@ -267,6 +330,7 @@ def run_health_checks(platform: Platform) -> HealthReport:
         check_config_writable(paths),
         check_devices_visible(platform),
         check_sensors_enumerable(platform),
+        check_gpu_sensors(platform),
         check_ffmpeg_present(),
         check_qt_importable(),
         check_udev_rules_linux(),

{trcc_linux-9.7.0 → trcc_linux-9.7.2}/src/trcc/adapters/infra/logging.py RENAMED Viewed

@@ -5,6 +5,10 @@ block with a focused configurator that:
 * writes to ``Paths.log_file()`` with rotation at 1 MB × 5 backups so
   long-lived daemons don't fill the disk;
+* also writes a sibling ``<stem>.latest.log`` truncated fresh on every
+  process start, so "what did THIS launch do" is always the whole file
+  with no rotation/offset math — the rotating log keeps cross-run
+  history, the latest log isolates the current run;
 * mirrors WARNING+ to stderr so terminal users see issues without
   digging into the log file;
 * uses a single timestamped format every TRCC logger inherits.
@@ -23,7 +27,7 @@ from pathlib import Path
 log = logging.getLogger(__name__)
-_HANDLER_TAG = "_trcc_next_handler"
+_HANDLER_TAG = "_trcc_handler"
 # ``name`` is the module logger; ``classname`` is injected by
 # ClassContextFilter; ``funcName``/``lineno`` come free on every record.
 # Result per line: ``trcc.core.commands.device:SetBrightness.execute:208``
@@ -78,6 +82,7 @@ def configure_logging(
     level: int = logging.INFO,
     max_bytes: int = 1_000_000,
     backup_count: int = 5,
+    latest_max_bytes: int = 10_000_000,
     stderr_level: int = logging.WARNING,
 ) -> None:
     """Wire the root logger to log_file + stderr.  Idempotent.
@@ -110,6 +115,24 @@ def configure_logging(
     setattr(file_handler, _HANDLER_TAG, True)
     root.addHandler(file_handler)
+    # Per-run log: a SECOND file truncated fresh on open (mode="w").
+    # ``configure_logging`` runs once per process (CLI root callback /
+    # launch entry point), so the truncate happens exactly once per app
+    # init and the file holds this run alone.  Still a RotatingFileHandler
+    # so a long-lived ``-v`` session (video DEBUG can emit ~30–90 lines/s)
+    # can't grow the file without bound — it rolls at ``latest_max_bytes``
+    # keeping one backup (worst case 2× the cap on disk).
+    latest_file = log_file.with_name(f"{log_file.stem}.latest{log_file.suffix}")
+    latest_handler = RotatingFileHandler(
+        latest_file, mode="w", maxBytes=latest_max_bytes, backupCount=1,
+        encoding="utf-8",
+    )
+    latest_handler.setLevel(level)
+    latest_handler.setFormatter(formatter)
+    latest_handler.addFilter(context_filter)
+    setattr(latest_handler, _HANDLER_TAG, True)
+    root.addHandler(latest_handler)
     stderr_handler = logging.StreamHandler(stream=sys.stderr)
     stderr_handler.setLevel(stderr_level)
     stderr_handler.setFormatter(formatter)
@@ -118,9 +141,9 @@ def configure_logging(
     root.addHandler(stderr_handler)
     log.info(
-        "configure_logging: file=%s level=%s rotate=%d×%d stderr=%s",
-        log_file, logging.getLevelName(level), max_bytes, backup_count,
-        logging.getLevelName(stderr_level),
+        "configure_logging: file=%s latest=%s level=%s rotate=%d×%d stderr=%s",
+        log_file, latest_file, logging.getLevelName(level),
+        max_bytes, backup_count, logging.getLevelName(stderr_level),
     )

trcc_linux-9.7.2/src/trcc/adapters/infra/send_scheduler.py ADDED Viewed

@@ -0,0 +1,111 @@
+"""SendScheduler implementations — the execution behind the send worker.
+``ThreadSendScheduler`` runs one daemon thread per :class:`SendTask` (the
+production driver — single consumer per device ⇒ serialized writes).
+``SyncSendScheduler`` does nothing on its own; tests call :meth:`tick` to drive
+every task deterministically with a controlled clock — no threads, no sleeps.
+Both are injected at the composition root; the tasks (``DeviceSender``) never
+name a thread.  See ``doc/SEND_FOUNDATION.md``.
+"""
+from __future__ import annotations
+import logging
+import threading
+import time
+from ...core.ports import SendScheduler, SendTask
+log = logging.getLogger(__name__)
+class _TaskThread:
+    """A daemon thread that drives one task: ``wait(delay) → run_once``."""
+    __slots__ = ("_stop", "_task", "_thread")
+    def __init__(self, task: SendTask) -> None:
+        self._task = task
+        self._stop = threading.Event()
+        self._thread = threading.Thread(
+            target=self._run, name=f"trcc-send-{task.key}", daemon=True,
+        )
+    def start(self) -> None:
+        self._thread.start()
+    def _run(self) -> None:
+        # First pass establishes the initial delay (e.g. a volatile task wants
+        # to keepalive even if no frame has been submitted yet).
+        delay = self._task.run_once(time.monotonic())
+        while not self._stop.is_set():
+            self._task.wait(delay)
+            if self._stop.is_set():
+                break
+            delay = self._task.run_once(time.monotonic())
+    def stop(self, *, join_timeout: float = 2.0) -> None:
+        self._stop.set()
+        self._task.wake()   # interrupt a long-idle wait so the join is prompt
+        self._thread.join(timeout=join_timeout)
+        if self._thread.is_alive():
+            log.warning("ThreadSendScheduler: task %s did not stop within %.1fs",
+                        self._task.key, join_timeout)
+class ThreadSendScheduler(SendScheduler):
+    """One daemon thread per task — the production execution model."""
+    def __init__(self) -> None:
+        self._threads: dict[str, _TaskThread] = {}
+        self._lock = threading.Lock()
+    def add(self, task: SendTask) -> None:
+        log.info("ThreadSendScheduler: add %s", task.key)
+        with self._lock:
+            existing = self._threads.pop(task.key, None)
+            if existing is not None:
+                log.warning("ThreadSendScheduler: replacing existing task %s",
+                            task.key)
+                existing.stop()
+            worker = _TaskThread(task)
+            self._threads[task.key] = worker
+        worker.start()
+    def remove(self, key: str) -> None:
+        log.info("ThreadSendScheduler: remove %s", key)
+        with self._lock:
+            worker = self._threads.pop(key, None)
+        if worker is not None:
+            worker.stop()
+    def shutdown(self) -> None:
+        with self._lock:
+            workers = list(self._threads.values())
+            self._threads.clear()
+        log.info("ThreadSendScheduler: shutdown (%d task(s))", len(workers))
+        for worker in workers:
+            worker.stop()
+class SyncSendScheduler(SendScheduler):
+    """Deterministic driver — tests call :meth:`tick(now)`; no threads."""
+    def __init__(self) -> None:
+        self._tasks: dict[str, SendTask] = {}
+    def add(self, task: SendTask) -> None:
+        log.debug("SyncSendScheduler: add %s", task.key)
+        self._tasks[task.key] = task
+    def remove(self, key: str) -> None:
+        log.debug("SyncSendScheduler: remove %s", key)
+        self._tasks.pop(key, None)
+    def shutdown(self) -> None:
+        self._tasks.clear()
+    def tick(self, now: float) -> None:
+        """Drive every registered task once with clock *now* (seconds)."""
+        for task in list(self._tasks.values()):
+            task.run_once(now)

trcc-linux 9.7.0__tar.gz → 9.7.2__tar.gz

trcc-linux 9.7.0tar.gz → 9.7.2tar.gz