Use tox for DLCLive compatibility in CI

Replace ad-hoc DLCLive installs in the GitHub Actions job with tox-based testenvs. The workflow fixes Python to 3.12, installs required Qt/OpenGL runtime libs on Ubuntu, installs tox and tox-gh-actions, and runs tox -e matrix.tox_env. tox.ini was extended with dlclive-pypi and dlclive-github testenvs (pypi pinned and GitHub main respectively) to run the compatibility pytest, and the new envs were added to env_list to allow local and CI execution.

Author: C-Achard

.github/workflows/testing-ci.yml

@@ -81,38 +81,41 @@ jobs:
           fail_ci_if_error: false
 
   dlclive-compat:
-    name: DLCLive Compatibility • ${{ matrix.label }} • py${{ matrix.python }}
+    name: DLCLive Compatibility • ${{ matrix.label }}
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        python: ['3.12']
         include:
           - label: pypi-1.1
-            dlclive_spec: deeplabcut-live==1.1
+            tox_env: dlclive-pypi
           - label: github-main
-            dlclive_spec: git+https://github.com/DeepLabCut/DeepLabCut-live.git@main
+            tox_env: dlclive-github
 
     steps:
-      - name: Checkout
-        uses: actions/checkout@v6
+      - uses: actions/checkout@v6
 
-      - name: Set up Python
-        uses: actions/setup-python@v6
+      - uses: actions/setup-python@v6
         with:
-          python-version: ${{ matrix.python }}
+          python-version: '3.12'
           cache: 'pip'
 
-      - name: Install package + test dependencies
+      - name: Install Qt/OpenGL runtime deps (Ubuntu)
         run: |
-          python -m pip install -U pip wheel
-          python -m pip install -e .[test]
+          sudo apt-get update
+          sudo apt-get install -y \
+            libegl1 \
+            libgl1 \
+            libopengl0 \
+            libxkbcommon-x11-0 \
+            libxcb-cursor0
 
-      - name: Install matrix DLCLive build
+      - name: Install tox
         run: |
-          python -m pip install --upgrade --force-reinstall "${{ matrix.dlclive_spec }}"
-          python -m pip show deeplabcut-live
+          python -m pip install -U pip wheel
+          python -m pip install -U tox tox-gh-actions
 
-      - name: Run DLCLive compatibility tests
+      - name: Run DLCLive compatibility tests via tox
+        shell: bash -eo pipefail {0}
         run: |
-          python -m pytest -m dlclive_compat tests/compat/test_dlclive_package_compat.py -q
+          tox -e ${{ matrix.tox_env }} -q

tox.ini

@@ -2,6 +2,8 @@
 min_version = 4.0
 env_list =
     py{310,311,312}
+    dlclive-pypi
+    dlclive-github
     lint
 isolated_build = true
 skip_missing_interpreters = true
@@ -45,6 +47,22 @@ passenv =
 ;     ruff check .
 ;     ruff format --check .
 
+# Run locally : tox -e dlclive-pypi
+[testenv:dlclive-pypi]
+description = DLCLive compatibility tests against specific PyPi release
+deps =
+    deeplabcut-live==1.1
+commands =
+    pytest -m dlclive_compat tests/compat/test_dlclive_package_compat.py -q
+
+# Run locally : tox -e dlclive-github
+[testenv:dlclive-github]
+description = DLCLive compatibility tests against GitHub main
+deps =
+    git+https://github.com/DeepLabCut/DeepLabCut-live.git@main
+commands =
+    pytest -m dlclive_compat tests/compat/test_dlclive_package_compat.py -q
+
 [gh-actions]
 python =
     3.10: py310