Integrate check_translation function to translate_page - retry up to 2 times if translation check failed

.github/dependabot.yml

@@ -8,7 +8,7 @@ updates:
     commit-message:
       prefix: ⬆
   # Python
-  - package-ecosystem: "uv"
+  - package-ecosystem: "pip"
     directory: "/"
     schedule:
       interval: "monthly"

.github/workflows/build-docs.yml

@@ -8,6 +8,9 @@ on:
       - opened
       - synchronize
 
+env:
+  UV_SYSTEM_PYTHON: 1
+
 jobs:
   changes:
     runs-on: ubuntu-latest
@@ -28,8 +31,8 @@ jobs:
             - README.md
             - docs/**
             - docs_src/**
+            - requirements-docs.txt
             - pyproject.toml
-            - uv.lock
             - mkdocs.yml
             - mkdocs.env.yml
             - .github/workflows/build-docs.yml
@@ -46,20 +49,21 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.11"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.4.15"
           enable-cache: true
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install docs extras
-        run: uv sync --locked --no-dev --group docs
+        run: uv pip install -r requirements-docs.txt
       - name: Export Language Codes
         id: show-langs
         run: |
-          echo "langs=$(uv run ./scripts/docs.py langs-json)" >> $GITHUB_OUTPUT
+          echo "langs=$(python ./scripts/docs.py langs-json)" >> $GITHUB_OUTPUT
 
   build-docs:
     needs:
@@ -79,24 +83,25 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.11"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.4.15"
           enable-cache: true
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install docs extras
-        run: uv sync --locked --no-dev --group docs
+        run: uv pip install -r requirements-docs.txt
       - name: Update Languages
-        run: uv run ./scripts/docs.py update-languages
-      - uses: actions/cache@v5
+        run: python ./scripts/docs.py update-languages
+      - uses: actions/cache@v4
         with:
           key: mkdocs-cards-${{ matrix.lang }}-${{ github.ref }}
           path: docs/${{ matrix.lang }}/.cache
       - name: Build Docs
-        run: uv run ./scripts/docs.py build-lang ${{ matrix.lang }}
+        run: python ./scripts/docs.py build-lang ${{ matrix.lang }}
       - uses: actions/upload-artifact@v5
         with:
           name: docs-site-${{ matrix.lang }}

.github/workflows/contributors.yml

@@ -10,6 +10,9 @@ on:
         required: false
         default: "false"
 
+env:
+  UV_SYSTEM_PYTHON: 1
+
 jobs:
   job:
     if: github.repository_owner == 'fastapi'
@@ -25,16 +28,17 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.11"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.4.15"
           enable-cache: true
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install Dependencies
-        run: uv sync --locked --no-dev --group github-actions
+        run: uv pip install -r requirements-github-actions.txt
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
@@ -44,6 +48,6 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.FASTAPI_PR_TOKEN }}
       - name: FastAPI People Contributors
-        run: uv run ./scripts/contributors.py
+        run: python ./scripts/contributors.py
         env:
           GITHUB_TOKEN: ${{ secrets.FASTAPI_PR_TOKEN }}

.github/workflows/deploy-docs.yml

@@ -12,6 +12,9 @@ permissions:
   pull-requests: write
   statuses: write
 
+env:
+  UV_SYSTEM_PYTHON: 1
+
 jobs:
   deploy-docs:
     runs-on: ubuntu-latest
@@ -24,18 +27,19 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.11"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.4.15"
           enable-cache: true
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install GitHub Actions dependencies
-        run: uv sync --locked --no-dev --group github-actions
+        run: uv pip install -r requirements-github-actions.txt
       - name: Deploy Docs Status Pending
-        run: uv run ./scripts/deploy_docs_status.py
+        run: python ./scripts/deploy_docs_status.py
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           COMMIT_SHA: ${{ github.event.workflow_run.head_sha }}
@@ -66,14 +70,14 @@ jobs:
           command: pages deploy ./site --project-name=${{ env.PROJECT_NAME }} --branch=${{ env.BRANCH }}
       - name: Deploy Docs Status Error
         if: failure()
-        run: uv run ./scripts/deploy_docs_status.py
+        run: python ./scripts/deploy_docs_status.py
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           COMMIT_SHA: ${{ github.event.workflow_run.head_sha }}
           RUN_ID: ${{ github.run_id }}
           STATE: "error"
       - name: Comment Deploy
-        run: uv run ./scripts/deploy_docs_status.py
+        run: python ./scripts/deploy_docs_status.py
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           DEPLOY_URL: ${{ steps.deploy.outputs.deployment-url }}

.github/workflows/label-approved.yml

@@ -8,6 +8,9 @@ on:
 permissions:
   pull-requests: write
 
+env:
+  UV_SYSTEM_PYTHON: 1
+
 jobs:
   label-approved:
     if: github.repository_owner == 'fastapi'
@@ -21,18 +24,19 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v6
       with:
-        python-version-file: ".python-version"
+        python-version: "3.11"
     - name: Setup uv
       uses: astral-sh/setup-uv@v7
       with:
+        version: "0.4.15"
         enable-cache: true
         cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
     - name: Install GitHub Actions dependencies
-      run: uv sync --locked --no-dev --group github-actions
+      run: uv pip install -r requirements-github-actions.txt
     - name: Label Approved
-      run: uv run ./scripts/label_approved.py
+      run: python ./scripts/label_approved.py
       env:
         TOKEN: ${{ secrets.GITHUB_TOKEN }}
         CONFIG: >

.github/workflows/notify-translations.yml

@@ -15,6 +15,9 @@ on:
         required: false
         default: 'false'
 
+env:
+  UV_SYSTEM_PYTHON: 1
+
 jobs:
   job:
     runs-on: ubuntu-latest
@@ -29,16 +32,17 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.11"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.4.15"
           enable-cache: true
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install Dependencies
-        run: uv sync --locked --no-dev --group github-actions
+        run: uv pip install -r requirements-github-actions.txt
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
@@ -48,7 +52,7 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - name: Notify Translations
-        run: uv run ./scripts/notify_translations.py
+        run: python ./scripts/notify_translations.py
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NUMBER: ${{ github.event.inputs.number || null }}

.github/workflows/people.yml

@@ -10,6 +10,9 @@ on:
         required: false
         default: "false"
 
+env:
+  UV_SYSTEM_PYTHON: 1
+
 jobs:
   job:
     if: github.repository_owner == 'fastapi'
@@ -25,16 +28,17 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.11"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.4.15"
           enable-cache: true
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install Dependencies
-        run: uv sync --locked --no-dev --group github-actions
+        run: uv pip install -r requirements-github-actions.txt
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
@@ -44,7 +48,7 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.FASTAPI_PEOPLE }}
       - name: FastAPI People Experts
-        run: uv run ./scripts/people.py
+        run: python ./scripts/people.py
         env:
           GITHUB_TOKEN: ${{ secrets.FASTAPI_PEOPLE }}
           SLEEP_INTERVAL: ${{ vars.PEOPLE_SLEEP_INTERVAL }}

.github/workflows/pre-commit.yml

@@ -40,15 +40,18 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.14"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
             uv.lock
       - name: Install Dependencies
-        run: uv sync --locked --extra all
+        run: |
+          uv venv
+          uv pip install -r requirements.txt
       - name: Run prek - pre-commit
         id: precommit
         run: uvx prek run --from-ref origin/${GITHUB_BASE_REF} --to-ref HEAD --show-diff-on-failure

.github/workflows/publish.yml

@@ -15,7 +15,6 @@ jobs:
           - fastapi-slim
     permissions:
       id-token: write
-      contents: read
     steps:
       - name: Dump GitHub context
         env:
@@ -25,15 +24,19 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.10"
           # Issue ref: https://github.com/actions/setup-python/issues/436
           # cache: "pip"
           # cache-dependency-path: pyproject.toml
-      - name: Install uv
-        uses: astral-sh/setup-uv@v7
+      - name: Install build dependencies
+        run: pip install build
       - name: Build distribution
-        run: uv build
         env:
           TIANGOLO_BUILD_PACKAGE: ${{ matrix.package }}
+        run: python -m build
       - name: Publish
-        run: uv publish
+        uses: pypa/gh-action-pypi-publish@v1.13.0
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"

.github/workflows/smokeshow.yml

@@ -8,6 +8,9 @@ on:
 permissions:
   statuses: write
 
+env:
+  UV_SYSTEM_PYTHON: 1
+
 jobs:
   smokeshow:
     runs-on: ubuntu-latest
@@ -20,14 +23,14 @@ jobs:
       - uses: actions/checkout@v6
       - uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: '3.13'
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
-      - run: uv sync --locked --no-dev --group github-actions
+      - run: uv pip install -r requirements-github-actions.txt
       - uses: actions/download-artifact@v6
         with:
           name: coverage-html
@@ -38,7 +41,7 @@ jobs:
       - name: Upload coverage to Smokeshow
         run: |
           for i in 1 2 3 4 5; do
-            if uv run smokeshow upload htmlcov; then
+            if smokeshow upload htmlcov; then
                 echo "Smokeshow upload success!"
                 break
             fi

.github/workflows/sponsors.yml

@@ -10,6 +10,9 @@ on:
         required: false
         default: "false"
 
+env:
+  UV_SYSTEM_PYTHON: 1
+
 jobs:
   job:
     if: github.repository_owner == 'fastapi'
@@ -25,16 +28,17 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.11"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.4.15"
           enable-cache: true
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install Dependencies
-        run: uv sync --locked --no-dev --group github-actions
+        run: uv pip install -r requirements-github-actions.txt
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
@@ -42,7 +46,7 @@ jobs:
         with:
           limit-access-to-actor: true
       - name: FastAPI People Sponsors
-        run: uv run ./scripts/sponsors.py
+        run: python ./scripts/sponsors.py
         env:
           SPONSORS_TOKEN: ${{ secrets.SPONSORS_TOKEN }}
           PR_TOKEN: ${{ secrets.FASTAPI_PR_TOKEN }}

.github/workflows/test-redistribute.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.10"
       - name: Install build dependencies
         run: pip install build
       - name: Build source distribution
@@ -40,7 +40,7 @@ jobs:
       - name: Install test dependencies
         run: |
           cd dist/fastapi*/
