Migrate development workflow to uv lockfile

.github/workflows/check_example_nbs.yml

@@ -11,31 +11,24 @@ on:
       - "examples/**/*.py"
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   convert-to-nbs:
     name: "Check Example Notebooks"
     runs-on: ubuntu-22.04
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
-      - name: Set Up Python
-        uses: actions/setup-python@v5
+        uses: actions/checkout@v6
+      - name: Set Up uv
+        uses: astral-sh/setup-uv@v9.0.0
         with:
-          python-version: 3.7
+          version: 0.12.3
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
       - name: Set Up Environment
-        run: |
-          make install-uv reset-venv
-          source .venv/bin/activate
-          make install-pinned-notebook
-      - name: Convert using Script
-        run: |
-          source .venv/bin/activate
-          make generate-example-notebooks
-      - name: Check for diff
-        run: |
-          source .venv/bin/activate
-          git add examples/notebooks/
-          if ! git diff --cached --exit-code; then
-            echo "Notebooks have changed! Please run 'make generate-example-notebooks' and commit the changes."
-            exit 1
-          fi
+        run: make install-notebook
+      - name: Check Notebooks Are Up To Date
+        run: make test-notebooks

.github/workflows/release_pypi.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-22.04
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
         fetch-depth: 0
     - name: Checkout latest release tag
@@ -21,18 +21,25 @@ jobs:
         LATEST_TAG=$(git describe --tags `git rev-list --tags --max-count=1`)
         git checkout $LATEST_TAG
         echo "tag_name=$LATEST_TAG" >> $GITHUB_OUTPUT;
-    - name: Set up Python 3.12
-      uses: actions/setup-python@v5
+    - name: Set Up uv
+      uses: astral-sh/setup-uv@v9.0.0
       with:
-        python-version: "3.12"
+        version: 0.12.3
+        enable-cache: true
+        cache-dependency-glob: "uv.lock"
+    # This job builds the release tag that was checked out above, not the default
+    # branch, so it deliberately avoids `make` targets and dependency groups: those
+    # only exist in the tag's own Makefile/pyproject.toml. `uv build` needs nothing
+    # but [build-system], and `uvx` installs twine into a throwaway environment.
     - name: Build and release
       id: build_and_release
+      env:
+        TWINE_USERNAME: ${{ secrets.PYPI_USER_NAME }}
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
       run: |
