Add CI, tox and coverage config

Add GitHub Actions CI workflow to run unit and smoke tests across Ubuntu, macOS, and Windows for Python 3.10–3.12, cache tox environments, append coverage summary, and upload coverage to Codecov. Introduce tox.ini to standardize test and lint environments (py310/311/312 plus a ruff lint env), run pytest excluding hardware-marked tests, and set CI-friendly environment variables. Add .coveragerc to configure coverage (branch, source dlclivegui, and omit hardware SDK shim backends). Update pyproject.toml test markers to add a "hardware" marker and comment out the previous "slow" marker.

Author: C-Achard

.coveragerc

@@ -0,0 +1,10 @@
+
+# .coveragerc
+[run]
+branch = True
+source = dlclivegui
+omit =
+    # omit only the parts that are pure passthrough shims to SDKs
+    dlclivegui/cameras/backends/basler_backend.py
+    dlclivegui/cameras/backends/gentl_backend.py
+    # dlclivegui/cameras/backends/aravis_backend.py

.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+
+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: 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
+        uses: codecov/codecov-action@v5
+        with:
+          files: ./coverage.xml
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: true

pyproject.toml

@@ -94,7 +94,8 @@ markers = [
     "unit: Unit tests for individual components",
     "integration: Integration tests for component interaction",
     "functional: Functional tests for end-to-end workflows",
-    "slow: Tests that take a long time to run",
+    "hardware: Tests that require specific hardware, notable camera backends",
+    # "slow: Tests that take a long time to run",
     "gui: Tests that require GUI interaction",
 ]
 

tox.ini

@@ -0,0 +1,49 @@
+[tox]
+min_version = 4.0
+env_list =
+    py{310,311,312}
+    lint
+isolated_build = true
+skip_missing_interpreters = true
+
+[testenv]
+description = Unit + smoke tests (exclude hardware) with coverage
+package = wheel
+extras = test
+
+# Keep behavior aligned with your GitHub Actions job:
+commands =
+    pytest -m "not hardware" --maxfail=1 --disable-warnings \
+        --cov=dlclivegui --cov-report=xml --cov-report=term-missing {posargs}
+
+# Helpful defaults for headless CI runs (Qt/OpenCV):
+setenv =
+    PYTHONWARNINGS = default
+    QT_QPA_PLATFORM = offscreen
+    # Can help avoid some Windows/OpenCV capture backend flakiness when tests touch video I/O:
+    OPENCV_VIDEOIO_PRIORITY_MSMF = 0
+
+# Let CI variables pass through (useful for debugging and some GUI/headless setups):
+passenv =
+    CI
+    GITHUB_*
+    DISPLAY
+    WAYLAND_DISPLAY
+    XDG_RUNTIME_DIR
+
+[testenv:lint]
+description = Ruff linting/format checks (matches pyproject.toml config)
+skip_install = true
+deps =
+    ruff
+commands =
+    ruff check .
+    ruff format --check .
+
+# Optional helper if you use tox-gh-actions to map GitHub's python-version to tox envs.
+# Requires: pip install tox-gh-actions
+[gh-actions]
+python =
+    3.10: py310
+    3.11: py311
+    3.12: py312, lint