Use pytest-xdist

.cspell/library_terms.txt

@@ -179,6 +179,7 @@ warpfunctions
 weathersit
 windspeed
 workingday
+worksteal
 xlabel
 xlim
 xscale

.github/workflows/coverage.yml

@@ -48,7 +48,7 @@ jobs:
       - name: Debug - uv pip freeze
         run: uv pip freeze
       - name: Assess coverage of unit tests
-        run: uv run pytest tests/units tests/test_doctests.py --cov
+        run: uv run pytest tests/units tests/test_doctests.py --cov -n auto --dist worksteal
       - name: Extract total coverage percentage
         id: cov
         run: |

.github/workflows/release.yml

@@ -116,10 +116,10 @@ jobs:
       - name: Debug - uv pip freeze
         run: uv pip freeze
       - name: Test with pytest
-        run: uv run pytest tests --ignore=tests/test_examples.py
+        run: uv run pytest tests --ignore=tests/test_examples.py -n auto --dist worksteal
       # The example notebooks are slow, so only run if all other tests pass.
       - name: Test example notebooks
-        run: uv run pytest tests/test_examples.py
+        run: uv run pytest tests/test_examples.py -n auto --dist worksteal
   release-github:
     name: Create GitHub draft release
     needs: test

.github/workflows/unittests.yml

@@ -66,6 +66,8 @@ jobs:
         --ignore=tests/test_examples.py
         -W "error::vanguard.utils.UnseededRandomWarning"
         -m "no_beartype"
+        -n auto
+        --dist worksteal
       if: matrix.python-version == '3.13'
     - name: Test with pytest (and type checking)
       run: >
@@ -74,12 +76,16 @@ jobs:
         -W "error::vanguard.utils.UnseededRandomWarning"
         -m "not no_beartype"
         --beartype-packages="vanguard"
+        -n auto
+        --dist worksteal
       if: matrix.python-version == '3.13'
     - name: Run all tests
       run: >
         uv run pytest
         --ignore=tests/test_examples.py
         -W "error::vanguard.utils.UnseededRandomWarning"
+        -n auto
+        --dist worksteal
       if: matrix.python-version != '3.13'
     - name: Minimize UV cache
       run: uv cache prune --ci

.github/workflows/unittests_lowest.yml

@@ -71,6 +71,8 @@ jobs:
         uv run --frozen --no-dev pytest
         --ignore=tests/test_examples.py
         -W "error::vanguard.utils.UnseededRandomWarning"
+        -n auto
+        --dist worksteal
     - name: Minimize UV cache
       run: uv cache prune --ci
       if: always()

pyproject.toml

@@ -61,6 +61,7 @@ test = [
     "tqdm>=4",  # for notebook tests
     "pytest-beartype>=0.1",
     "pytest-cov>=5",
+    "pytest-xdist>=3.6.1",
     "pytest>=8.3.3",
     "beartype>=0.19, !=0.20",
 ]