Upgrade PySide6 multi-camera GUI

.coveragerc

@@ -0,0 +1,6 @@
+
+# .coveragerc
+[run]
+branch = True
+source = dlclivegui
+# omit =

.github/workflows/format.yml

@@ -0,0 +1,61 @@
+name: pre-commit (PR only on changed files)
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  detect_changes:
+    runs-on: ubuntu-latest
+    outputs:
+      changed: ${{ steps.changed_files.outputs.changed }}
+
+    steps:
+      - name: Checkout full history
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Detect changed files
+        id: changed_files
+        run: |
+          git fetch origin ${{ github.base_ref }}
+          CHANGED_FILES=$(git diff --name-only origin/${{ github.base_ref }}...HEAD)
+
+          {
+            echo "changed<<EOF"
+            echo "$CHANGED_FILES"
+            echo "EOF"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Show changed files
+        run: |
+          echo "Changed files:"
+          echo "${{ steps.changed_files.outputs.changed }}"
+
+  precommit:
+    needs: detect_changes
+    runs-on: ubuntu-latest
+    if: ${{ needs.detect_changes.outputs.changed != '' }}
+
+    steps:
+      - name: Checkout PR branch
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          ref: ${{ github.head_ref }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install pre-commit
+        run: pip install pre-commit
+
+      - name: Run pre-commit (CI check-only stage) on changed files
+        env:
+          CHANGED_FILES: ${{ needs.detect_changes.outputs.changed }}
+        run: |
+          mapfile -t files <<< "$CHANGED_FILES"
+          pre-commit run --hook-stage manual --files "${files[@]}" --show-diff-on-failure

.github/workflows/python-package.yml

@@ -0,0 +1,112 @@
+name: Build, validate & Release
+
+on:
+  push:
+    tags: [ 'v*.*.*' ]
+  pull_request:
+    branches: [ main, master ]
+    types: [ labeled, opened, edited, synchronize, reopened ]
+
+jobs:
+  test:
+    name: Test / smoke (matrix)
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ "3.10", "3.11", "3.12" ]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Qt/OpenGL runtime deps (Ubuntu)
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libegl1 \
+            libgl1 \
+            libopengl0 \
+            libxkbcommon-x11-0 \
+            libxcb-cursor0
+
+      - name: Install tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine wheel "packaging>=24.2"
+
+      - name: Build distributions (sdist + wheel)
+        run: python -m build
+
+      - name: Inspect dist
+        run: |
+          ls -lah dist/
+          echo "sdist contents (first ~200 entries):"
+          tar -tf dist/*.tar.gz | sed -n '1,200p'
+
+      - name: Twine metadata & README check
+        run: python -m twine check dist/*
+
+      - name: Install from wheel & smoke test
+        run: |
+          python -m pip install dist/*.whl
+          python - <<'PY'
+          import importlib
+          pkg_name = "dlclivegui"
+          m = importlib.import_module(pkg_name)
+          print("Imported:", m.__name__, "version:", getattr(m, "__version__", "n/a"))
+          PY
+
+          if ! command -v dlclivegui >/dev/null 2>&1; then
+          echo "CLI entry point 'dlclivegui' not found in PATH; skipping CLI smoke test."
+          else
+          if command -v dlclivegui >/dev/null 2>&1; then
+            echo "Running 'dlclivegui --help' smoke test..."
+            if ! dlclivegui --help >/dev/null 2>&1; then
+              echo "::error::'dlclivegui --help' failed; this indicates a problem with the installed CLI package."
+              exit 1
+            fi
+
+  build:
+    name: Build release artifacts (single)
+    runs-on: ubuntu-latest
+    needs: test
+    if: ${{ startsWith(github.ref, 'refs/tags/v') }}
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build distributions (sdist + wheel)
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine wheel "packaging>=24.2"
+          python -m build
+          python -m twine check dist/*
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI (OIDC)
+    runs-on: ubuntu-latest
+    needs: build
+    if: ${{ startsWith(github.ref, 'refs/tags/v') }}
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/testing-ci.yml

@@ -0,0 +1,77 @@
+name: CI
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+concurrency:
+  group: ci-${{ github.workflow }}-pr-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  unit:
+    name: Unit + Smoke (no hardware) • ${{ matrix.os }} • py${{ matrix.python }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python: ['3.10', '3.11', '3.12']
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python }}
+          cache: 'pip'
+
+      - name: Cache tox environments
+        uses: actions/cache@v4
+        with:
+          path: .tox
+          key: tox-${{ runner.os }}-${{ matrix.python }}-${{ hashFiles('pyproject.toml', 'tox.ini') }}
+          restore-keys: |
+            tox-${{ runner.os }}-py${{ matrix.python }}-
+
+
+      - name: Install tox
+        run: |
+          python -m pip install -U pip wheel
+          python -m pip install -U tox tox-gh-actions
+
+      - name: Install Qt/OpenGL runtime deps (Ubuntu)
+        if: startsWith(matrix.os, 'ubuntu')
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libegl1 \
+            libgl1 \
+            libopengl0 \
+            libxkbcommon-x11-0 \
+            libxcb-cursor0
+
+      - name: Run tests (exclude hardware) with coverage via tox
+        run: |
+          tox -q
+
+      - name: Append Coverage Summary to Job
+        if: always()
+        shell: bash
+        run: |
+          python -m pip install -U coverage
+          echo "## Coverage Summary" >> "$GITHUB_STEP_SUMMARY"
+          echo "" >> "$GITHUB_STEP_SUMMARY"
+          echo '```text' >> "$GITHUB_STEP_SUMMARY"
+          python -m coverage report -m >> "$GITHUB_STEP_SUMMARY" || true
+          echo '```' >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Upload coverage to Codecov # NOTE : may need to disable this if token is not setup
+        if: github.event_name == 'pull_request' && (github.base_ref == 'main' || github.base_ref == 'master')
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage.xml
+          fail_ci_if_error: false

.gitignore

@@ -1,10 +1,3 @@
-#####################
-### DLC Live Specific
-#####################
-
-*config*
-**test*
-
 ###################
 ### python standard
 ###################
@@ -116,3 +109,7 @@ venv.bak/
 
 # ide files
 .vscode
+
+!dlclivegui/config.py
+# uv package files
+uv.lock

.pre-commit-config.yaml

@@ -0,0 +1,61 @@
+default_stages: [pre-commit]
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      # These are safe to run in both local & CI (they don't require "fix vs check" split)
+      - id: check-added-large-files
+        stages: [pre-commit, manual]
+      - id: check-yaml
+        stages: [pre-commit, manual]
+      - id: check-toml
+        stages: [pre-commit, manual]
+      - id: check-merge-conflict
+        stages: [pre-commit, manual]
+
+      # These modify files. Run locally only (pre-commit stage).
+      - id: end-of-file-fixer
+        stages: [pre-commit]
+      - id: trailing-whitespace
+        stages: [pre-commit]
+
+  - repo: https://github.com/tox-dev/pyproject-fmt
+    rev: v2.15.2
+    hooks:
+      - id: pyproject-fmt
+        stages: [pre-commit]    # modifies -> local only
+
+  - repo: https://github.com/abravalheri/validate-pyproject
+    rev: v0.25
+    hooks:
+      - id: validate-pyproject
+        stages: [pre-commit, manual]
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.0
+    hooks:
+      # --------------------------
+      # LOCAL AUTOFIX (developers)
+      # --------------------------
+      - id: ruff-check
+        name: ruff-check (fix)
+        args: [--fix, --unsafe-fixes]
+        stages: [pre-commit]
+
+      - id: ruff-format
+        name: ruff-format (write)
+        stages: [pre-commit]
+
+      # --------------------------
+      # CI CHECK-ONLY (no writes)
+      # --------------------------
+      - id: ruff-check
+        name: ruff-check (ci)
+        args: [--output-format=github]
+        stages: [manual]
+
+      - id: ruff-format
+        name: ruff-format (ci)
+        args: [--check, --diff]
+        stages: [manual]