pytrain-ogr-deck 2.9.10__tar.gz

pytrain_ogr_deck-2.9.10/.github/workflows/python-package.yml

@@ -0,0 +1,48 @@
+# file: noinspection UndefinedParamsPresent,UndefinedAction
+# This workflow will installation Python dependencies, run tests and lint with a variety of Python versions
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
+
+name: Python package
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "master" ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ "3.11", "3.12", "3.13", "3.14" ]
+
+    steps:
+      - uses: actions/checkout@v6
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Prepare lgpio sources (only on 3.13)
+        if: matrix.python-version >= '3.13'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y build-essential swig python3-dev python3-setuptools
+          rm -rf /tmp/lg
+          git clone https://github.com/joan2937/lg /tmp/lg
+          cd /tmp/lg
+          make
+          sudo make install
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install ruff pytest
+          if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+      - name: Lint with ruff
+        run: ruff check --output-format=github --target-version=py310
+      - name: check code formatting
+        run: ruff format --diff --target-version=py310
+      - name: Test with pytest
+        run: pytest

pytrain_ogr_deck-2.9.10/.github/workflows/release.yml

@@ -0,0 +1,87 @@
+name: release.yml
+on:
+  push:
+    tags:
+      - '*'
+
+jobs:
+  build:
+    name: Build pytrain-ogr distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: "3.11"
+      - name: Install pypa/build
+        run: python3 -m pip install build
+      - name: Build a binary wheel and a source tarball
+        run: python3 -m build
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v7
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  build-deck:
+    name: Build pytrain-ogr-deck distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: "3.11"
+      - name: Install pypa/build
+        # setuptools-scm is needed outside the build as well: build_deck.py reads the
+        # version before it rewrites pyproject.toml, so the rewrite cannot make the
+        # working tree look dirty and add a local segment PyPI rejects
+        run: python3 -m pip install build setuptools-scm
+      - name: Build a binary wheel and a source tarball
+        run: python3 scripts/build_deck.py --outdir dist-deck
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v7
+        with:
+          name: python-package-distributions-deck
+          path: dist-deck/
+
+  pypi-publish:
+    name: Upload release to PyPI
+    needs:
+      - build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pytrain-ogr
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v7
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  pypi-publish-deck:
+    name: Upload pytrain-ogr-deck release to PyPI
+    needs:
+      - build-deck
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pytrain-ogr-deck
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v7
+        with:
+          name: python-package-distributions-deck
+          path: dist/
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

pytrain_ogr_deck-2.9.10/.gitignore