-          pip install --group tests --editable .[all]
+          pip install -r requirements-tests.txt
         env:
           TIANGOLO_BUILD_PACKAGE: ${{ matrix.package }}
       - name: Run source distribution tests

.github/workflows/test.yml

@@ -13,7 +13,7 @@ on:
     - cron: "0 0 * * 1"
 
 env:
-  UV_NO_SYNC: true
+  UV_SYSTEM_PYTHON: 1
 
 jobs:
   test:
@@ -44,8 +44,6 @@ jobs:
             coverage: coverage
       fail-fast: false
     runs-on: ${{ matrix.os }}
-    env:
-      UV_PYTHON: ${{ matrix.python-version }}
     steps:
       - name: Dump GitHub context
         env:
@@ -59,16 +57,17 @@ jobs:
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.4.15"
           enable-cache: true
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install Dependencies
-        run: uv sync --locked --no-dev --group tests --extra all
+        run: uv pip install -r requirements-tests.txt
       - run: mkdir coverage
       - name: Test
         if: matrix.codspeed != 'codspeed'
-        run: uv run bash scripts/test.sh
+        run: bash scripts/test.sh
         env:
           COVERAGE_FILE: coverage/.coverage.${{ runner.os }}-py${{ matrix.python-version }}
           CONTEXT: ${{ runner.os }}-py${{ matrix.python-version }}
