trcc-linux 9.11.1__tar.gz → 9.11.2__tar.gz

{trcc_linux-9.11.1 → trcc_linux-9.11.2}/.gitignore

@@ -100,6 +100,7 @@ src/trcc/data/ui_*.json
 /probe_*.py
 /*.sh
 !install.sh
+!install-steamos.sh
 
 # Dev tooling (root-level scratch only — dev/tools/ is tracked source)
 /tools/

{trcc_linux-9.11.1 → trcc_linux-9.11.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: trcc-linux
-Version: 9.11.1
+Version: 9.11.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
@@ -19,6 +19,8 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: System :: Hardware
 Classifier: Topic :: System :: Monitoring
 Requires-Python: >=3.10
@@ -125,7 +127,7 @@ Description-Content-Type: text/markdown
 
 > 💛 **Monthly backer: [@Reborn627](https://github.com/Reborn627)** — four straight months of recurring support. Steady backing like that is what actually keeps a one-person project alive. Thank you.
 
-> Huge thanks to **[@Xentrino](https://github.com/Xentrino)**, **[@javisaman](https://github.com/javisaman)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@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)**, **[@Milrite](https://github.com/Milrite)**, **[@BAS-HARBERS](https://github.com/BAS-HARBERS)**, **Glyn**, **dugalex**, **Dunvcpi**, **RichardK**, **Ryan**, **Rick**, and an anonymous supporter for the beers — you're all legends. 🍺
+> Huge thanks to **[@Xentrino](https://github.com/Xentrino)**, **[@javisaman](https://github.com/javisaman)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@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)**, **[@Milrite](https://github.com/Milrite)**, **[@BAS-HARBERS](https://github.com/BAS-HARBERS)**, **Glyn**, **dugalex**, **Dunvcpi**, **RichardK**, **Ryan**, **Rick**, **jamtland**, **AussieMakerGeek**, **oranura**, **Jyero Rayguster**, **Ziusz**, **Patrick / DrMeatball**, **Jacob**, **Erik C Zeek**, **James**, and an anonymous supporter for the beers and the coffees — you're all 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.
 
@@ -248,6 +250,20 @@ trcc system setup                               # Interactive setup wizard
 
 See the **[CLI Reference](doc/REFERENCE_CLI.md)** for the full command list.
 
+### Interactive prompt
+
+`trcc shell` opens a `trcc>` prompt: type any command without the leading `trcc`. Tab completes command names, the up arrow brings back earlier lines (kept in `~/.local/state/trcc/shell_history`), `help` lists the commands, and `exit` or Ctrl-D leaves.
+
+```
+$ trcc shell
+trcc> detect
+trcc> display color 0402:3922 "#ff0000"
+trcc> led mode 0416:8001 breathing
+trcc> exit
+```
+
+Every line goes to the same running TRCC as the GUI and the API, so there is no start-up wait per command. If TRCC is stopped (`trcc kill`) the prompt closes; if TRCC crashes, the next command starts it again.
+
 ### REST API
 
 Start the API server and control your devices remotely:

{trcc_linux-9.11.1 → trcc_linux-9.11.2}/README.md

@@ -47,7 +47,7 @@
 
 > 💛 **Monthly backer: [@Reborn627](https://github.com/Reborn627)** — four straight months of recurring support. Steady backing like that is what actually keeps a one-person project alive. Thank you.
 
-> Huge thanks to **[@Xentrino](https://github.com/Xentrino)**, **[@javisaman](https://github.com/javisaman)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@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)**, **[@Milrite](https://github.com/Milrite)**, **[@BAS-HARBERS](https://github.com/BAS-HARBERS)**, **Glyn**, **dugalex**, **Dunvcpi**, **RichardK**, **Ryan**, **Rick**, and an anonymous supporter for the beers — you're all legends. 🍺
+> Huge thanks to **[@Xentrino](https://github.com/Xentrino)**, **[@javisaman](https://github.com/javisaman)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@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)**, **[@Milrite](https://github.com/Milrite)**, **[@BAS-HARBERS](https://github.com/BAS-HARBERS)**, **Glyn**, **dugalex**, **Dunvcpi**, **RichardK**, **Ryan**, **Rick**, **jamtland**, **AussieMakerGeek**, **oranura**, **Jyero Rayguster**, **Ziusz**, **Patrick / DrMeatball**, **Jacob**, **Erik C Zeek**, **James**, and an anonymous supporter for the beers and the coffees — you're all 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.
 
@@ -170,6 +170,20 @@ trcc system setup                               # Interactive setup wizard
 
 See the **[CLI Reference](doc/REFERENCE_CLI.md)** for the full command list.
 
+### Interactive prompt
+
+`trcc shell` opens a `trcc>` prompt: type any command without the leading `trcc`. Tab completes command names, the up arrow brings back earlier lines (kept in `~/.local/state/trcc/shell_history`), `help` lists the commands, and `exit` or Ctrl-D leaves.
+
+```
+$ trcc shell
+trcc> detect
+trcc> display color 0402:3922 "#ff0000"
+trcc> led mode 0416:8001 breathing
+trcc> exit
+```
+
+Every line goes to the same running TRCC as the GUI and the API, so there is no start-up wait per command. If TRCC is stopped (`trcc kill`) the prompt closes; if TRCC crashes, the next command starts it again.
+
 ### REST API
 
 Start the API server and control your devices remotely:

{trcc_linux-9.11.1 → trcc_linux-9.11.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "trcc-linux"
-version = "9.11.1"
+version = "9.11.2"
 description = "Linux implementation of Thermalright LCD Control Center"
 readme = "README.md"
 license = "GPL-3.0-or-later"
@@ -23,6 +23,8 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: System :: Hardware",
     "Topic :: System :: Monitoring",
 ]

{trcc_linux-9.11.1 → trcc_linux-9.11.2}/src/trcc/__version__.py

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

{trcc_linux-9.11.1 → trcc_linux-9.11.2}/src/trcc/adapters/repo/http.py

@@ -90,6 +90,7 @@ class UrllibHttpFetcher(HttpFetcher):
                 log.info("HTTP GET %s → %d bytes", url, len(body))
                 return body
         except HTTPError as e:
+            e.close()       # an error is a response too; 3.14 warns when one is left open
             log.warning("HTTP GET %s → HTTPError %d", url, e.code)
             raise HttpFetchError(f"GET {url} → HTTP {e.code}") from e
         except URLError as e:

{trcc_linux-9.11.1 → trcc_linux-9.11.2}/src/trcc/adapters/system/_polkit_install.py

@@ -17,6 +17,7 @@ A file a distro package owns is never overwritten -- the package keeps it.
 """
 from __future__ import annotations
 
+import errno
 import logging
 import os
 from collections.abc import Callable
@@ -69,7 +70,16 @@ def install(dry_run: bool = False,
     try:
         for dest, src, mode in plan:
             _copy(src, dest, mode)
-    except OSError:
+    except OSError as e:
+        if e.errno == errno.EROFS:
+            # SteamOS, Bazzite and other image-based systems: /usr is
+            # read-only, and whatever reached it would go with the next update
+            # anyway.  Not a failure -- RAM lighting still works, through
+            # polkit's generic password prompt.
+            log.warning("install: %s is on a read-only system -- TRCC's own "
+                        "password prompt is not installed; RAM lighting asks "
+                        "through polkit's generic one", e.filename)
+            return 0
         log.exception("install: could not install TRCC's polkit files")
         return 1
     return 0

{trcc_linux-9.11.1 → trcc_linux-9.11.2}/src/trcc/adapters/system/_udev.py

@@ -34,7 +34,7 @@ from __future__ import annotations
 import logging
 import os
 import subprocess
-from collections.abc import Callable
+from collections.abc import Callable, Iterable
 from dataclasses import dataclass
 from pathlib import Path
 
@@ -69,6 +69,10 @@ RULES_DIRS = (
 _MODPROBE_PATH = Path("/etc/modprobe.d/trcc-lcd.conf")
 _MODULES_LOAD_PATH = Path("/etc/modules-load.d/trcc-sg.conf")
 _MODULES_LOAD_RAPL_PATH = Path("/etc/modules-load.d/trcc-rapl.conf")
+# SteamOS (3.6+) resets /etc on every OS update, except the paths a keep list
+# names; a drop-in here is itself on SteamOS's own list
+# (/usr/lib/rauc/atomic-update-keep.conf).  No other distro has the folder.
+KEEP_LIST_DIR = Path("/etc/atomic-update.conf.d")
 
 # `intel_rapl_msr` exposes the powercap RAPL energy counter on BOTH Intel and
 # AMD (Zen) — the vendor-agnostic `/sys/class/powercap/intel-rapl:*` node trcc
@@ -264,6 +268,26 @@ def host_files() -> dict[Path, str]:
     return files
 
 
+def keep_list(paths: Iterable[Path]) -> dict[Path, str]:
+    """On SteamOS, the drop-in that keeps *paths* through an OS update; else
+    nothing.
+
+    Without it the first update after setup threw the rules away, and the
+    panel stopped answering until setup ran again.  One path per line is the
+    format SteamOS reads.  Read at call time, as ``rule_files`` is, so a test
+    can point ``KEEP_LIST_DIR`` elsewhere.
+    """
+    if not KEEP_LIST_DIR.is_dir():
+        log.debug("keep_list: no %s -- not SteamOS", KEEP_LIST_DIR)
+        return {}
+    listed = [str(path) for path in paths]
+    log.info("keep_list: SteamOS -- keeping %s through updates", listed)
+    return {KEEP_LIST_DIR / "trcc-linux.conf": (
+        "# Thermalright TRCC -- generated by `trcc system setup`: keep its files\n"
+        "# through SteamOS updates, which reset /etc to the new image.\n"
+        + "".join(f"{path}\n" for path in listed))}
+
+
 # ── Installation ─────────────────────────────────────────────────────
 
 
@@ -276,6 +300,7 @@ def install(dry_run: bool = False) -> int:
     """
     log.info("install: dry_run=%s", dry_run)
     files = host_files()
+    files |= keep_list(files)
 
     if dry_run:
         for path, content in files.items():

{trcc_linux-9.11.1 → trcc_linux-9.11.2}/tests/adapters/system/test_polkit_install.py

@@ -73,3 +73,25 @@ def test_a_dry_run_writes_nothing(tmp_path: Path, capsys: pytest.CaptureFixture[
     assert install(dry_run=True, files=files) == 0
     assert not any(d.exists() for d in files)
     assert capsys.readouterr().out.count("--- would install") == 3
+
+
+def test_a_read_only_system_is_not_a_failure(tmp_path: Path, as_root,
+                                             monkeypatch: pytest.MonkeyPatch) -> None:
+    """SteamOS and Bazzite keep /usr read-only: setup reported failure there
+    though RAM lighting works through polkit's generic prompt.  Any other
+    write error still fails.
+
+    MUTATION CHECK: drop the EROFS branch -- the first assertion fails."""
+    import errno
+
+    def read_only(_src: Path, dest: Path, _mode: int) -> None:
+        raise OSError(errno.EROFS, "Read-only file system", str(dest))
+
+    monkeypatch.setattr(_polkit_install, "_copy", read_only)
+    assert install(files=_files(tmp_path)) == 0
+
+    def denied(_src: Path, dest: Path, _mode: int) -> None:
+        raise OSError(errno.EACCES, "Permission denied", str(dest))
+
+    monkeypatch.setattr(_polkit_install, "_copy", denied)
+    assert install(files=_files(tmp_path)) == 1

{trcc_linux-9.11.1 → trcc_linux-9.11.2}/tests/test_packaging_entrypoints.py

@@ -442,7 +442,6 @@ def test_the_legacy_deb_brings_the_library_its_qt_wheel_links() -> None:
 #: icon from the source tree (windows.yml), never from an installed package.
 _NOT_IN_THE_WHEEL = {
     "icons/app.ico": "the Windows exe's icon, used by PyInstaller at build time",
-    "fonts/README.md": "notes on the fonts' licences, for people reading the tree",
 }
 
 

{trcc_linux-9.11.1 → trcc_linux-9.11.2}/tests/test_udev.py

@@ -230,3 +230,34 @@ def test_every_uaccess_rule_file_runs_before_seat_late() -> None:
     assert uaccess, "no rule file grants uaccess"
     late = [name for name in uaccess if name >= "73-seat-late.rules"]
     assert not late, f"{late} tag uaccess after 73-seat-late.rules applies it"
+
+
+def test_steamos_keeps_every_file_setup_writes(tmp_path: Path, monkeypatch, capsys) -> None:
+    """SteamOS resets /etc on every update except the paths a keep list names,
+    so without one the first update threw the rules away.  The drop-in names
+    every file setup writes, and setup -- dry run included -- carries it.
+
+    MUTATION CHECK: drop ``files |= keep_list(files)`` from install -- the dry
+    run no longer shows the drop-in."""
+    from trcc.adapters.system import _udev
+
+    keep_dir = tmp_path / "atomic-update.conf.d"
+    keep_dir.mkdir()
+    monkeypatch.setattr(_udev, "KEEP_LIST_DIR", keep_dir)
+
+    drop_in = keep_dir / "trcc-linux.conf"
+    written = _udev.host_files()
+    listed = [line for line in _udev.keep_list(written)[drop_in].splitlines()
+              if not line.startswith("#")]
+    assert listed == [str(path) for path in written]
+
+    assert _udev.install(dry_run=True) == 0
+    assert f"--- would write {drop_in} ---" in capsys.readouterr().out.splitlines()
+
+
+def test_no_keep_list_off_steamos(tmp_path: Path, monkeypatch) -> None:
+    """Every other distro has no keep-list folder; nothing is added there."""
+    from trcc.adapters.system import _udev
+
+    monkeypatch.setattr(_udev, "KEEP_LIST_DIR", tmp_path / "absent")
+    assert _udev.keep_list(_udev.host_files()) == {}

trcc_linux-9.11.1/src/trcc/assets/fonts/README.md

@@ -1,4 +0,0 @@
-# Place Windows fonts here for exact visual matching
-# Copy from C:\Windows\Fonts\:
-#   msyh.ttc   (Microsoft YaHei Regular)
-#   msyhbd.ttc (Microsoft YaHei Bold)