@@ -0,0 +1,24 @@
+*.bak
+*.csv
+*.pyc
+!.idea/
+!.idea/dictionaries/
+!.idea/dictionaries/project.xml
+.DS_Store
+.env
+.idea/
+.idea/*
+.pytrain.history
+.tox/
+__pycache__
+accessory_config.json
+buttons.py
+cache/
+dist-deck/
+dist/
+pytrain.history
+pytrain.log*
+raspinfo.txt
+replay.txt
+src/*.egg-info/
+src/pytrain/_version.py

pytrain_ogr_deck-2.9.10/.idea/dictionaries/project.xml

@@ -0,0 +1,162 @@
+<component name="ProjectDictionaryState">
+  <dictionary name="project">
+    <words>
+      <w>CONTROLLERTOUCHPAD</w>
+      <w>CONTROLLERTOUCHPADDOWN</w>
+      <w>CONTROLLERTOUCHPADMOTION</w>
+      <w>CONTROLLERTOUCHPADUP</w>
+      <w>Citgo</w>
+      <w>Dairymens</w>
+      <w>ELFCLASS</w>
+      <w>Esso</w>
+      <w>Fonic</w>
+      <w>Gamescope</w>
+      <w>HIDRAW</w>
+      <w>JOYBUTTONDOWN</w>
+      <w>KDE's</w>
+      <w>Lineville</w>
+      <w>Lionelville</w>
+      <w>Misalignd</w>
+      <w>RPAD</w>
+      <w>Sunoco</w>
+      <w>Swindell</w>
+      <w>VIDEODRIVER</w>
+      <w>accs</w>
+      <w>activebackground</w>
+      <w>addrs</w>
+      <w>admingeom</w>
+      <w>adolph</w>
+      <w>altoona</w>
+      <w>appendleft</w>
+      <w>atexit</w>
+      <w>autoremove</w>
+      <w>baudrate</w>
+      <w>baudrates</w>
+      <w>bluealsa</w>
+      <w>bluetooth</w>
+      <w>btid</w>
+      <w>btns</w>
+      <w>caap</w>
+      <w>chksum</w>
+      <w>chorded</w>
+      <w>citgo</w>
+      <w>columnspan</w>
+      <w>coors</w>
+      <w>cplr</w>
+      <w>ctors</w>
+      <w>cupsd</w>
+      <w>dairymens</w>
+      <w>dcds</w>
+      <w>debounces</w>
+      <w>defaultdict</w>
+      <w>dflt</w>
+      <w>disablers</w>
+      <w>disambig</w>
+      <w>disambiguates</w>
+      <w>dtoverlay</w>
+      <w>dtparam</w>
+      <w>dups</w>
+      <w>ebuf</w>
+      <w>eeprom</w>
+      <w>elete</w>
+      <w>envtmpdir</w>
+      <w>esso</w>
+      <w>etype</w>
+      <w>extendleft</w>
+      <w>gamescope</w>
+      <w>getcwd</w>
+      <w>gethostbyname</w>
+      <w>gethostname</w>
+      <w>getifaddr</w>
+      <w>guizero's</w>
+      <w>gvfs</w>
+      <w>hciuart</w>
+      <w>hexid</w>
+      <w>holdbtn</w>
+      <w>hpad</w>
+      <w>iwgetid</w>
+      <w>labwc</w>
+      <w>lcsser</w>
+      <w>libcups</w>
+      <w>libegl</w>
+      <w>libgallium</w>
+      <w>libgl</w>
+      <w>lightdm</w>
+      <w>lineville</w>
+      <w>lionelbase</w>
+      <w>lionelville</w>
+      <w>logind</w>
+      <w>lpgl</w>
+      <w>mailcap</w>
+      <w>maxlen</w>
+      <w>middletown</w>
+      <w>mobintl</w>
+      <w>modemmanager</w>
+      <w>mome</w>
+      <w>mvalue</w>
+      <w>myhost</w>
+      <w>nodash</w>
+      <w>ntum</w>
+      <w>nwse</w>
+      <w>ocal</w>
+      <w>oled</w>
+      <w>padx</w>
+      <w>pady</w>
+      <w>pendings</w>
+      <w>pennsylvania</w>
+      <w>piconfig</w>
+      <w>pittsburgh</w>
+      <w>pmid</w>
+      <w>polkit</w>
+      <w>powermaster</w>
+      <w>poweroff</w>
+      <w>precreate</w>
+      <w>pullmor</w>
+      <w>pycharm</w>
+      <w>pytrain</w>
+      <w>pytrainhome</w>
+      <w>pytraininfo</w>
+      <w>quilling</w>
+      <w>rbuttons</w>
+      <w>repeatdelay</w>
+      <w>repeatinterval</w>
+      <w>requeues</w>
+      <w>respbcasts</w>
+      <w>retryhost</w>
+      <w>returncode</w>
+      <w>rnum</w>
+      <w>rpad</w>
+      <w>rpicam</w>
+      <w>selectbackground</w>
+      <w>selectforeground</w>
+      <w>setsid</w>
+      <w>settimeout</w>
+      <w>squeekboard</w>
+      <w>steamdeck</w>
+      <w>sunoco</w>
+      <w>svsc</w>
+      <w>swapchains</w>
+      <w>tids</w>
+      <w>titlebox</w>
+      <w>titleized</w>
+      <w>tk's</w>
+      <w>tkfont</w>
+      <w>tk’s</w>
+      <w>tmcc</w>
+      <w>toxworkdir</w>
+      <w>troughcolor</w>
+      <w>uevent</w>
+      <w>unsel</w>
+      <w>userhome</w>
+      <w>valids</w>
+      <w>vdiag</w>
+      <w>vpad</w>
+      <w>wayvnc</w>
+      <w>wcomp</w>
+      <w>weakref</w>
+      <w>wraplength</w>
+      <w>wvkbd</w>
+      <w>zxcvbnm</w>
+    </words>
+  </dictionary>
+</component>

pytrain_ogr_deck-2.9.10/.junie/plans/auto-reload-accessory-config.md

@@ -0,0 +1,184 @@
+---
+sessionId: session-260806-094756-1vjd
+---
+
+# Requirements
+
+### Overview & Goals
+
+Automatically reload EngineGui’s configured accessory state when `accessory_config.json` changes, including changes
+propagated into `cache/config/accessory_config.json` by cache sync.
+
+### Scope
+
+#### In Scope
+
+- Detect changes to the currently resolved accessory config file used by `ConfiguredAccessorySet`.
+- Run file monitoring and JSON/config parsing outside the GUI thread.
+- Apply the already-loaded configuration to `EngineGui` safely using the existing GUI scheduling/message patterns.
+- Preserve the existing manual Admin panel `Accessories` reload button as a user-triggered fallback.
+- Avoid repeated reload storms by using polling/debounce or signature comparison.
+
+#### Out of Scope
+
+- Changing cache sync behavior itself; the file is already synchronized by `CacheSyncManager`/`SidecarCacheTransport`.
+- Live-editing individual accessory widgets in place; reload will reuse the existing teardown/rebuild behavior.
+- Adding a new external file-watching dependency unless already present in the project.
+
+### Functional Requirements
+
+- When the effective config file changes on disk, `EngineGui` reloads configured accessories automatically.
+- Invalid JSON or invalid config entries must not replace the current working accessory set.
+- Reload failures should be logged and the watcher should continue monitoring later changes.
+- The GUI thread must not perform file polling or config parsing; it should only apply the resulting
+  `ConfiguredAccessorySet` and update GUI state.
+- Both top-level `accessory_config.json` and cache-resolved `cache/config/accessory_config.json` must be handled
+  according to the existing resolution rules in `ConfiguredAccessorySet.resolve_config_path()`.
+
+# Technical Design
+
+### Current Implementation
+
+- `src/pytrain/gui/accessories/configured_accessory.py` defines `DEFAULT_CONFIG_FILE = "accessory_config.json"` and
+  `DEFAULT_CONFIG_CACHE_DIR = Path("cache") / "config"`.
+- `ConfiguredAccessorySet.from_file()` calls `_load()`, resolves the effective path, reads/parses JSON, validates
+  entries, and rebuilds indexes synchronously.
+- `EngineGui.__init__()` stores `self._accessory_config_file = config_file`, then loads
+  `self._caa = ConfiguredAccessorySet.from_file(config_file, verify=True)` and creates
+  `ConfiguredAccessoryAdapterProvider`.
+- `EngineGui.reload_configured_accessories()` currently rereads the file and then clears/rebuilds adapter, overlay,
+  recents, catalog, options, and prewarm state.
+- `EngineGui` already has background support via `self._executor.submit(...)`, GUI scheduling via
+  `self.app.tk.after(...)`, and lifecycle cleanup in `destroy_gui()`.
+- Cache sync (`src/pytrain/db/cache_sync.py`) already polls/manifests cache file changes in a daemon thread, but it does
+  not notify `EngineGui`.
+
+### Key Decisions
+
+- Use lightweight polling with file signature comparison instead of adding a dependency such as `watchdog`.
+    - Rationale: the project already uses polling/debounce for cache sync, and this avoids platform-specific watcher
+      concerns.
+- Split reload into two phases:
+    - background phase: detect file changes and build a fresh `ConfiguredAccessorySet`;
+    - GUI phase: apply the prepared set to `EngineGui` using existing GUI scheduling/locking.
+- Keep the watcher owned by `EngineGui`, because the reload affects GUI-owned adapter, popup, option, and prewarm state.
+
+### Proposed Changes
+
+- Add a small internal watcher mechanism near `EngineGui` or as a helper class in
+  `src/pytrain/gui/controller/engine_gui.py`.
+    - Track the effective config path from `self.accessories.path` after initial load.
+    - Compare a signature such as `(resolved_path, exists, st_mtime_ns, st_size)` on a polling interval.
+    - Debounce changed signatures briefly before loading to avoid partial writes while cache sync/configure writes the
+      file.
+- Refactor `EngineGui.reload_configured_accessories()` into:
+    - a loading method that can run off the GUI thread, e.g. `_load_configured_accessories()` returning
+      `ConfiguredAccessorySet | None`;
+    - an apply method that only runs on the GUI thread, e.g. `_apply_configured_accessories(configured)`.
+- Add a non-GUI-thread auto reload flow:
+    - watcher detects file signature change;
+    - background worker calls `ConfiguredAccessorySet.from_file(self._accessory_config_file, verify=True)`;
+    - if successful, schedule `_apply_configured_accessories(configured)` via `self.app.tk.after(0, ...)` or the
+      existing message queue pattern.
+- Preserve manual reload:
+    - `AdminPanel` line 181 can continue calling `self._gui.reload_configured_accessories`;
+    - manual reload may synchronously schedule/load through the same split implementation, but config parsing should
+      also avoid blocking the GUI if feasible.
+- Add shutdown cleanup:
+    - stop the watcher when `EngineGui.destroy_gui()` runs or when `self._shutdown_flag` is set;
+    - ensure pending callbacks no-op if shutdown has started.
+
+### Data Flow
+
+```mermaid
+graph LR
+    F[accessory_config.json] --> W[background watcher]
+    W --> L[background load]
+    L --> S[ConfiguredAccessorySet]
+    S --> A[GUI-thread apply]
+    A --> P[adapters/overlays/options]
+```
+
+### Files Affected
+
+- `src/pytrain/gui/controller/engine_gui.py`
+    - Add watcher state fields and startup scheduling after initial UI setup.
+    - Split reload into load/apply helpers.
+    - Start/stop watcher in existing lifecycle methods.
+- `src/pytrain/gui/accessories/configured_accessory.py`
+    - No required behavioral change expected; use existing `ConfiguredAccessorySet.path` and resolution behavior.
+- `tests/` if GUI-controller tests exist or can be added without requiring a real display.
+    - Prefer unit-level coverage around file signature/watcher helper and reload apply behavior with fakes/mocks.
+
+### Risks & Mitigations
+
+- **Partial writes:** debounce and catch parse errors; keep current config on failure.
+- **GUI-thread safety:** perform only final state mutation and Tk scheduling on the GUI thread.
+- **Config path switching:** because resolution prefers top-level file over cache file, each successful load should
+  update the watched path from `configured.path`.
+- **Duplicate reloads:** track last successfully applied file signature and ignore unchanged signatures.
+
+# Testing
+
+### Validation Approach
+
+Use unit-level tests where possible and manual validation notes for GUI behavior that is hard to automate headlessly.
+
+### Key Scenarios
+
+- Initial load watches the resolved top-level config when it exists.
+- Initial load watches `cache/config/accessory_config.json` when no top-level file exists.
+- A valid changed file causes a new `ConfiguredAccessorySet` to be loaded and applied.
+- Invalid JSON logs an error and leaves the previous accessory set intact.
+- Multiple quick changes trigger at most one applied reload after debounce.
+- Shutdown prevents further reload callbacks.
+
+### Project Validation Commands
+
+- For changed Python files: `../bin/python -m ruff format --check <changed Python files>`
+- Full test suite: `../bin/python -m pytest`
+
+# Delivery Steps
+
+### ✓ Step 1: split-accessory-reload-into-load-and-apply
+
+`EngineGui` has a reusable reload path where config parsing can happen off the GUI thread and GUI mutation is isolated.
+
+- Extract the existing state-replacement logic from `reload_configured_accessories()` into a helper that accepts an
+  already-built `ConfiguredAccessorySet`.
+- Keep adapter/provider reset, accessory view clearing, overlay discard, catalog reset, options rebuild, and overlay
+  prewarm in the GUI-side helper.
+- Add a background-safe load helper that calls
+  `ConfiguredAccessorySet.from_file(self._accessory_config_file, verify=True)` and logs failures without replacing
+  current state.
+- Update the manual Admin panel reload path to use the refactored helpers while preserving the same visible behavior.
+
+### ✓ Step 2: add-background-config-change-watcher
+
+`EngineGui` detects changes to the resolved accessory config file without polling or parsing in the GUI thread.
+
+- Add watcher state to `EngineGui`, including last applied file signature, debounce timing, and a shutdown-aware
+  background loop or executor task.
+- Watch the effective path from `self.accessories.path`, respecting the existing top-level-then-cache resolution
+  behavior.
+- Compare file signatures using existence, modification time, and size rather than reading file contents on every poll.
+- On a stable changed signature, load a fresh `ConfiguredAccessorySet` in the background and schedule the GUI-side apply
+  helper.
+
+### ✓ Step 3: wire-watcher-lifecycle-and-path-updates
+
+The automatic reload watcher starts after GUI initialization and stops cleanly with the window.
+
+- Start the watcher after the initial config load/UI setup is complete, avoiding startup reload duplication.
+- After every successful reload, update the watched path/signature from the newly loaded `ConfiguredAccessorySet.path`.
+- Ensure pending background completions and scheduled GUI callbacks check `self._shutdown_flag` before applying changes.
+- Stop/join or otherwise cancel watcher activity from `destroy_gui()` alongside existing GUI cleanup.
+
+### ✓ Step 4: validate-reload-behavior
+
+The change is covered by focused tests or reliable validation for change detection and failure handling.
+
+- Add tests for file signature detection and debounce behavior if the watcher is factored into a testable helper.
+- Add tests or mocks confirming invalid config does not replace the current configured accessory set.
+- Run the required formatter check for changed Python files.
+- Run the full unit test suite with `../bin/python -m pytest`.