-        pip3 install wheel
-        pip3 install twine
-        pip3 install build
-        make dist
-        twine upload -u ${{ secrets.PYPI_USER_NAME }} -p ${{ secrets.PYPI_PASSWORD }} dist/*
+        uv build
+        ls -l dist
+        uvx twine upload dist/*
     - name: Convert success/failure strings to emojis
       id: emoji_status
       run: |

.github/workflows/test.yml

@@ -8,15 +8,22 @@ on:
   merge_group:
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  LIGHTLY_SERVER_LOCATION: "localhost:-1"
+
 jobs:
   detect-code-changes:
     name: Detect Code Changes
     runs-on: ubuntu-22.04
     outputs:
       run-tests: ${{ steps.filter.outputs.run-tests }}
     steps:
-      - uses: actions/checkout@v4
-      - uses: dorny/paths-filter@v3
+      - uses: actions/checkout@v6
+      - uses: dorny/paths-filter@v4
         id: filter
         with:
           list-files: shell
@@ -31,39 +38,19 @@ jobs:
     needs: detect-code-changes
     if: needs.detect-code-changes.outputs.run-tests == 'true'
     runs-on: ubuntu-22.04
-    strategy:
-      matrix:
-        python: ["3.7", "3.12"]
-
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
-      - name: Hack to get setup-python to work on nektos/act
-        run: |
-          if [ ! -f "/etc/lsb-release" ] ; then
-            echo "DISTRIB_RELEASE=18.04" > /etc/lsb-release
-          fi
-      - name: Set Up Python
-        uses: actions/setup-python@v5
+        uses: actions/checkout@v6
+      - name: Set Up uv
+        uses: astral-sh/setup-uv@v9.0.0
         with:
-          python-version: ${{ matrix.python }}
+          version: 0.12.3
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
       - name: Set Up Environment
-        run: |
-          make install-uv reset-venv
-          source .venv/bin/activate
-          make install-pinned-extras-${{ matrix.python }}
-      - name: Run Pytest (Python 3.7)
-        if: matrix.python == '3.7'
-        run: |
-          source .venv/bin/activate
-          export LIGHTLY_SERVER_LOCATION="localhost:-1"
-          python -m pytest -s -v --runslow --ignore=./lightly/openapi_generated/
-      - name: Run Pytest (Python 3.12)
-        if: matrix.python == '3.12'
-        run: |
-          source .venv/bin/activate
-          export LIGHTLY_SERVER_LOCATION="localhost:-1"
-          python -m pytest -s -v --runslow --ignore=./lightly/openapi_generated/
+        run: make install-maximal-extras
+      - name: Run Pytest
+        run: make test-maximal-extras
 
   distributed-tests:
     name: Distributed Tests
@@ -72,26 +59,16 @@ jobs:
     runs-on: ubuntu-22.04
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
-      - name: Hack to get setup-python to work on nektos/act
-        run: |
-          if [ ! -f "/etc/lsb-release" ] ; then
-            echo "DISTRIB_RELEASE=18.04" > /etc/lsb-release
-          fi
-      - name: Set Up Python
-        uses: actions/setup-python@v5
+        uses: actions/checkout@v6
+      - name: Set Up uv
+        uses: astral-sh/setup-uv@v9.0.0
         with:
-          python-version: "3.12"
+          version: 0.12.3
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
       - name: Set Up Environment
-        run: |
-          make install-uv reset-venv
-          source .venv/bin/activate
-          make install-pinned-extras-3.12
-      # Run the @pytest.mark.DDP tests on the shared gloo pool (real multi-rank
-      # collective, not mocked). USE_PYTEST_POOL enables it; off by default. See #1982.
+        run: make install-maximal-extras
+      # Runs the @pytest.mark.DDP tests on the shared gloo pool (real multi-rank
+      # collective, not mocked). See #1982.
       - name: Run Distributed Tests (gloo pool)
-        run: |
-          source .venv/bin/activate
-          export LIGHTLY_SERVER_LOCATION="localhost:-1"
-          export USE_PYTEST_POOL=1
-          python -m pytest -s -v --runslow -m DDP --ignore=./lightly/openapi_generated/
+        run: make test-distributed

.github/workflows/test_api_deps_only.yml

@@ -1,4 +1,3 @@
-
 name: Install API Dependencies Only
 
 on:
@@ -9,15 +8,22 @@ on:
   merge_group:
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  LIGHTLY_SERVER_LOCATION: "localhost:-1"
+
 jobs:
   detect-code-changes:
     name: Detect Code Changes
     runs-on: ubuntu-22.04
     outputs:
       run-tests: ${{ steps.filter.outputs.run-tests }}
     steps:
-      - uses: actions/checkout@v4
-      - uses: dorny/paths-filter@v3
+      - uses: actions/checkout@v6
+      - uses: dorny/paths-filter@v4
         id: filter
         with:
           list-files: shell
@@ -32,22 +38,16 @@ jobs:
     needs: detect-code-changes
     if: needs.detect-code-changes.outputs.run-tests == 'true'
     runs-on: ubuntu-22.04
-
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
-      - name: Set Up Python
-        uses: actions/setup-python@v5
+        uses: actions/checkout@v6
+      - name: Set Up uv
+        uses: astral-sh/setup-uv@v9.0.0
         with:
-          python-version: "3.12"
+          version: 0.12.3
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
       - name: Set Up Environment
-        run: |
-          make install-uv reset-venv
-          source .venv/bin/activate
-          make install-api-only
+        run: make install-api-only
       - name: Test API Client
-        run: |
-          source .venv/bin/activate
-          # Test if ApiWorkflowClient can be created.
-          export LIGHTLY_SERVER_LOCATION="localhost:-1"
-          python -c "from lightly.api import ApiWorkflowClient; ApiWorkflowClient(token='abc')"
+        run: make test-api-only

.github/workflows/test_code_format.yml

@@ -8,35 +8,30 @@ on:
   merge_group:
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   test:
     name: Check
     runs-on: ubuntu-22.04
-    strategy:
-      matrix:
-        python: ["3.7", "3.12"]
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v4
-    - name: Hack to get setup-python to work on nektos/act
-      run: |
-        if [ ! -f "/etc/lsb-release" ] ; then
-          echo "DISTRIB_RELEASE=18.04" > /etc/lsb-release
-        fi
-    - name: Set Up Python
-      uses: actions/setup-python@v5
+      uses: actions/checkout@v6
+    - name: Set Up uv
+      uses: astral-sh/setup-uv@v9.0.0
       with:
-        python-version: ${{ matrix.python }}
+        version: 0.12.3
+        enable-cache: true
+        cache-dependency-glob: "uv.lock"
     - name: Set Up Environment
-      run: |
-        make install-uv reset-venv
-        source .venv/bin/activate
-        make install-pinned-extras
+      run: make install-maximal
+    # ruff and mypy are version-pinned in the dev dependency group, so their results do
+    # not depend on the Python version. Checking a single environment is enough.
+    - name: Check Lockfile
+      run: make lock-check
     - name: Run Format Check
-      run: |
-        source .venv/bin/activate
-        make format-check
+      run: make format-check
     - name: Run Type Check
-      run: |
-        source .venv/bin/activate
-        make type-check
+      run: make type-check

.github/workflows/test_minimal_deps.yml

@@ -8,15 +8,22 @@ on:
   merge_group:
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  LIGHTLY_SERVER_LOCATION: "localhost:-1"
+
 jobs:
   detect-code-changes:
     name: Detect Code Changes
     runs-on: ubuntu-22.04
     outputs:
       run-tests: ${{ steps.filter.outputs.run-tests }}
     steps:
-      - uses: actions/checkout@v4
-      - uses: dorny/paths-filter@v3
+      - uses: actions/checkout@v6
+      - uses: dorny/paths-filter@v4
         id: filter
         with:
           list-files: shell
@@ -33,23 +40,18 @@ jobs:
     runs-on: ubuntu-22.04
     strategy:
       matrix:
-        python: ["3.7"]
+        # Tests the lowest supported dependency versions on the lowest supported
+        # Python version. uv provisions the interpreter, so no setup-python needed.
         dependencies: ["minimal", "minimal-extras"]
     steps:
-      - uses: actions/checkout@v4
-      - name: Set Up Python
-        uses: actions/setup-python@v5
+      - uses: actions/checkout@v6
+      - name: Set Up uv
+        uses: astral-sh/setup-uv@v9.0.0
         with:
-          python-version: ${{ matrix.python }}
+          version: 0.12.3
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
       - name: Set Up Environment
-        run: |
-          # Install system dependencies required by PyAV on CI.
-          make install-av-system-deps
-          make install-uv reset-venv
-          source .venv/bin/activate
-          make install-${{ matrix.dependencies }}
+        run: make install-${{ matrix.dependencies }}
       - name: Run Tests
-        run: |
-          source .venv/bin/activate
-          export LIGHTLY_SERVER_LOCATION="localhost:-1"
-          python -m pytest -s -v --runslow
+        run: make test-${{ matrix.dependencies }}