@@ -80,7 +79,7 @@ jobs:
             CONTEXT: ${{ runner.os }}-py${{ matrix.python-version }}
         with:
           mode: simulation
-          run: uv run coverage run -m pytest tests/ --codspeed
+          run: coverage run -m pytest tests/ --codspeed
       # Do not store coverage for all possible combinations to avoid file size max errors in Smokeshow
       - name: Store coverage files
         if: matrix.coverage == 'coverage'
@@ -101,16 +100,17 @@ jobs:
       - uses: actions/checkout@v6
       - uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: '3.11'
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.4.15"
           enable-cache: true
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install Dependencies
-        run: uv sync --locked --no-dev --group tests --extra all
+        run: uv pip install -r requirements-tests.txt
       - name: Get coverage files
         uses: actions/download-artifact@v6
         with:
@@ -118,15 +118,15 @@ jobs:
           path: coverage
           merge-multiple: true
       - run: ls -la coverage
-      - run: uv run coverage combine coverage
-      - run: uv run coverage html --title "Coverage for ${{ github.sha }}"
+      - run: coverage combine coverage
+      - run: coverage html --title "Coverage for ${{ github.sha }}"
       - name: Store coverage HTML
         uses: actions/upload-artifact@v5
         with:
           name: coverage-html
           path: htmlcov
           include-hidden-files: true
