Optimize workflow cache

.github/workflows/build-docs.yml

@@ -6,6 +6,9 @@ on:
   pull_request:
 permissions: {}
 
+env:
+  UV_NO_SYNC: true
+
 jobs:
   changes:
     runs-on: ubuntu-latest
@@ -55,6 +58,7 @@ jobs:
         with:
           version: "latest-known"
           enable-cache: true
+          cache-suffix: docs
           cache-dependency-glob: |
             pyproject.toml
             uv.lock
@@ -92,6 +96,7 @@ jobs:
         with:
           version: "latest-known"
           enable-cache: true
+          cache-suffix: docs
           cache-dependency-glob: |
             pyproject.toml
             uv.lock

.github/workflows/bump-pre-commit-hooks.yml

@@ -7,6 +7,9 @@ on:
 
 permissions: {}
 
+env:
+  UV_NO_SYNC: true
+
 jobs:
   bump-pre-commit-hooks:
     if: github.repository_owner == 'fastapi'
@@ -34,6 +37,11 @@ jobs:
           cache-dependency-glob: |
             pyproject.toml
             uv.lock
+          cache-suffix: dev-all
+          # Disable saving cache as we install narrower set of dependencies than dev-all has.
+          save-cache: false
+      - name: Install dependencies
+        run: uv sync --locked --group dev
       - name: Bump pre-commit hooks
         run: uv run prek auto-update --freeze --cooldown-days 7
       - name: Get PR Submit token

.github/workflows/create-draft-release.yml

@@ -7,6 +7,9 @@ on:
 
 permissions: {}
 
+env:
+  UV_NO_SYNC: true
+
 jobs:
   create-draft-release:
     if: github.event.pull_request.merged == true && contains(github.event.pull_request.labels.*.name, 'release')
@@ -34,6 +37,14 @@ jobs:
         uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
         with:
           version: "latest-known"
+          cache-dependency-glob: |
+            pyproject.toml
+            uv.lock
+          cache-suffix: dev-all
+          # Disable saving cache as we install narrower set of dependencies than dev-all has.
+          save-cache: false
+      - name: Install dependencies
+        run: uv sync --locked --group dev
       - name: Extract release details
         id: release-details
         run: |

.github/workflows/deploy-docs.yml

@@ -8,6 +8,9 @@ on:
 
 permissions: {}
 
+env:
+  UV_NO_SYNC: true
+
 jobs:
   deploy-docs:
     runs-on: ubuntu-latest

.github/workflows/label-approved.yml

@@ -7,6 +7,9 @@ on:
 
 permissions: {}
 
+env:
+  UV_NO_SYNC: true
+
 jobs:
   label-approved:
     if: github.repository_owner == 'fastapi'
@@ -31,6 +34,7 @@ jobs:
       with:
         version: "latest-known"
         enable-cache: true
+        cache-suffix: github-actions
         cache-dependency-glob: |
             pyproject.toml
             uv.lock

.github/workflows/notify-translations.yml

@@ -19,6 +19,9 @@ on:
 
 permissions: {}
 
+env:
+  UV_NO_SYNC: true
+
 jobs:
   job:
     runs-on: ubuntu-latest
@@ -43,6 +46,7 @@ jobs:
         with:
           version: "latest-known"
           enable-cache: true
+          cache-suffix: github-actions
           cache-dependency-glob: |
             pyproject.toml
             uv.lock

.github/workflows/pre-commit.yml

@@ -6,6 +6,7 @@ permissions: {}
 
 env:
   CAN_PUSH: ${{ github.event.pull_request.head.repo.full_name == github.repository && github.actor != 'dependabot[bot]' }}
+  UV_NO_SYNC: true
 
 jobs:
   pre-commit:
@@ -46,6 +47,7 @@ jobs:
         uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
         with:
           version: "latest-known"
+          cache-suffix: dev-all
           cache-dependency-glob: |
             pyproject.toml
             uv.lock

.github/workflows/prepare-release.yml

@@ -18,6 +18,9 @@ on:
 
 permissions: {}
 
+env:
+  UV_NO_SYNC: true
+
 jobs:
   prepare-release:
     runs-on: ubuntu-latest
@@ -44,6 +47,14 @@ jobs:
         uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
         with:
           version: "latest-known"
+          cache-dependency-glob: |
+            pyproject.toml
+            uv.lock
+          cache-suffix: dev-all
+          # Disable saving cache as we install narrower set of dependencies than dev-all has.
+          save-cache: false
+      - name: Install dependencies
+        run: uv sync --locked --group dev
       - name: Prepare release
         env:
           PREPARE_RELEASE_BUMP: ${{ inputs.bump }}

