let uv handle tox top level

sl0thentr0py · sl0thentr0py · commit 8e1e88980ca9 · 2026-05-27T15:12:31.000+02:00
diff --git a/.github/workflows/test-integrations-agents.yml b/.github/workflows/test-integrations-agents.yml
@@ -48,16 +48,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test openai_agents
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-ai-workflow.yml b/.github/workflows/test-integrations-ai-workflow.yml
@@ -48,16 +48,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test langchain-base
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-ai.yml b/.github/workflows/test-integrations-ai.yml
@@ -48,16 +48,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test anthropic
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-cloud.yml b/.github/workflows/test-integrations-cloud.yml
@@ -52,16 +52,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test aws_lambda
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-common.yml b/.github/workflows/test-integrations-common.yml
@@ -48,16 +48,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test common
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-dbs.yml b/.github/workflows/test-integrations-dbs.yml
@@ -67,16 +67,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test asyncpg
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-flags.yml b/.github/workflows/test-integrations-flags.yml
@@ -48,16 +48,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test launchdarkly
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-gevent.yml b/.github/workflows/test-integrations-gevent.yml
@@ -48,16 +48,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test gevent
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-graphql.yml b/.github/workflows/test-integrations-graphql.yml
@@ -48,16 +48,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test ariadne
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-mcp.yml b/.github/workflows/test-integrations-mcp.yml
@@ -48,16 +48,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test mcp
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-misc.yml b/.github/workflows/test-integrations-misc.yml
@@ -48,16 +48,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test loguru
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-network.yml b/.github/workflows/test-integrations-network.yml
@@ -48,16 +48,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test grpc
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-tasks.yml b/.github/workflows/test-integrations-tasks.yml
@@ -64,16 +64,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test arq
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-web-1.yml b/.github/workflows/test-integrations-web-1.yml
@@ -65,16 +65,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test django
         run: |
           set -x # print commands that are executed
diff --git a/.github/workflows/test-integrations-web-2.yml b/.github/workflows/test-integrations-web-2.yml
@@ -48,16 +48,15 @@ jobs:
         if: ${{ matrix.python-version == '3.6' || matrix.python-version == '3.7' }}
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
       - name: Test aiohttp
         run: |
           set -x # print commands that are executed
diff --git a/.gitignore b/.gitignore
@@ -3,7 +3,6 @@
 *.egg
 *.db
 *.pid
-.python-version
 .coverage
 .coverage-sentry*
 coverage.xml
diff --git a/.python-version b/.python-version
@@ -0,0 +1 @@
+3.14
diff --git a/AGENTS.md b/AGENTS.md
@@ -2,8 +2,8 @@
 
 ## Tox
 
-- Always run tox from the main `tox.venv`
-- If there is no `tox.venv`, create one with `python -m venv tox.venv`, activate it and run `pip install tox tox-uv`
+- Run tox via uv: `uv run -- tox -e <env>`
+- `tox` + `tox-uv` are declared as the project's default dev dependencies in `pyproject.toml`, so uv installs them automatically into `.venv`.
 
 ## Package Manager
 
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,3 +1,15 @@
+#
+# Project dev dependencies (PEP 735 `dev` group, installed by default).
+# Run tox with: `uv run -- tox -e <env>`
+#
+
+[dependency-groups]
+dev = [
+    "tox",
+    "tox-uv",
+    "coverage[toml]",
+]
+
 #
 # Tool: Coverage
 #
diff --git a/scripts/runtox.sh b/scripts/runtox.sh
@@ -27,4 +27,10 @@ if [ -z "${ENV}" ]; then
     exit 0
 fi
 
-exec $TOXPATH -p auto -o -e "$ENV" -- "${@:2}"
+# Django ASGI tests deadlock under tox's parallel env scheduler when multiple
+# Django envs share the same Postgres service container. Run those serially.
+if [[ "$searchstring" == *-django* ]]; then
+    exec $TOXPATH -e "$ENV" -- "${@:2}"
+else
+    exec $TOXPATH -p auto -o -e "$ENV" -- "${@:2}"
+fi
diff --git a/scripts/split_tox_gh_actions/templates/test_group.jinja b/scripts/split_tox_gh_actions/templates/test_group.jinja
@@ -79,16 +79,15 @@
         run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
 
       - name: Setup Test Env
-        # Pin tox + coverage to uv-managed Python 3.13 even when the job sets
-        # UV_PYTHON_PREFERENCE=only-system for 3.6/3.7 (which only applies to tox-uv at test time).
+        # The UV_PYTHON_PREFERENCE=only-system override for 3.6/3.7 only applies to
+        # tox-uv at test time, not to the workspace venv itself.
         env:
           UV_PYTHON_PREFERENCE: managed
         run: |
-          uv tool install --python 3.13 --with tox-uv tox
-          uv tool install --python 3.13 "coverage[toml]"
+          uv sync
       - name: Erase coverage
         run: |
-          coverage erase
+          uv run coverage erase
 
       {% for framework in frameworks %}
       - name: Test {{ framework }}
diff --git a/uv.lock b/uv.lock