-      - run: uv run coverage report --fail-under=100
+      - run: coverage report --fail-under=100
 
   # https://github.com/marketplace/actions/alls-green#why
   check:  # This job does nothing and is only used for the branch protection

.github/workflows/topic-repos.yml

@@ -5,6 +5,9 @@ on:
     - cron: "0 12 1 * *"
   workflow_dispatch:
 
+env:
+  UV_SYSTEM_PYTHON: 1
+
 jobs:
   topic-repos:
     if: github.repository_owner == 'fastapi'
@@ -20,17 +23,18 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.11"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.4.15"
           enable-cache: true
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install GitHub Actions dependencies
-        run: uv sync --locked --no-dev --group github-actions
+        run: uv pip install -r requirements-github-actions.txt
       - name: Update Topic Repos
-        run: uv run ./scripts/topic_repos.py
+        run: python ./scripts/topic_repos.py
         env:
           GITHUB_TOKEN: ${{ secrets.FASTAPI_PR_TOKEN }}

.github/workflows/translate.yml

@@ -31,6 +31,9 @@ on:
         required: false
         default: ""
 
+env:
+  UV_SYSTEM_PYTHON: 1
+
 jobs:
   langs:
     runs-on: ubuntu-latest
@@ -42,20 +45,20 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.11"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install Dependencies
-        run: uv sync --locked --no-dev --group github-actions --group translations
+        run: uv pip install -r requirements-github-actions.txt -r requirements-translations.txt
       - name: Export Language Codes
         id: show-langs
         run: |
-          echo "langs=$(uv run ./scripts/translate.py llm-translatable-json)" >> $GITHUB_OUTPUT
-          echo "commands=$(uv run ./scripts/translate.py commands-json)" >> $GITHUB_OUTPUT
+          echo "langs=$(python ./scripts/translate.py llm-translatable-json)" >> $GITHUB_OUTPUT
+          echo "commands=$(python ./scripts/translate.py commands-json)" >> $GITHUB_OUTPUT
         env:
           LANGUAGE: ${{ github.event.inputs.language }}
           COMMAND: ${{ github.event.inputs.command }}
@@ -81,15 +84,15 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: ".python-version"
+          python-version: "3.11"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
           cache-dependency-glob: |
+            requirements**.txt
             pyproject.toml
-            uv.lock
       - name: Install Dependencies
-        run: uv sync --locked --no-dev --group github-actions --group translations
+        run: uv pip install -r requirements-github-actions.txt -r requirements-translations.txt
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
@@ -101,8 +104,8 @@ jobs:
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
       - name: FastAPI Translate
         run: |
-          uv run ./scripts/translate.py ${{ matrix.command }}
-          uv run ./scripts/translate.py make-pr
+          python ./scripts/translate.py ${{ matrix.command }}
+          python ./scripts/translate.py make-pr
         env:
           GITHUB_TOKEN: ${{ secrets.FASTAPI_TRANSLATIONS }}
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}

.gitignore

@@ -29,4 +29,7 @@ archive.zip
 # macOS
 .DS_Store
 
+# Ignore while the setup still depends on requirements.txt files
+uv.lock
+
 .codspeed

.pre-commit-config.yaml

@@ -6,7 +6,6 @@ repos:
     hooks:
       - id: check-added-large-files
         args: ['--maxkb=750']
-        exclude: ^uv.lock$
       - id: check-toml
       - id: check-yaml
         args:

.python-version

@@ -1 +0,0 @@
-3.11

docs/en/docs/contributing.md