.github/workflows/publish.yml

@@ -5,6 +5,9 @@ on:
     types:
       - published
 
+env:
+  UV_NO_SYNC: true
+
 permissions: {}
 
 jobs:

.github/workflows/smokeshow.yml

@@ -7,6 +7,9 @@ on:
 
 permissions: {}
 
+env:
+  UV_NO_SYNC: true
+
 jobs:
   smokeshow:
     runs-on: ubuntu-latest
@@ -29,6 +32,7 @@ jobs:
         uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
         with:
           version: "latest-known"
+          cache-suffix: github-actions
           cache-dependency-glob: |
             pyproject.toml
             uv.lock

.github/workflows/sponsors.yml

@@ -12,6 +12,9 @@ on:
 
 permissions: {}
 
+env:
+  UV_NO_SYNC: true
+
 jobs:
   job:
     if: github.repository_owner == 'fastapi'
@@ -37,6 +40,7 @@ jobs:
         with:
           version: "latest-known"
           enable-cache: true
+          cache-suffix: github-actions
           cache-dependency-glob: |
             pyproject.toml
             uv.lock

.github/workflows/test.yml

@@ -119,6 +119,7 @@ jobs:
         with:
           version: "latest-known"
           enable-cache: true
+          cache-suffix: tests-${{ matrix.uv-resolution }}
           cache-dependency-glob: |
             pyproject.toml
             uv.lock
@@ -181,6 +182,7 @@ jobs:
         with:
           version: "latest-known"
           enable-cache: true
+          cache-suffix: tests-highest
           cache-dependency-glob: |
             pyproject.toml
             uv.lock
@@ -249,6 +251,13 @@ jobs:
         with:
           version: "latest-known"
           enable-cache: true
+          cache-suffix: tests-highest
+          # This job checks out into `base/`, so the glob must point there.
+          cache-dependency-glob: |
+            base/pyproject.toml
+            base/uv.lock
+          # Only ever runs on pull requests, so anything it saved would be PR-scoped and useless.
+          save-cache: false
       - name: Run the changed tests against the base code
         if: steps.changed-tests.outputs.found == 'true'
         working-directory: base
@@ -288,6 +297,7 @@ jobs:
         with:
           version: "latest-known"
           enable-cache: true
+          cache-suffix: tests-highest
           cache-dependency-glob: |
             pyproject.toml
             uv.lock

.github/workflows/topic-repos.yml

@@ -7,6 +7,9 @@ on:
 
 permissions: {}
 
+env:
+  UV_NO_SYNC: true
+
 jobs:
   topic-repos:
     if: github.repository_owner == 'fastapi'
@@ -32,6 +35,7 @@ jobs:
         with:
           version: "latest-known"
           enable-cache: true
+          cache-suffix: github-actions
           cache-dependency-glob: |
             pyproject.toml
             uv.lock

.github/workflows/translate.yml

@@ -38,6 +38,9 @@ on:
 
 permissions: {}
 
+env:
+  UV_NO_SYNC: true
+
 jobs:
   langs:
     runs-on: ubuntu-latest
@@ -56,6 +59,7 @@ jobs:
         uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
         with:
           version: "latest-known"
+          cache-suffix: translations
           cache-dependency-glob: |
             pyproject.toml
             uv.lock
@@ -98,6 +102,7 @@ jobs:
         uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
         with:
           version: "latest-known"
+          cache-suffix: translations
           cache-dependency-glob: |
             pyproject.toml
             uv.lock

.github/workflows/warm-cache.yml

@@ -0,0 +1,47 @@
+name: Warm Cache
+
+# Populates the `dev-all` uv cache at default-branch scope so that it could be used by
+# `pre-commit.yml` (it has `pull_request` trigger and can't write cache available across PRs)
+# and some others that use subset of dev dependencies.
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - pyproject.toml
+      - uv.lock
+      - .python-version
+      - .github/workflows/warm-cache.yml
+  schedule:
+    - cron: "0 4 * * *"
+  workflow_dispatch:
+
+permissions: {}
+
+jobs:
+  warm-cache:
+    if: github.repository_owner == 'fastapi'
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version-file: ".python-version"
+      - name: Setup uv
+        id: setup-uv
+        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        with:
+          version: "latest-known"
+          enable-cache: true
+          cache-suffix: dev-all
+          cache-dependency-glob: |
+            pyproject.toml
+            uv.lock
+      - name: Populate the cache
+        if: steps.setup-uv.outputs.cache-hit != 'true'
+        run: uv sync --locked --group dev --extra all