Adopt uv

.github/workflows/test-suite.yml

@@ -18,10 +18,12 @@ jobs:
 
     steps:
       - uses: "actions/checkout@v4"
-      - uses: "actions/setup-python@v6"
+      - name: Install uv (official Astral action)
+        uses: astral-sh/setup-uv@v5
         with:
-          python-version: "${{ matrix.python-version }}"
-          allow-prereleases: true
+          version: "0.9.13"
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
       - name: "Install dependencies"
         run: "scripts/install"
       - name: "Run linting checks"

pyproject.toml

@@ -64,6 +64,40 @@ Documentation = "https://www.python-httpx.org"
 Homepage = "https://github.com/encode/httpx"
 Source = "https://github.com/encode/httpx"
 
+[dependency-groups]
+dev = [
+    # Install httpx with all optional dependencies
+    { include-group = "test" },
+    { include-group = "docs" },
+    { include-group = "package" },
+    { include-group = "lint" },
+]
+test = [
+    # Optional charset auto-detection (used in test cases)
+    "chardet==5.2.0",
+    # Testing dependencies
+    "coverage[toml]==7.10.6",
+    "cryptography==45.0.7",
+    "pytest==8.4.1",
+    "trio==0.31.0",
+    "trio-typing==0.10.0",
+    "trustme==1.2.1",
+    "uvicorn==0.35.0",
+]
+docs = [
+    "mkdocs==1.6.1",
+    "mkautodoc==0.2.0",
+    "mkdocs-material==9.6.18",
+]
+package = [
+    "build==1.3.0",
+    "twine==6.1.0",
+]
+lint = [
+    "mypy==1.17.1",
+    "ruff==0.12.11",
+]
+
 [tool.hatch.version]
 path = "httpx/__version__.py"
 

scripts/build

@@ -1,13 +1,7 @@
 #!/bin/sh -e
 
-if [ -d 'venv' ] ; then
-    PREFIX="venv/bin/"
-else
-    PREFIX=""
-fi
-
 set -x
 
-${PREFIX}python -m build
-${PREFIX}twine check dist/*
-${PREFIX}mkdocs build
+uv run python -m build
+uv run twine check dist/*
+uv run mkdocs build

scripts/check

@@ -1,14 +1,16 @@
 #!/bin/sh -e
 
-export PREFIX=""
-if [ -d 'venv' ] ; then
-    export PREFIX="venv/bin/"
-fi
 export SOURCE_FILES="httpx tests"
 
 set -x
 
 ./scripts/sync-version
-${PREFIX}ruff format $SOURCE_FILES --diff
-${PREFIX}mypy $SOURCE_FILES
-${PREFIX}ruff check $SOURCE_FILES
+
+echo "==> Checking formatting…"
+uv run ruff format $SOURCE_FILES --diff
+
+echo "==> Running type checks and linting…"
+uv run mypy $SOURCE_FILES
+
+echo "==> Running linting checks…"
+uv run ruff check $SOURCE_FILES

scripts/coverage

@@ -1,11 +1,7 @@
 #!/bin/sh -e
 
-export PREFIX=""
-if [ -d 'venv' ] ; then
-    export PREFIX="venv/bin/"
-fi
 export SOURCE_FILES="httpx tests"
 
 set -x
 
-${PREFIX}coverage report --show-missing --skip-covered --fail-under=100
+uv run coverage report --show-missing --skip-covered --fail-under=100

scripts/docs

@@ -1,10 +1,5 @@
 #!/bin/sh -e
 
-export PREFIX=""
-if [ -d 'venv' ] ; then
-    export PREFIX="venv/bin/"
-fi
-
 set -x
 
-${PREFIX}mkdocs serve
+uv run mkdocs serve

scripts/install

@@ -1,19 +1,4 @@
 #!/bin/sh -e
 
-# Use the Python executable provided from the `-p` option, or a default.
-[ "$1" = "-p" ] && PYTHON=$2 || PYTHON="python3"
-
-REQUIREMENTS="requirements.txt"
-VENV="venv"
-
-set -x
-
-if [ -z "$GITHUB_ACTIONS" ]; then
-    "$PYTHON" -m venv "$VENV"
-    PIP="$VENV/bin/pip"
-else
-    PIP="pip"
-fi
-
-"$PIP" install -U pip
-"$PIP" install -r "$REQUIREMENTS"
+echo "==> Installing Python dependencies…"
+uv sync --all-extras

scripts/lint

@@ -1,12 +1,11 @@
 #!/bin/sh -e
 
-export PREFIX=""
-if [ -d 'venv' ]; then
-    export PREFIX="venv/bin/"
-fi
 export SOURCE_FILES="httpx tests"
 
 set -x
 
-${PREFIX}ruff check --fix $SOURCE_FILES
-${PREFIX}ruff format $SOURCE_FILES
+echo "==> Running linting checks…"
+uv run ruff check --fix $SOURCE_FILES
+
+echo "==> Formatting source code…"
+uv run ruff format $SOURCE_FILES

scripts/publish

@@ -2,11 +2,6 @@
 
 VERSION_FILE="httpx/__version__.py"
 
-if [ -d 'venv' ] ; then
-    PREFIX="venv/bin/"
-else
-    PREFIX=""
-fi
 
 if [ ! -z "$GITHUB_ACTIONS" ]; then
   git config --local user.email "41898282+github-actions[bot]@users.noreply.github.com"
@@ -22,5 +17,5 @@ fi
 
 set -x
 
-${PREFIX}twine upload dist/*
-${PREFIX}mkdocs gh-deploy --force
+uv run twine upload dist/*
+uv run mkdocs gh-deploy --force

scripts/test

@@ -1,17 +1,12 @@
 #!/bin/sh
 
-export PREFIX=""
-if [ -d 'venv' ] ; then
-    export PREFIX="venv/bin/"
-fi
-
 set -ex
 
 if [ -z $GITHUB_ACTIONS ]; then
     scripts/check
 fi
 
-${PREFIX}coverage run -m pytest "$@"
+uv run coverage run -m pytest "$@"
 
 if [ -z $GITHUB_ACTIONS ]; then
     scripts/coverage