@@ -6,20 +6,44 @@ First, you might want to see the basic ways to [help FastAPI and get help](help-
 
 If you already cloned the <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">fastapi repository</a> and you want to deep dive in the code, here are some guidelines to set up your environment.
 
+### Virtual environment
+
+Follow the instructions to create and activate a [virtual environment](virtual-environments.md){.internal-link target=_blank} for the internal code of `fastapi`.
+
 ### Install requirements
 
-Create a virtual environment and install the required packages with <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>:
+After activating the environment, install the required packages:
+
+//// tab | `pip`
 
 <div class="termy">
 
 ```console
-$ uv sync
+$ pip install -r requirements.txt
 
 ---> 100%
 ```
 
 </div>
 
+////
+
+//// tab | `uv`
+
+If you have <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>:
+
+<div class="termy">
+
+```console
+$ uv pip install -r requirements.txt
+
+---> 100%
+```
+
+</div>
+
+////
+
 It will install all the dependencies and your local FastAPI in your local environment.
 
 ### Using your local FastAPI
@@ -32,9 +56,9 @@ That way, you don't have to "install" your local version to be able to test ever
 
 /// note | Technical Details
 
-This only happens when you install using `uv sync` instead of running `pip install fastapi` directly.
+This only happens when you install using this included `requirements.txt` instead of running `pip install fastapi` directly.
 
-That is because `uv sync` will install the local version of FastAPI in "editable" mode by default.
+That is because inside the `requirements.txt` file, the local version of FastAPI is marked to be installed in "editable" mode, with the `-e` option.
 
 ///
 

docs/en/docs/release-notes.md

@@ -7,10 +7,6 @@ hide:
 
 ## Latest Changes
 
-### Docs
-
-* 📝 Specify language code for code block. PR [#14656](https://github.com/fastapi/fastapi/pull/14656) by [@YuriiMotov](https://github.com/YuriiMotov).
-
 ### Translations
 
 * 🔧 Add LLM prompt file for Turkish, generated from the existing translations. PR [#14547](https://github.com/fastapi/fastapi/pull/14547) by [@tiangolo](https://github.com/tiangolo).
@@ -19,8 +15,6 @@ hide:
 
 ### Internal
 
-* ⬆️  Migrate to uv. PR [#14676](https://github.com/fastapi/fastapi/pull/14676) by [@DoctorJohn](https://github.com/DoctorJohn).
-* 🔨 Add LLM translations tool fixer. PR [#14652](https://github.com/fastapi/fastapi/pull/14652) by [@YuriiMotov](https://github.com/YuriiMotov).
 * 👥 Update FastAPI People - Sponsors. PR [#14626](https://github.com/fastapi/fastapi/pull/14626) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI GitHub topic repositories. PR [#14630](https://github.com/fastapi/fastapi/pull/14630) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People - Contributors and Translators. PR [#14625](https://github.com/fastapi/fastapi/pull/14625) by [@tiangolo](https://github.com/tiangolo).

docs/en/docs/tutorial/bigger-applications.md

@@ -56,7 +56,7 @@ from app.routers import items
 
 The same file structure with comments:
 
-```bash
+```
 .
 ├── app                  # "app" is a Python package
 │   ├── __init__.py      # this file makes "app" a "Python package"

pyproject.toml

@@ -123,68 +123,6 @@ all = [
 [project.scripts]
 fastapi = "fastapi.cli:main"
 
-[dependency-groups]
-dev = [
-    { include-group = "tests" },
-    { include-group = "docs" },
-    { include-group = "translations" },
-    "playwright>=1.57.0",
-    "prek==0.2.22",
-]
-docs = [
-    { include-group = "docs-tests" },
-    "black==25.1.0",
-    "cairosvg==2.8.2",
-    "griffe-typingdoc==0.3.0",
-    "griffe-warnings-deprecated==1.1.0",
-    "jieba==0.42.1",
-    "markdown-include-variants==0.0.8",
-    "mdx-include>=1.4.1,<2.0.0",
-    "mkdocs-macros-plugin==1.4.1",
-    "mkdocs-material==9.7.0",
-    "mkdocs-redirects>=1.2.1,<1.3.0",
-    "mkdocstrings[python]==0.30.1",
-    "pillow==11.3.0",
-    "python-slugify==8.0.4",
-    "pyyaml>=5.3.1,<7.0.0",
-    "typer==0.16.0",
-]
-docs-tests = [
-    "httpx>=0.23.0,<1.0.0",
-    "ruff==0.14.3",
-]
-github-actions = [
-    "httpx>=0.27.0,<1.0.0",
-    "pydantic>=2.5.3,<3.0.0",
-    "pydantic-settings>=2.1.0,<3.0.0",
-    "pygithub>=2.3.0,<3.0.0",
-    "pyyaml>=5.3.1,<7.0.0",
-    "smokeshow>=0.5.0",
-]
-tests = [
-    { include-group = "docs-tests" },
-    "anyio[trio]>=3.2.1,<5.0.0",
-    "coverage[toml]>=6.5.0,<8.0",
-    "dirty-equals==0.9.0",
-    "flask>=1.1.2,<4.0.0",
-    "inline-snapshot>=0.21.1",
-    "mypy==1.14.1",
-    "pwdlib[argon2]>=0.2.1",
-    "pyjwt==2.9.0",
-    "pytest>=7.1.3,<9.0.0",
-    "pytest-codspeed==4.2.0",
-    "pyyaml>=5.3.1,<7.0.0",
-    "sqlmodel==0.0.27",
-    "strawberry-graphql>=0.200.0,<1.0.0",
-    "types-orjson==3.6.2",
-    "types-ujson==5.10.0.20240515",
-]
-translations = [
-    "gitpython==3.1.45",
-    "pydantic-ai==0.4.10",
-    "pygithub==2.8.1",
-]
-
 [tool.pdm]
 version = { source = "file", path = "fastapi/__init__.py" }
 distribution = true
@@ -193,10 +131,11 @@ distribution = true
 source-includes = [
     "tests/",
     "docs_src/",
+    "requirements*.txt",
     "scripts/",
     # For a test
     "docs/en/docs/img/favicon.png",
-]
+    ]
 
 [tool.tiangolo._internal-slim-build.packages.fastapi-slim.project]
 name = "fastapi-slim"

requirements-docs-tests.txt

@@ -0,0 +1,4 @@
+# For mkdocstrings and tests
+httpx >=0.23.0,<1.0.0
+# For linting and generating docs versions
+ruff ==0.14.3

requirements-docs.txt

@@ -0,0 +1,21 @@
+-e .
+-r requirements-docs-tests.txt
+mkdocs-material==9.7.0
+mdx-include >=1.4.1,<2.0.0
+mkdocs-redirects>=1.2.1,<1.3.0
+typer == 0.16.0
+pyyaml >=5.3.1,<7.0.0
+# For Material for MkDocs, Chinese search
+jieba==0.42.1
+# For image processing by Material for MkDocs
+pillow==11.3.0
+# For image processing by Material for MkDocs
+cairosvg==2.8.2
+mkdocstrings[python]==0.30.1
+griffe-typingdoc==0.3.0
+griffe-warnings-deprecated==1.1.0
+# For griffe, it formats with black
+black==25.1.0
+mkdocs-macros-plugin==1.4.1
+markdown-include-variants==0.0.8
+python-slugify==8.0.4

requirements-github-actions.txt

@@ -0,0 +1,6 @@
+PyGithub>=2.3.0,<3.0.0
+pydantic>=2.5.3,<3.0.0
+pydantic-settings>=2.1.0,<3.0.0
+httpx>=0.27.0,<1.0.0
+pyyaml >=5.3.1,<7.0.0
+smokeshow

requirements-tests.txt

@@ -0,0 +1,18 @@
+-e .[all]
+-r requirements-docs-tests.txt
+pytest >=7.1.3,<9.0.0
+coverage[toml] >= 6.5.0,< 8.0
+mypy ==1.14.1
+dirty-equals ==0.9.0
+sqlmodel==0.0.27
+flask >=1.1.2,<4.0.0
+strawberry-graphql >=0.200.0,< 1.0.0
+anyio[trio] >=3.2.1,<5.0.0
+PyJWT==2.9.0
+pyyaml >=5.3.1,<7.0.0
+pwdlib[argon2] >=0.2.1
+inline-snapshot>=0.21.1
+pytest-codspeed==4.2.0
+# types
+types-ujson ==5.10.0.20240515
+types-orjson ==3.6.2

requirements-translations.txt

@@ -0,0 +1,3 @@
+pydantic-ai==0.4.10
+GitPython==3.1.45
+pygithub==2.8.1

requirements.txt

@@ -0,0 +1,7 @@
+-e .[all]
+-r requirements-tests.txt
+-r requirements-docs.txt
+-r requirements-translations.txt
+prek==0.2.22
+# For generating screenshots
+playwright

scripts/doc_parsing_utils.py

@@ -75,14 +75,14 @@ class MultilineCodeBlockInfo(TypedDict):
 
 
 # Code includes
-# --------------------------------------------------------------------------------------
+# -----------------------------------------------------------------------------------------
 
 
 def extract_code_includes(lines: list[str]) -> list[CodeIncludeInfo]:
     """
-    Extract lines that contain code includes.
+    Exctract lines that contain code includes.
 
-    Return list of CodeIncludeInfo, where each dict contains:
+    Return list of CodeIncludeInfo namedtuples, where each tuple contains:
     - `line_no` - line number (1-based)
     - `line` - text of the line
     """
@@ -135,14 +135,14 @@ def replace_placeholders_with_code_includes(
 
 
 # Header permalinks
-# --------------------------------------------------------------------------------------
+# -----------------------------------------------------------------------------------------
 
 
 def extract_header_permalinks(lines: list[str]) -> list[HeaderPermalinkInfo]:
     """
     Extract list of header permalinks from the given lines.
 
-    Return list of HeaderPermalinkInfo, where each dict contains:
+    Return list of HeaderPermalinkInfo namedtuples, where each tuple contains:
     - `line_no` - line number (1-based)
     - `hashes` - string of hashes representing header level (e.g., "###")
     - `permalink` - permalink string (e.g., "{#permalink}")
@@ -246,14 +246,14 @@ def replace_header_permalinks(
 
 
 # Markdown links
-# --------------------------------------------------------------------------------------
+# -----------------------------------------------------------------------------------------
 
 
-def extract_markdown_links(lines: list[str]) -> list[MarkdownLinkInfo]:
+def extract_markdown_links(lines: list[str]) -> list[tuple[str, int]]:
     """
     Extract all markdown links from the given lines.
 
-    Return list of MarkdownLinkInfo, where each dict contains:
+    Return list of MarkdownLinkInfo namedtuples, where each tuple contains:
     - `line_no` - line number (1-based)
     - `url` - link URL
     - `text` - link text
@@ -347,17 +347,17 @@ def replace_markdown_links(
 
 
 # HTML links
-# --------------------------------------------------------------------------------------
+# -----------------------------------------------------------------------------------------
 
 
 def extract_html_links(lines: list[str]) -> list[HtmlLinkInfo]:
     """
     Extract all HTML links from the given lines.
 
-    Return list of HtmlLinkInfo, where each dict contains:
+    Return list of HtmlLinkInfo namedtuples, where each tuple contains:
     - `line_no` - line number (1-based)
     - `full_tag` - full HTML link tag
-    - `attributes` - list of HTMLLinkAttribute (name, quote, value)
+    - `attributes` - list of HTMLLinkAttribute namedtuples (name, quote, value)
     - `text` - link text
     """
 
@@ -465,7 +465,7 @@ def replace_html_links(
 
 
 # Multiline code blocks
-# --------------------------------------------------------------------------------------
+# -----------------------------------------------------------------------------------------
 
 
 def get_code_block_lang(line: str) -> str:
@@ -640,7 +640,7 @@ def replace_multiline_code_blocks_in_text(
     text: list[str],
     code_blocks: list[MultilineCodeBlockInfo],
     original_code_blocks: list[MultilineCodeBlockInfo],
-) -> list[str]:
+) -> list[MultilineCodeBlockInfo]:
     """
     Update each code block in `text` with the corresponding code block from
     `original_code_blocks` with comments taken from `code_blocks`.
@@ -666,7 +666,7 @@ def replace_multiline_code_blocks_in_text(
 
 
 # All checks
-# --------------------------------------------------------------------------------------
+# -----------------------------------------------------------------------------------------
 
 
 def check_translation(

scripts/translate.py

@@ -10,6 +10,7 @@ from typing import Annotated
 import git
 import typer
 import yaml
+from doc_parsing_utils import check_translation
 from github import Github
 from pydantic_ai import Agent
 from rich import print
@@ -119,9 +120,27 @@ def translate_page(
         ]
     )
     prompt = "\n\n".join(prompt_segments)
-    print(f"Running agent for {out_path}")
-    result = agent.run_sync(prompt)
-    out_content = f"{result.output.strip()}\n"
+
+    for attempt_no in range(1, 4):
+        print(f"Running agent for {out_path} (attempt {attempt_no}/3)")
+        result = agent.run_sync(prompt)
+        out_content = f"{result.output.strip()}\n"
+        try:
+            check_translation(
+                doc_lines=out_content.splitlines(),
+                en_doc_lines=original_content.splitlines(),
+                lang_code=language,
+                auto_fix=False,
+                path=str(out_path),
+            )
+            break  # Exit loop if no errors
+        except ValueError as e:
+            print(f"Translation check failed on attempt {attempt_no}/3: {e}")
+            continue  # Retry if not reached max attempts
+    else:  # Max retry attempts reached
+        print(f"Translation failed for {out_path} after 3 attempts")
+        raise typer.Exit(code=1)
+
     print(f"Saving translation to {out_path}")
     out_path.write_text(out_content, encoding="utf-8", newline="\n")