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
+        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

@@ -30,11 +30,9 @@ on:
         type: string
         required: false
         default: ""
-      commit_in_place:
-        description: Whether to commit changes directly instead of making a PR
-        type: boolean
-        required: false
-        default: false
+
+env:
+  UV_SYSTEM_PYTHON: 1
 
 jobs:
   langs:
@@ -47,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 }}
@@ -86,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
@@ -106,12 +104,11 @@ 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 }}
           LANGUAGE: ${{ matrix.lang }}
           EN_PATH: ${{ github.event.inputs.en_path }}
           COMMAND: ${{ matrix.command }}
-          COMMIT_IN_PLACE: ${{ github.event.inputs.commit_in_place }}

.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:
@@ -58,9 +57,3 @@ repos:
         entry: uv run ./scripts/docs.py ensure-non-translated
         files: ^docs/(?!en/).*|^scripts/docs\.py$
         pass_filenames: false
-
-      - id: fix-translations
-        language: unsupported
-        name: fix translations
-        entry: uv run ./scripts/translation_fixer.py fix-pages
-        files: ^docs/(?!en/).*/docs/.*\.md$

.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,25 +7,14 @@ 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
 
-* 🌐 Update translations for es (update-outdated). PR [#14686](https://github.com/fastapi/fastapi/pull/14686) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 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).
 * 🔧 Add LLM prompt file for Traditional Chinese, generated from the existing translations. PR [#14550](https://github.com/fastapi/fastapi/pull/14550) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Add LLM prompt file for Simplified Chinese, generated from the existing translations. PR [#14549](https://github.com/fastapi/fastapi/pull/14549) by [@tiangolo](https://github.com/tiangolo).
 
 ### Internal
 
-* 🔨 Refactor translation script to allow committing in place. PR [#14687](https://github.com/fastapi/fastapi/pull/14687) by [@tiangolo](https://github.com/tiangolo).
-* 🐛 Fix translation script path. PR [#14685](https://github.com/fastapi/fastapi/pull/14685) by [@tiangolo](https://github.com/tiangolo).
-* ✅ Enable tests in CI for scripts. PR [#14684](https://github.com/fastapi/fastapi/pull/14684) by [@tiangolo](https://github.com/tiangolo).
-* 🔧 Add pre-commit local script to fix language translations. PR [#14683](https://github.com/fastapi/fastapi/pull/14683) by [@tiangolo](https://github.com/tiangolo).
-* ⬆️  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"

docs/es/docs/_llm-test.md

@@ -1,17 +1,17 @@
 # Archivo de prueba de LLM { #llm-test-file }
 
-Este documento prueba si el <abbr title="Large Language Model - Modelo de lenguaje grande">LLM</abbr>, que traduce la documentación, entiende el `general_prompt` en `scripts/translate.py` y el prompt específico del idioma en `docs/{language code}/llm-prompt.md`. El prompt específico del idioma se agrega al final de `general_prompt`.
+Este documento prueba si el <abbr title="Large Language Model – Modelo de lenguaje grande">LLM</abbr>, que traduce la documentación, entiende el `general_prompt` en `scripts/translate.py` y el prompt específico del idioma en `docs/{language code}/llm-prompt.md`. El prompt específico del idioma se agrega al final de `general_prompt`.
 
 Las pruebas añadidas aquí serán vistas por todas las personas que diseñan prompts específicos del idioma.
 
 Úsalo de la siguiente manera:
 
-* Ten un prompt específico del idioma - `docs/{language code}/llm-prompt.md`.
+* Ten un prompt específico del idioma – `docs/{language code}/llm-prompt.md`.
 * Haz una traducción fresca de este documento a tu idioma destino (mira, por ejemplo, el comando `translate-page` de `translate.py`). Esto creará la traducción en `docs/{language code}/docs/_llm-test.md`.
-* Revisa si las cosas están bien en la traducción.
+* Comprueba si todo está bien en la traducción.
 * Si es necesario, mejora tu prompt específico del idioma, el prompt general, o el documento en inglés.
 * Luego corrige manualmente los problemas restantes en la traducción para que sea una buena traducción.
-* Vuelve a traducir, teniendo la buena traducción en su lugar. El resultado ideal sería que el LLM ya no hiciera cambios a la traducción. Eso significa que el prompt general y tu prompt específico del idioma están tan bien como pueden estar (A veces hará algunos cambios aparentemente aleatorios; la razón es que <a href="https://doublespeak.chat/#/handbook#deterministic-output" class="external-link" target="_blank">los LLMs no son algoritmos deterministas</a>).
+* Vuelve a traducir, teniendo la buena traducción en su lugar. El resultado ideal sería que el LLM ya no hiciera cambios a la traducción. Eso significa que el prompt general y tu prompt específico del idioma están tan bien como pueden estar (a veces hará algunos cambios aparentemente aleatorios; la razón es que <a href="https://doublespeak.chat/#/handbook#deterministic-output" class="external-link" target="_blank">los LLMs no son algoritmos deterministas</a>).
 
 Las pruebas:
 
@@ -23,7 +23,7 @@ Este es un fragmento de código: `foo`. Y este es otro fragmento de código: `ba
 
 ////
 
-//// tab | Info
+//// tab | Información
 
 El contenido de los fragmentos de código debe dejarse tal cual.
 
@@ -45,7 +45,7 @@ El LLM probablemente traducirá esto mal. Lo interesante es si mantiene la tradu
 
 ////
 
-//// tab | Info
+//// tab | Información
 
 La persona que diseña el prompt puede elegir si quiere convertir comillas neutras a comillas tipográficas. También está bien dejarlas como están.
 
@@ -67,7 +67,7 @@ Hardcore: `Yesterday, my friend wrote: "If you spell incorrectly correctly, you
 
 ////
 
-//// tab | Info
+//// tab | Información
 
 ... Sin embargo, las comillas dentro de fragmentos de código deben quedarse tal cual.
 
@@ -112,7 +112,7 @@ works(foo="bar")  # Esto funciona 🎉
 
 ////
 
-//// tab | Info
+//// tab | Información
 
 El código en bloques de código no debe modificarse, con la excepción de los comentarios.
 
@@ -154,7 +154,7 @@ Algo de texto
 
 ////
 
-//// tab | Info
+//// tab | Información
 
 Las pestañas y los bloques `Info`/`Note`/`Warning`/etc. deben tener la traducción de su título añadida después de una barra vertical (`|`).
 
@@ -181,7 +181,7 @@ El texto del enlace debe traducirse, la dirección del enlace debe apuntar a la
 
 ////
 
-//// tab | Info
+//// tab | Información
 
 Los enlaces deben traducirse, pero su dirección debe permanecer sin cambios. Una excepción son los enlaces absolutos a páginas de la documentación de FastAPI. En ese caso deben enlazar a la traducción.
 
@@ -197,10 +197,10 @@ Aquí algunas cosas envueltas en elementos HTML "abbr" (algunas son inventadas):
 
 ### El abbr da una frase completa { #the-abbr-gives-a-full-phrase }
 
-* <abbr title="Getting Things Done - Hacer las cosas">GTD</abbr>
-* <abbr title="less than - menor que"><code>lt</code></abbr>
-* <abbr title="XML Web Token - Token web XML">XWT</abbr>
-* <abbr title="Parallel Server Gateway Interface - Interfaz de pasarela de servidor paralela">PSGI</abbr>
+* <abbr title="Getting Things Done – Hacer las cosas">GTD</abbr>
+* <abbr title="less than – menor que"><code>lt</code></abbr>
+* <abbr title="XML Web Token – Token web XML">XWT</abbr>
+* <abbr title="Parallel Server Gateway Interface – Interfaz de pasarela de servidor paralela">PSGI</abbr>
 
 ### El abbr da una explicación { #the-abbr-gives-an-explanation }
 
@@ -209,12 +209,12 @@ Aquí algunas cosas envueltas en elementos HTML "abbr" (algunas son inventadas):
 
 ### El abbr da una frase completa y una explicación { #the-abbr-gives-a-full-phrase-and-an-explanation }
 
-* <abbr title="Mozilla Developer Network - Red de Desarrolladores de Mozilla: documentación para desarrolladores, escrita por la gente de Firefox">MDN</abbr>
-* <abbr title="Input/Output: lectura o escritura de disco, comunicaciones de red.">I/O</abbr>.
+* <abbr title="Mozilla Developer Network – Red de Desarrolladores de Mozilla: documentación para desarrolladores, escrita por la gente de Firefox">MDN</abbr>
+* <abbr title="Input/Output – Entrada/Salida: lectura o escritura de disco, comunicaciones de red.">I/O</abbr>.
 
 ////
 
-//// tab | Info
+//// tab | Información
 
 Los atributos "title" de los elementos "abbr" se traducen siguiendo instrucciones específicas.
 
@@ -242,7 +242,7 @@ Hola de nuevo.
 
 ////
 
-//// tab | Info
+//// tab | Información
 
 La única regla estricta para los encabezados es que el LLM deje la parte del hash dentro de llaves sin cambios, lo que asegura que los enlaces no se rompan.
 
@@ -355,7 +355,7 @@ Para instrucciones específicas del idioma, mira p. ej. la sección `### Heading
 * los headers
 * el header de autorización
 * el header `Authorization`
-* el header forwarded
+* el header Forwarded
 
 * el sistema de inyección de dependencias
 * la dependencia
@@ -368,7 +368,7 @@ Para instrucciones específicas del idioma, mira p. ej. la sección `### Heading
 * paralelismo
 * multiprocesamiento
 
-* la env var
+* la variable de entorno
 * la variable de entorno
 * el `PATH`
 * la variable `PATH`
@@ -433,7 +433,7 @@ Para instrucciones específicas del idioma, mira p. ej. la sección `### Heading
 * el motor de plantillas
 
 * la anotación de tipos
-* las anotaciones de tipos
+* la anotación de tipos
 
 * el worker del servidor
 * el worker de Uvicorn
@@ -468,7 +468,7 @@ Para instrucciones específicas del idioma, mira p. ej. la sección `### Heading
 * el ítem
 * el paquete
 * el lifespan
-* el lock
+* el bloqueo
 * el middleware
 * la aplicación móvil
 * el módulo
@@ -494,7 +494,7 @@ Para instrucciones específicas del idioma, mira p. ej. la sección `### Heading
 
 ////
 
-//// tab | Info
+//// tab | Información
 
 Esta es una lista no completa y no normativa de términos (mayormente) técnicos vistos en la documentación. Puede ayudar a la persona que diseña el prompt a identificar para qué términos el LLM necesita una mano. Por ejemplo cuando sigue revirtiendo una buena traducción a una traducción subóptima. O cuando tiene problemas conjugando/declinando un término en tu idioma.
 

docs/es/docs/advanced/path-operation-advanced-configuration.md

@@ -10,7 +10,7 @@ Si no eres un "experto" en OpenAPI, probablemente no necesites esto.
 
 Puedes establecer el `operationId` de OpenAPI para ser usado en tu *path operation* con el parámetro `operation_id`.
 
-Tendrías que asegurarte de que sea único para cada operación.
+Tienes que asegurarte de que sea único para cada operación.
 
 {* ../../docs_src/path_operation_advanced_configuration/tutorial001_py39.py hl[6] *}
 
@@ -46,7 +46,7 @@ Para excluir una *path operation* del esquema OpenAPI generado (y por lo tanto,
 
 Puedes limitar las líneas usadas del docstring de una *path operation function* para OpenAPI.
 
-Añadir un `\f` (un carácter "form feed" escapado) hace que **FastAPI** trunque la salida usada para OpenAPI en este punto.
+Añadir un `\f` (un carácter de separación de página escapado) hace que **FastAPI** trunque la salida usada para OpenAPI en este punto.
 
 No aparecerá en la documentación, pero otras herramientas (como Sphinx) podrán usar el resto.
 
@@ -141,9 +141,9 @@ Podrías hacer eso con `openapi_extra`:
 
 {* ../../docs_src/path_operation_advanced_configuration/tutorial006_py39.py hl[19:36, 39:40] *}
 
-En este ejemplo, no declaramos ningún modelo Pydantic. De hecho, el request body ni siquiera se <abbr title="converted from some plain format, like bytes, into Python objects - convertido de algún formato plano, como bytes, a objetos de Python">parse</abbr> como JSON, se lee directamente como `bytes`, y la función `magic_data_reader()` sería la encargada de parsearlo de alguna manera.
+En este ejemplo, no declaramos ningún modelo Pydantic. De hecho, el cuerpo del request ni siquiera se <abbr title="convertido de algún formato plano, como bytes, a objetos de Python">parse</abbr> como JSON, se lee directamente como `bytes`, y la función `magic_data_reader()` sería la encargada de parsearlo de alguna manera.
 
-Sin embargo, podemos declarar el esquema esperado para el request body.
+Sin embargo, podemos declarar el esquema esperado para el cuerpo del request.
 
 ### Tipo de contenido personalizado de OpenAPI { #custom-openapi-content-type }
 
@@ -153,16 +153,48 @@ Y podrías hacer esto incluso si el tipo de datos en el request no es JSON.
 
 Por ejemplo, en esta aplicación no usamos la funcionalidad integrada de FastAPI para extraer el JSON Schema de los modelos Pydantic ni la validación automática para JSON. De hecho, estamos declarando el tipo de contenido del request como YAML, no JSON:
 
+//// tab | Pydantic v2
+
 {* ../../docs_src/path_operation_advanced_configuration/tutorial007_py39.py hl[15:20, 22] *}
 
+////
+
+//// tab | Pydantic v1
+
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1_py39.py hl[15:20, 22] *}
+
+////
+
+/// info | Información
+
+En la versión 1 de Pydantic el método para obtener el JSON Schema para un modelo se llamaba `Item.schema()`, en la versión 2 de Pydantic, el método se llama `Item.model_json_schema()`.
+
+///
+
 Sin embargo, aunque no estamos usando la funcionalidad integrada por defecto, aún estamos usando un modelo Pydantic para generar manualmente el JSON Schema para los datos que queremos recibir en YAML.
 
 Luego usamos el request directamente, y extraemos el cuerpo como `bytes`. Esto significa que FastAPI ni siquiera intentará parsear la carga útil del request como JSON.
 
 Y luego en nuestro código, parseamos ese contenido YAML directamente, y nuevamente estamos usando el mismo modelo Pydantic para validar el contenido YAML:
 
+//// tab | Pydantic v2
+
 {* ../../docs_src/path_operation_advanced_configuration/tutorial007_py39.py hl[24:31] *}
 
+////
+
+//// tab | Pydantic v1
+
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1_py39.py hl[24:31] *}
+
+////
+
+/// info | Información
+
+En la versión 1 de Pydantic el método para parsear y validar un objeto era `Item.parse_obj()`, en la versión 2 de Pydantic, el método se llama `Item.model_validate()`.
+
+///
+
 /// tip | Consejo
 
 Aquí reutilizamos el mismo modelo Pydantic.

docs/es/docs/advanced/settings.md

@@ -46,6 +46,12 @@ $ pip install "fastapi[all]"
 
 </div>
 
+/// info | Información
+
+En Pydantic v1 venía incluido con el paquete principal. Ahora se distribuye como este paquete independiente para que puedas elegir si instalarlo o no si no necesitas esa funcionalidad.
+
+///
+
 ### Crear el objeto `Settings` { #create-the-settings-object }
 
 Importa `BaseSettings` de Pydantic y crea una sub-clase, muy similar a un modelo de Pydantic.
@@ -54,15 +60,31 @@ De la misma forma que con los modelos de Pydantic, declaras atributos de clase c
 
 Puedes usar todas las mismas funcionalidades de validación y herramientas que usas para los modelos de Pydantic, como diferentes tipos de datos y validaciones adicionales con `Field()`.
 
+//// tab | Pydantic v2
+
 {* ../../docs_src/settings/tutorial001_py39.py hl[2,5:8,11] *}
 
+////
+
+//// tab | Pydantic v1
+
+/// info | Información
+
+En Pydantic v1 importarías `BaseSettings` directamente desde `pydantic` en lugar de desde `pydantic_settings`.
+
+///
+
+{* ../../docs_src/settings/tutorial001_pv1_py39.py hl[2,5:8,11] *}
+
+////
+
 /// tip | Consejo
 
 Si quieres algo rápido para copiar y pegar, no uses este ejemplo, usa el último más abajo.
 
 ///
 
-Luego, cuando creas un instance de esa clase `Settings` (en este caso, en el objeto `settings`), Pydantic leerá las variables de entorno de una manera indiferente a mayúsculas y minúsculas, por lo que una variable en mayúsculas `APP_NAME` aún será leída para el atributo `app_name`.
+Luego, cuando creas una instance de esa clase `Settings` (en este caso, en el objeto `settings`), Pydantic leerá las variables de entorno de una manera indiferente a mayúsculas y minúsculas, por lo que una variable en mayúsculas `APP_NAME` aún será leída para el atributo `app_name`.
 
 Luego convertirá y validará los datos. Así que, cuando uses ese objeto `settings`, tendrás datos de los tipos que declaraste (por ejemplo, `items_per_user` será un `int`).
 
@@ -88,7 +110,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" fastapi run main.p
 
 /// tip | Consejo
 
-Para establecer múltiples env vars para un solo comando, simplemente sepáralas con un espacio y ponlas todas antes del comando.
+Para establecer múltiples variables de entorno para un solo comando, simplemente sepáralas con un espacio y ponlas todas antes del comando.
 
 ///
 
@@ -128,7 +150,7 @@ Proveniente del ejemplo anterior, tu archivo `config.py` podría verse como:
 
 {* ../../docs_src/settings/app02_an_py39/config.py hl[10] *}
 
-Nota que ahora no creamos un instance por defecto `settings = Settings()`.
+Nota que ahora no creamos una instance por defecto `settings = Settings()`.
 
 ### El archivo principal de la app { #the-main-app-file }
 
@@ -150,11 +172,11 @@ Y luego podemos requerirlo desde la *path operation function* como una dependenc
 
 ### Configuraciones y pruebas { #settings-and-testing }
 
-Luego sería muy fácil proporcionar un objeto de configuraciones diferente durante las pruebas al crear una sobrescritura de dependencia para `get_settings`:
+Luego sería muy fácil proporcionar un objeto de configuraciones diferente durante las pruebas al sobrescribir una dependencia para `get_settings`:
 
 {* ../../docs_src/settings/app02_an_py39/test_main.py hl[9:10,13,21] *}
 
-En la sobrescritura de dependencia establecemos un nuevo valor para el `admin_email` al crear el nuevo objeto `Settings`, y luego devolvemos ese nuevo objeto.
+En la dependencia sobreescrita establecemos un nuevo valor para el `admin_email` al crear el nuevo objeto `Settings`, y luego devolvemos ese nuevo objeto.
 
 Luego podemos probar que se está usando.
 
@@ -193,6 +215,8 @@ APP_NAME="ChimichangApp"
 
 Y luego actualizar tu `config.py` con:
 
+//// tab | Pydantic v2
+
 {* ../../docs_src/settings/app03_an_py39/config.py hl[9] *}
 
 /// tip | Consejo
@@ -201,6 +225,26 @@ El atributo `model_config` se usa solo para configuración de Pydantic. Puedes l
 
 ///
 
+////
+
+//// tab | Pydantic v1
+
+{* ../../docs_src/settings/app03_an_py39/config_pv1.py hl[9:10] *}
+
+/// tip | Consejo
+
+La clase `Config` se usa solo para configuración de Pydantic. Puedes leer más en <a href="https://docs.pydantic.dev/1.10/usage/model_config/" class="external-link" target="_blank">Pydantic Model Config</a>.
+
+///
+
+////
+
+/// info | Información
+
+En la versión 1 de Pydantic la configuración se hacía en una clase interna `Config`, en la versión 2 de Pydantic se hace en un atributo `model_config`. Este atributo toma un `dict`, y para obtener autocompletado y errores en línea, puedes importar y usar `SettingsConfigDict` para definir ese `dict`.
+
+///
+
 Aquí definimos la configuración `env_file` dentro de tu clase Pydantic `Settings`, y establecemos el valor en el nombre del archivo con el archivo dotenv que queremos usar.
 
 ### Creando el `Settings` solo una vez con `lru_cache` { #creating-the-settings-only-once-with-lru-cache }
@@ -287,7 +331,7 @@ participant execute as Ejecutar función
     end
 ```
 
-En el caso de nuestra dependencia `get_settings()`, la función ni siquiera toma argumentos, por lo que siempre devuelve el mismo valor.
+En el caso de nuestra dependencia `get_settings()`, la función ni siquiera toma argumentos, por lo que siempre devolverá el mismo valor.
 
 De esa manera, se comporta casi como si fuera solo una variable global. Pero como usa una función de dependencia, entonces podemos sobrescribirla fácilmente para las pruebas.
 

docs/es/docs/how-to/migrate-from-pydantic-v1-to-pydantic-v2.md

@@ -2,23 +2,21 @@
 
 Si tienes una app de FastAPI antigua, podrías estar usando Pydantic versión 1.
 
-FastAPI versión 0.100.0 tenía compatibilidad con Pydantic v1 o v2. Usaba la que tuvieras instalada.
+FastAPI ha tenido compatibilidad con Pydantic v1 o v2 desde la versión 0.100.0.
 
-FastAPI versión 0.119.0 introdujo compatibilidad parcial con Pydantic v1 desde dentro de Pydantic v2 (como `pydantic.v1`), para facilitar la migración a v2.
+Si tenías instalado Pydantic v2, lo usaba. Si en cambio tenías Pydantic v1, usaba ese.
 
-FastAPI 0.126.0 eliminó la compatibilidad con Pydantic v1, aunque siguió soportando `pydantic.v1` por un poquito más de tiempo.
+Pydantic v1 está deprecado y su soporte se eliminará en las próximas versiones de FastAPI, deberías migrar a Pydantic v2. Así obtendrás las funcionalidades, mejoras y correcciones más recientes.
 
 /// warning | Advertencia
 
-El equipo de Pydantic dejó de dar soporte a Pydantic v1 para las versiones más recientes de Python, comenzando con **Python 3.14**.
-
-Esto incluye `pydantic.v1`, que ya no está soportado en Python 3.14 y superiores.
+Además, el equipo de Pydantic dejó de dar soporte a Pydantic v1 para las versiones más recientes de Python, comenzando con Python 3.14.
 
 Si quieres usar las funcionalidades más recientes de Python, tendrás que asegurarte de usar Pydantic v2.
 
 ///
 
-Si tienes una app de FastAPI antigua con Pydantic v1, aquí te muestro cómo migrarla a Pydantic v2, y las **funcionalidades en FastAPI 0.119.0** para ayudarte con una migración gradual.
+Si tienes una app de FastAPI antigua con Pydantic v1, aquí te muestro cómo migrarla a Pydantic v2 y las nuevas funcionalidades en FastAPI 0.119.0 para ayudarte con una migración gradual.
 
 ## Guía oficial { #official-guide }
 
@@ -46,9 +44,9 @@ Después de esto, puedes ejecutar los tests y revisa si todo funciona. Si es as
 
 ## Pydantic v1 en v2 { #pydantic-v1-in-v2 }
 
-Pydantic v2 incluye todo lo de Pydantic v1 como un submódulo `pydantic.v1`. Pero esto ya no está soportado en versiones por encima de Python 3.13.
+Pydantic v2 incluye todo lo de Pydantic v1 como un submódulo `pydantic.v1`.
 
-Esto significa que puedes instalar la versión más reciente de Pydantic v2 e importar y usar los componentes viejos de Pydantic v1 desde este submódulo, como si tuvieras instalado el Pydantic v1 antiguo.
+Esto significa que puedes instalar la versión más reciente de Pydantic v2 e importar y usar los componentes viejos de Pydantic v1 desde ese submódulo, como si tuvieras instalado el Pydantic v1 antiguo.
 
 {* ../../docs_src/pydantic_v1_in_v2/tutorial001_an_py310.py hl[1,4] *}
 
@@ -68,7 +66,7 @@ Ten en cuenta que, como el equipo de Pydantic ya no da soporte a Pydantic v1 en
 
 ### Pydantic v1 y v2 en la misma app { #pydantic-v1-and-v2-on-the-same-app }
 
-**No está soportado** por Pydantic tener un modelo de Pydantic v2 con sus propios campos definidos como modelos de Pydantic v1 o viceversa.
+No está soportado por Pydantic tener un modelo de Pydantic v2 con sus propios campos definidos como modelos de Pydantic v1 o viceversa.
 
 ```mermaid
 graph TB
@@ -108,7 +106,7 @@ graph TB
     style V2Field fill:#f9fff3
 ```
 
-En algunos casos, incluso es posible tener modelos de Pydantic v1 y v2 en la misma **path operation** de tu app de FastAPI:
+En algunos casos, incluso es posible tener modelos de Pydantic v1 y v2 en la misma path operation de tu app de FastAPI:
 
 {* ../../docs_src/pydantic_v1_in_v2/tutorial003_an_py310.py hl[2:3,6,12,21:22] *}
 
@@ -124,12 +122,12 @@ Si necesitas usar algunas de las herramientas específicas de FastAPI para pará
 
 /// tip | Consejo
 
-Primero prueba con `bump-pydantic`, si tus tests pasan y eso funciona, entonces terminaste con un solo comando. ✨
+Primero prueba con `bump-pydantic`; si tus tests pasan y eso funciona, entonces terminaste con un solo comando. ✨
 
 ///
 
-Si `bump-pydantic` no funciona para tu caso de uso, puedes usar la compatibilidad de modelos Pydantic v1 y v2 en la misma app para hacer la migración a Pydantic v2 de forma gradual.
+Si `bump-pydantic` no funciona para tu caso, puedes usar la compatibilidad de modelos Pydantic v1 y v2 en la misma app para hacer la migración a Pydantic v2 de forma gradual.
 
-Podrías primero actualizar Pydantic para usar la última versión 2, y cambiar los imports para usar `pydantic.v1` para todos tus modelos.
+Podrías primero actualizar Pydantic para usar la última versión 2 y cambiar los imports para usar `pydantic.v1` para todos tus modelos.
 
 Luego puedes empezar a migrar tus modelos de Pydantic v1 a v2 por grupos, en pasos graduales. 🚶

docs/es/docs/how-to/separate-openapi-schemas.md

@@ -1,6 +1,6 @@
 # Separación de Esquemas OpenAPI para Entrada y Salida o No { #separate-openapi-schemas-for-input-and-output-or-not }
 
-Desde que se lanzó **Pydantic v2**, el OpenAPI generado es un poco más exacto y **correcto** que antes. 😎
+Al usar **Pydantic v2**, el OpenAPI generado es un poco más exacto y **correcto** que antes. 😎
 
 De hecho, en algunos casos, incluso tendrá **dos JSON Schemas** en OpenAPI para el mismo modelo Pydantic, para entrada y salida, dependiendo de si tienen **valores por defecto**.
 
@@ -85,7 +85,7 @@ Probablemente el caso principal para esto es si ya tienes algún código cliente
 
 En ese caso, puedes desactivar esta funcionalidad en **FastAPI**, con el parámetro `separate_input_output_schemas=False`.
 
-/// info
+/// info | Información
 
 El soporte para `separate_input_output_schemas` fue agregado en FastAPI `0.102.0`. 🤓
 
@@ -100,3 +100,5 @@ Y ahora habrá un único esquema para entrada y salida para el modelo, solo `Ite
 <div class="screenshot">
 <img src="/img/tutorial/separate-openapi-schemas/image05.png">
 </div>
+
+Este es el mismo comportamiento que en Pydantic v1. 🤓

docs/es/docs/index.md

@@ -93,13 +93,13 @@ Las funcionalidades clave son:
 
 "_Estoy súper emocionado con **FastAPI**. ¡Es tan divertido!_"
 
-<div style="text-align: right; margin-right: 10%;">Brian Okken - <strong><a href="https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855" target="_blank">Python Bytes</a> host del podcast</strong> <a href="https://x.com/brianokken/status/1112220079972728832" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Brian Okken - <strong><a href="https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855" target="_blank">host del podcast Python Bytes</a></strong> <a href="https://x.com/brianokken/status/1112220079972728832" target="_blank"><small>(ref)</small></a></div>
 
 ---
 
 "_Honestamente, lo que has construido parece súper sólido y pulido. En muchos aspectos, es lo que quería que **Hug** fuera; es realmente inspirador ver a alguien construir eso._"
 
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creador</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">creador de Hug</a></strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
 
 ---
 
@@ -117,12 +117,6 @@ Las funcionalidades clave son:
 
 ---
 
-## Mini documental de FastAPI { #fastapi-mini-documentary }
-
-Hay un <a href="https://www.youtube.com/watch?v=mpR8ngthqiE" class="external-link" target="_blank">mini documental de FastAPI</a> lanzado a finales de 2025, puedes verlo online:
-
-<a href="https://www.youtube.com/watch?v=mpR8ngthqiE" target="_blank"><img src="https://fastapi.tiangolo.com/img/fastapi-documentary.jpg" alt="FastAPI Mini Documentary"></a>
-
 ## **Typer**, el FastAPI de las CLIs { #typer-the-fastapi-of-clis }
 
 <a href="https://typer.tiangolo.com" target="_blank"><img src="https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" style="width: 20%;"></a>
@@ -274,7 +268,7 @@ Verás la documentación interactiva automática de la API (proporcionada por <a
 
 ![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
 
-### Documentación alternativa de la API { #alternative-api-docs }
+### Documentación de API Alternativa { #alternative-api-docs }
 
 Y ahora, ve a <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
 
@@ -282,7 +276,7 @@ Verás la documentación alternativa automática (proporcionada por <a href="htt
 
 ![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
 
-## Actualización del ejemplo { #example-upgrade }
+## Actualización del Ejemplo { #example-upgrade }
 
 Ahora modifica el archivo `main.py` para recibir un body desde un request `PUT`.
 
@@ -320,7 +314,7 @@ def update_item(item_id: int, item: Item):
 
 El servidor `fastapi dev` debería recargarse automáticamente.
 
-### Actualización de la documentación interactiva de la API { #interactive-api-docs-upgrade }
+### Actualización de la Documentación Interactiva de la API { #interactive-api-docs-upgrade }
 
 Ahora ve a <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
 
@@ -336,7 +330,7 @@ Ahora ve a <a href="http://127.0.0.1:8000/docs" class="external-link" target="_b
 
 ![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-05-swagger-04.png)
 
-### Actualización de la documentación alternativa de la API { #alternative-api-docs-upgrade }
+### Actualización de la Documentación Alternativa de la API { #alternative-api-docs-upgrade }
 
 Y ahora, ve a <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
 
@@ -399,13 +393,13 @@ Volviendo al ejemplo de código anterior, **FastAPI**:
 * Validará que haya un `item_id` en el path para requests `GET` y `PUT`.
 * Validará que el `item_id` sea del tipo `int` para requests `GET` y `PUT`.
     * Si no lo es, el cliente verá un error útil y claro.
-* Revisa si hay un parámetro de query opcional llamado `q` (como en `http://127.0.0.1:8000/items/foo?q=somequery`) para requests `GET`.
+* Comprobará si hay un parámetro de query opcional llamado `q` (como en `http://127.0.0.1:8000/items/foo?q=somequery`) para requests `GET`.
     * Como el parámetro `q` está declarado con `= None`, es opcional.
     * Sin el `None` sería requerido (como lo es el body en el caso con `PUT`).
 * Para requests `PUT` a `/items/{item_id}`, leerá el body como JSON:
-    * Revisa que tiene un atributo requerido `name` que debe ser un `str`.
-    * Revisa que tiene un atributo requerido `price` que debe ser un `float`.
-    * Revisa que tiene un atributo opcional `is_offer`, que debe ser un `bool`, si está presente.
+    * Comprobará que tiene un atributo requerido `name` que debe ser un `str`.
+    * Comprobará que tiene un atributo requerido `price` que debe ser un `float`.
+    * Comprobará que tiene un atributo opcional `is_offer`, que debe ser un `bool`, si está presente.
     * Todo esto también funcionaría para objetos JSON profundamente anidados.
 * Convertirá de y a JSON automáticamente.
 * Documentará todo con OpenAPI, que puede ser usado por:

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

@@ -56,7 +56,7 @@ from app.routers import items
 
 La misma estructura de archivos con comentarios:
 
-```bash
+```
 .
 ├── app                  # "app" es un paquete de Python
 │   ├── __init__.py      # este archivo hace que "app" sea un "paquete de Python"
@@ -185,7 +185,7 @@ El resultado final es que los paths de item son ahora:
 * Todos incluirán las `responses` predefinidas.
 * Todas estas *path operations* tendrán la lista de `dependencies` evaluadas/ejecutadas antes de ellas.
   * Si también declaras dependencias en una *path operation* específica, **también se ejecutarán**.
-  * Las dependencias del router se ejecutan primero, luego las [`dependencies` en el decorador](dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank}, y luego las dependencias de parámetros normales.
+  * Las dependencias del router se ejecutan primero, luego las [dependencias en el decorador](dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank}, y luego las dependencias de parámetros normales.
   * También puedes agregar [dependencias de `Security` con `scopes`](../advanced/security/oauth2-scopes.md){.internal-link target=_blank}.
 
 /// tip | Consejo
@@ -214,7 +214,7 @@ Así que usamos un import relativo con `..` para las dependencias:
 
 /// tip | Consejo
 
-Si sabes perfectamente cómo funcionan los imports, continúa a la siguiente sección abajo.
+Si sabes perfectamente cómo funcionan los imports, continúa a la siguiente sección.
 
 ///
 
@@ -271,7 +271,7 @@ eso significaría:
 
 Eso se referiría a algún paquete arriba de `app/`, con su propio archivo `__init__.py`, etc. Pero no tenemos eso. Así que, eso lanzaría un error en nuestro ejemplo. 🚨
 
-Pero ahora sabes cómo funciona, para que puedas usar imports relativos en tus propias apps sin importar cuán complejas sean. 🤓
+Pero ahora sabes cómo funciona, para que puedas usar imports relativos en tus propias aplicaciones sin importar cuán complejas sean. 🤓
 
 ### Agregar algunos `tags`, `responses`, y `dependencies` personalizados { #add-some-custom-tags-responses-and-dependencies }
 
@@ -283,7 +283,7 @@ Pero aún podemos agregar _más_ `tags` que se aplicarán a una *path operation*
 
 /// tip | Consejo
 
-Esta última path operation tendrá la combinación de tags: `["items", "custom"]`.
+Esta última *path operation* tendrá la combinación de tags: `["items", "custom"]`.
 
 Y también tendrá ambas responses en la documentación, una para `404` y otra para `403`.
 
@@ -301,7 +301,7 @@ Y como la mayor parte de tu lógica ahora vivirá en su propio módulo específi
 
 ### Importar `FastAPI` { #import-fastapi }
 
-Importas y creas una clase `FastAPI` como normalmente.
+Importas y creas una clase `FastAPI` como de costumbre.
 
 Y podemos incluso declarar [dependencias globales](dependencies/global-dependencies.md){.internal-link target=_blank} que se combinarán con las dependencias para cada `APIRouter`:
 
@@ -398,7 +398,7 @@ Incluirá todas las rutas de ese router como parte de ella.
 
 En realidad creará internamente una *path operation* para cada *path operation* que fue declarada en el `APIRouter`.
 
-Así, detrás de escena, funcionará como si todo fuera la misma única app.
+Así, detrás de escena, funcionará como si todo fuera la misma única aplicación.
 
 ///
 
@@ -430,20 +430,20 @@ Podemos declarar todo eso sin tener que modificar el `APIRouter` original pasand
 
 De esa manera, el `APIRouter` original permanecerá sin modificar, por lo que aún podemos compartir ese mismo archivo `app/internal/admin.py` con otros proyectos en la organización.
 
-El resultado es que, en nuestra app, cada una de las *path operations* del módulo `admin` tendrá:
+El resultado es que, en nuestra aplicación, cada una de las *path operations* del módulo `admin` tendrá:
 
 * El prefix `/admin`.
 * El tag `admin`.
 * La dependencia `get_token_header`.
 * La response `418`. 🍵
 
-Pero eso solo afectará a ese `APIRouter` en nuestra app, no en ningún otro código que lo utilice.
+Pero eso solo afectará a ese `APIRouter` en nuestra aplicación, no en ningún otro código que lo utilice.
 
 Así, por ejemplo, otros proyectos podrían usar el mismo `APIRouter` con un método de autenticación diferente.
 
 ### Incluir una *path operation* { #include-a-path-operation }
 
-También podemos agregar *path operations* directamente a la app de `FastAPI`.
+También podemos agregar *path operations* directamente a la aplicación de `FastAPI`.
 
 Aquí lo hacemos... solo para mostrar que podemos 🤷:
 
@@ -461,13 +461,13 @@ Los `APIRouter`s no están "montados", no están aislados del resto de la aplica
 
 Esto se debe a que queremos incluir sus *path operations* en el esquema de OpenAPI y las interfaces de usuario.
 
-Como no podemos simplemente aislarlos y "montarlos" independientemente del resto, las *path operations* se "clonan" (se vuelven a crear), no se incluyen directamente.
+Como no podemos simplemente aislarlos y "montarlos" independientemente del resto, se "clonan" las *path operations* (se vuelven a crear), no se incluyen directamente.
 
 ///
 
 ## Revisa la documentación automática de la API { #check-the-automatic-api-docs }
 
-Ahora, ejecuta tu app:
+Ahora, ejecuta tu aplicación:
 
 <div class="termy">
 
@@ -481,7 +481,7 @@ $ fastapi dev app/main.py
 
 Y abre la documentación en <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
 
-Verás la documentación automática de la API, incluyendo los paths de todos los submódulos, usando los paths correctos (y prefijos) y los tags correctos:
+Verás la documentación automática de la API, incluyendo los paths de todos los submódulos, usando los paths correctos (y prefijos) y las tags correctas:
 
 <img src="/img/tutorial/bigger-applications/image01.png">
 
@@ -501,4 +501,4 @@ De la misma manera que puedes incluir un `APIRouter` en una aplicación `FastAPI
 router.include_router(other_router)
 ```
 
-Asegúrate de hacerlo antes de incluir `router` en la app de `FastAPI`, para que las *path operations* de `other_router` también se incluyan.
+Asegúrate de hacerlo antes de incluir `router` en la aplicación de `FastAPI`, para que las *path operations* de `other_router` también se incluyan.

docs/es/docs/tutorial/body-updates.md

@@ -1,4 +1,4 @@
-# Body - Actualizaciones { #body-updates }
+# Cuerpo - Actualizaciones { #body-updates }
 
 ## Actualización reemplazando con `PUT` { #update-replacing-with-put }
 
@@ -50,6 +50,14 @@ Si quieres recibir actualizaciones parciales, es muy útil usar el parámetro `e
 
 Como `item.model_dump(exclude_unset=True)`.
 
+/// info | Información
+
+En Pydantic v1 el método se llamaba `.dict()`, fue deprecado (pero aún soportado) en Pydantic v2, y renombrado a `.model_dump()`.
+
+Los ejemplos aquí usan `.dict()` para compatibilidad con Pydantic v1, pero deberías usar `.model_dump()` si puedes usar Pydantic v2.
+
+///
+
 Eso generaría un `dict` solo con los datos que se establecieron al crear el modelo `item`, excluyendo los valores por defecto.
 
 Luego puedes usar esto para generar un `dict` solo con los datos que se establecieron (enviados en el request), omitiendo los valores por defecto:
@@ -60,6 +68,14 @@ Luego puedes usar esto para generar un `dict` solo con los datos que se establec
 
 Ahora, puedes crear una copia del modelo existente usando `.model_copy()`, y pasar el parámetro `update` con un `dict` que contenga los datos a actualizar.
 
+/// info | Información
+
+En Pydantic v1 el método se llamaba `.copy()`, fue deprecado (pero aún soportado) en Pydantic v2, y renombrado a `.model_copy()`.
+
+Los ejemplos aquí usan `.copy()` para compatibilidad con Pydantic v1, pero deberías usar `.model_copy()` si puedes usar Pydantic v2.
+
+///
+
 Como `stored_item_model.model_copy(update=update_data)`:
 
 {* ../../docs_src/body_updates/tutorial002_py310.py hl[33] *}
@@ -74,9 +90,9 @@ En resumen, para aplicar actualizaciones parciales deberías:
 * Generar un `dict` sin valores por defecto del modelo de entrada (usando `exclude_unset`).
     * De esta manera puedes actualizar solo los valores realmente establecidos por el usuario, en lugar de sobrescribir valores ya almacenados con valores por defecto en tu modelo.
 * Crear una copia del modelo almacenado, actualizando sus atributos con las actualizaciones parciales recibidas (usando el parámetro `update`).
-* Convertir el modelo copiado en algo que pueda almacenarse en tu DB (por ejemplo, usando el `jsonable_encoder`).
+* Convertir el modelo copiado en algo que pueda almacenarse en tu base de datos (por ejemplo, usando el `jsonable_encoder`).
     * Esto es comparable a usar el método `.model_dump()` del modelo de nuevo, pero asegura (y convierte) los valores a tipos de datos que pueden convertirse a JSON, por ejemplo, `datetime` a `str`.
-* Guardar los datos en tu DB.
+* Guardar los datos en tu base de datos.
 * Devolver el modelo actualizado.
 
 {* ../../docs_src/body_updates/tutorial002_py310.py hl[28:35] *}

docs/es/docs/tutorial/body.md

@@ -32,8 +32,7 @@ Usa tipos estándar de Python para todos los atributos:
 
 {* ../../docs_src/body/tutorial001_py310.py hl[5:9] *}
 
-
-Al igual que al declarar parámetros de query, cuando un atributo del modelo tiene un valor por defecto, no es obligatorio. De lo contrario, es obligatorio. Usa `None` para hacerlo solo opcional.
+Al igual que al declarar parámetros de query, cuando un atributo del modelo tiene un valor por defecto, no es obligatorio. De lo contrario, es obligatorio. Usa `None` para hacerlo opcional.
 
 Por ejemplo, el modelo anterior declara un “`object`” JSON (o `dict` en Python) como:
 
@@ -128,6 +127,14 @@ Dentro de la función, puedes acceder a todos los atributos del objeto modelo di
 
 {* ../../docs_src/body/tutorial002_py310.py *}
 
+/// info | Información
+
+En Pydantic v1 el método se llamaba `.dict()`, se marcó como obsoleto (pero sigue soportado) en Pydantic v2, y se renombró a `.model_dump()`.
+
+Los ejemplos aquí usan `.dict()` por compatibilidad con Pydantic v1, pero deberías usar `.model_dump()` si puedes usar Pydantic v2.
+
+///
+
 ## Request body + parámetros de path { #request-body-path-parameters }
 
 Puedes declarar parámetros de path y request body al mismo tiempo.
@@ -136,7 +143,6 @@ Puedes declarar parámetros de path y request body al mismo tiempo.
 
 {* ../../docs_src/body/tutorial003_py310.py hl[15:16] *}
 
-
 ## Request body + path + parámetros de query { #request-body-path-query-parameters }
 
 También puedes declarar parámetros de **body**, **path** y **query**, todos al mismo tiempo.
@@ -149,7 +155,7 @@ Los parámetros de la función se reconocerán de la siguiente manera:
 
 * Si el parámetro también se declara en el **path**, se utilizará como un parámetro de path.
 * Si el parámetro es de un **tipo singular** (como `int`, `float`, `str`, `bool`, etc.), se interpretará como un parámetro de **query**.
-* Si el parámetro se declara como del tipo de un **modelo de Pydantic**, se interpretará como un **body** de request.
+* Si el parámetro se declara como del tipo de un **modelo de Pydantic**, se interpretará como un **request body**.
 
 /// note | Nota
 

docs/es/docs/tutorial/extra-models.md

@@ -22,13 +22,21 @@ Aquí tienes una idea general de cómo podrían ser los modelos con sus campos d
 
 {* ../../docs_src/extra_models/tutorial001_py310.py hl[7,9,14,20,22,27:28,31:33,38:39] *}
 
-### Acerca de `**user_in.model_dump()` { #about-user-in-model-dump }
+/// info | Información
 
-#### `.model_dump()` de Pydantic { #pydantics-model-dump }
+En Pydantic v1 el método se llamaba `.dict()`, fue deprecado (pero aún soportado) en Pydantic v2, y renombrado a `.model_dump()`.
+
+Los ejemplos aquí usan `.dict()` para compatibilidad con Pydantic v1, pero deberías usar `.model_dump()` en su lugar si puedes usar Pydantic v2.
+
+///
+
+### Acerca de `**user_in.dict()` { #about-user-in-dict }
+
+#### `.dict()` de Pydantic { #pydantics-dict }
 
 `user_in` es un modelo Pydantic de la clase `UserIn`.
 
-Los modelos Pydantic tienen un método `.model_dump()` que devuelve un `dict` con los datos del modelo.
+Los modelos Pydantic tienen un método `.dict()` que devuelve un `dict` con los datos del modelo.
 
 Así que, si creamos un objeto Pydantic `user_in` como:
 
@@ -39,7 +47,7 @@ user_in = UserIn(username="john", password="secret", email="john.doe@example.com
 y luego llamamos a:
 
 ```Python
-user_dict = user_in.model_dump()
+user_dict = user_in.dict()
 ```
 
 ahora tenemos un `dict` con los datos en la variable `user_dict` (es un `dict` en lugar de un objeto modelo Pydantic).
@@ -50,7 +58,7 @@ Y si llamamos a:
 print(user_dict)
 ```
 
-obtendríamos un `dict` de Python con:
+obtendremos un `dict` de Python con:
 
 ```Python
 {
@@ -95,20 +103,20 @@ UserInDB(
 
 #### Un modelo Pydantic a partir del contenido de otro { #a-pydantic-model-from-the-contents-of-another }
 
-Como en el ejemplo anterior obtuvimos `user_dict` de `user_in.model_dump()`, este código:
+Como en el ejemplo anterior obtuvimos `user_dict` de `user_in.dict()`, este código:
 
 ```Python
-user_dict = user_in.model_dump()
+user_dict = user_in.dict()
 UserInDB(**user_dict)
 ```
 
 sería equivalente a:
 
 ```Python
-UserInDB(**user_in.model_dump())
+UserInDB(**user_in.dict())
 ```
 
-...porque `user_in.model_dump()` es un `dict`, y luego hacemos que Python lo "desempaquete" al pasarlo a `UserInDB` con el prefijo `**`.
+...porque `user_in.dict()` es un `dict`, y luego hacemos que Python lo "desempaquete" al pasarlo a `UserInDB` con el prefijo `**`.
 
 Así, obtenemos un modelo Pydantic a partir de los datos en otro modelo Pydantic.
 
@@ -117,7 +125,7 @@ Así, obtenemos un modelo Pydantic a partir de los datos en otro modelo Pydantic
 Y luego agregando el argumento de palabra clave adicional `hashed_password=hashed_password`, como en:
 
 ```Python
-UserInDB(**user_in.model_dump(), hashed_password=hashed_password)
+UserInDB(**user_in.dict(), hashed_password=hashed_password)
 ```
 
 ...termina siendo como:
@@ -148,7 +156,7 @@ Y estos modelos están compartiendo muchos de los datos y duplicando nombres y t
 
 Podríamos hacerlo mejor.
 
-Podemos declarar un modelo `UserBase` que sirva como base para nuestros otros modelos. Y luego podemos hacer subclases de ese modelo que heredan sus atributos (declaraciones de tipos, validación, etc).
+Podemos declarar un modelo `UserBase` que sirva como base para nuestros otros modelos. Y luego podemos hacer subclases de ese modelo que heredan sus atributos (anotaciones de tipos, validación, etc).
 
 Toda la conversión de datos, validación, documentación, etc. seguirá funcionando normalmente.
 
@@ -172,19 +180,20 @@ Al definir una <a href="https://docs.pydantic.dev/latest/concepts/types/#unions"
 
 {* ../../docs_src/extra_models/tutorial003_py310.py hl[1,14:15,18:20,33] *}
 
+
 ### `Union` en Python 3.10 { #union-in-python-3-10 }
 
 En este ejemplo pasamos `Union[PlaneItem, CarItem]` como el valor del argumento `response_model`.
 
-Porque lo estamos pasando como un **valor a un argumento** en lugar de ponerlo en una **anotación de tipos**, tenemos que usar `Union` incluso en Python 3.10.
+Porque lo estamos pasando como un **valor a un argumento** en lugar de ponerlo en **anotaciones de tipos**, tenemos que usar `Union` incluso en Python 3.10.
 
-Si estuviera en una anotación de tipos podríamos haber usado la barra vertical, como:
+Si estuviera en anotaciones de tipos podríamos haber usado la barra vertical, como:
 
 ```Python
 some_variable: PlaneItem | CarItem
 ```
 
-Pero si ponemos eso en la asignación `response_model=PlaneItem | CarItem` obtendríamos un error, porque Python intentaría realizar una **operación inválida** entre `PlaneItem` y `CarItem` en lugar de interpretar eso como una anotación de tipos.
+Pero si ponemos eso en la asignación `response_model=PlaneItem | CarItem` obtendríamos un error, porque Python intentaría realizar una **operación inválida** entre `PlaneItem` y `CarItem` en lugar de interpretar eso como anotaciones de tipos.
 
 ## Lista de modelos { #list-of-models }
 
@@ -194,6 +203,7 @@ Para eso, usa el `typing.List` estándar de Python (o simplemente `list` en Pyth
 
 {* ../../docs_src/extra_models/tutorial004_py39.py hl[18] *}
 
+
 ## Response con `dict` arbitrario { #response-with-arbitrary-dict }
 
 También puedes declarar un response usando un `dict` arbitrario plano, declarando solo el tipo de las claves y valores, sin usar un modelo Pydantic.
@@ -204,6 +214,7 @@ En este caso, puedes usar `typing.Dict` (o solo `dict` en Python 3.9 y posterior
 
 {* ../../docs_src/extra_models/tutorial005_py39.py hl[6] *}
 
+
 ## Recapitulación { #recap }
 
 Usa múltiples modelos Pydantic y hereda libremente para cada caso.

docs/es/docs/tutorial/query-params-str-validations.md

@@ -109,7 +109,7 @@ FastAPI ahora:
 
 ## Alternativa (antigua): `Query` como valor por defecto { #alternative-old-query-as-the-default-value }
 
-Versiones anteriores de FastAPI (antes de <abbr title="before 2023-03 - antes de 2023-03">0.95.0</abbr>) requerían que usaras `Query` como el valor por defecto de tu parámetro, en lugar de ponerlo en `Annotated`, hay una alta probabilidad de que veas código usándolo alrededor, así que te lo explicaré.
+Versiones anteriores de FastAPI (antes de <abbr title="antes de 2023-03">0.95.0</abbr>) requerían que usaras `Query` como el valor por defecto de tu parámetro, en lugar de ponerlo en `Annotated`, hay una alta probabilidad de que veas código usándolo alrededor, así que te lo explicaré.
 
 /// tip | Consejo
 
@@ -192,7 +192,7 @@ También puedes agregar un parámetro `min_length`:
 
 ## Agregar expresiones regulares { #add-regular-expressions }
 
-Puedes definir una <abbr title="Una expresión regular, regex o regexp es una secuencia de caracteres que define un patrón de búsqueda para strings.">expresión regular</abbr> `pattern` que el parámetro debe coincidir:
+Puedes definir un <abbr title="Una expresión regular, regex o regexp es una secuencia de caracteres que define un patrón de búsqueda para strings.">expresión regular</abbr> `pattern` que el parámetro debe coincidir:
 
 {* ../../docs_src/query_params_str_validations/tutorial004_an_py310.py hl[11] *}
 
@@ -206,6 +206,20 @@ Si te sientes perdido con todas estas ideas de **"expresión regular"**, no te p
 
 Ahora sabes que cuando las necesites puedes usarlas en **FastAPI**.
 
+### Pydantic v1 `regex` en lugar de `pattern` { #pydantic-v1-regex-instead-of-pattern }
+
+Antes de la versión 2 de Pydantic y antes de FastAPI 0.100.0, el parámetro se llamaba `regex` en lugar de `pattern`, pero ahora está en desuso.
+
+Todavía podrías ver algo de código que lo usa:
+
+//// tab | Pydantic v1
+
+{* ../../docs_src/query_params_str_validations/tutorial004_regex_an_py310.py hl[11] *}
+
+////
+
+Pero que sepas que esto está deprecado y debería actualizarse para usar el nuevo parámetro `pattern`. 🤓
+
 ## Valores por defecto { #default-values }
 
 Puedes, por supuesto, usar valores por defecto diferentes de `None`.
@@ -266,7 +280,7 @@ Entonces, con una URL como:
 http://localhost:8000/items/?q=foo&q=bar
 ```
 
-recibirías los múltiples valores de los *query parameters* `q` (`foo` y `bar`) en una `list` de Python dentro de tu *path operation function*, en el *parámetro de función* `q`.
+recibirías los múltiples valores del *query parameter* `q` (`foo` y `bar`) en una `list` de Python dentro de tu *path operation function*, en el *parámetro de función* `q`.
 
 Entonces, el response a esa URL sería:
 
@@ -372,7 +386,7 @@ Entonces puedes declarar un `alias`, y ese alias será usado para encontrar el v
 
 Ahora digamos que ya no te gusta este parámetro.
 
-Tienes que dejarlo allí por un tiempo porque hay clientes usándolo, pero quieres que la documentación lo muestre claramente como <abbr title="obsolete, recommended not to use it - obsoleto, se recomienda no usarlo">deprecated</abbr>.
+Tienes que dejarlo allí por un tiempo porque hay clientes usándolo, pero quieres que la documentación lo muestre claramente como <abbr title="obsoleto, se recomienda no usarlo">deprecated</abbr>.
 
 Luego pasa el parámetro `deprecated=True` a `Query`:
 
@@ -402,7 +416,7 @@ Pydantic también tiene <a href="https://docs.pydantic.dev/latest/concepts/valid
 
 ///
 
-Por ejemplo, este validador personalizado comprueba que el ID del ítem empiece con `isbn-` para un número de libro <abbr title="ISBN means International Standard Book Number - ISBN significa International Standard Book Number">ISBN</abbr> o con `imdb-` para un ID de URL de película de <abbr title="IMDB (Internet Movie Database) is a website with information about movies - IMDB (Internet Movie Database) es un sitio web con información sobre películas">IMDB</abbr>:
+Por ejemplo, este validador personalizado comprueba que el ID del ítem empiece con `isbn-` para un número de libro <abbr title="International Standard Book Number – Número Estándar Internacional de Libro">ISBN</abbr> o con `imdb-` para un ID de URL de película de <abbr title="IMDB (Internet Movie Database) es un sitio web con información sobre películas">IMDB</abbr>:
 
 {* ../../docs_src/query_params_str_validations/tutorial015_an_py310.py hl[5,16:19,24] *}
 
@@ -436,7 +450,7 @@ Pero si te da curiosidad este ejemplo de código específico y sigues entretenid
 
 #### Un ítem aleatorio { #a-random-item }
 
-Con `data.items()` obtenemos un <abbr title="Algo que podemos iterar con un for loop, como una list, set, etc.">objeto iterable</abbr> con tuplas que contienen la clave y el valor para cada elemento del diccionario.
+Con `data.items()` obtenemos un <abbr title="Algo que podemos iterar con un for, como una list, set, etc.">objeto iterable</abbr> con tuplas que contienen la clave y el valor para cada elemento del diccionario.
 
 Convertimos este objeto iterable en una `list` propiamente dicha con `list(data.items())`.
 

docs/es/docs/tutorial/response-model.md

@@ -2,7 +2,7 @@
 
 Puedes declarar el tipo utilizado para el response anotando el **tipo de retorno** de la *path operation function*.
 
-Puedes utilizar **anotaciones de tipos** de la misma manera que lo harías para datos de entrada en **parámetros** de función, puedes utilizar modelos de Pydantic, lists, diccionarios, valores escalares como enteros, booleanos, etc.
+Puedes utilizar **anotaciones de tipos** de la misma manera que lo harías para datos de entrada en **parámetros** de función, puedes utilizar modelos de Pydantic, list, diccionarios, valores escalares como enteros, booleanos, etc.
 
 {* ../../docs_src/response_model/tutorial001_01_py310.py hl[16,21] *}
 
@@ -27,7 +27,7 @@ Por ejemplo, podrías querer **devolver un diccionario** u objeto de base de dat
 
 Si añadiste la anotación del tipo de retorno, las herramientas y editores se quejarían con un error (correcto) diciéndote que tu función está devolviendo un tipo (por ejemplo, un dict) que es diferente de lo que declaraste (por ejemplo, un modelo de Pydantic).
 
-En esos casos, puedes usar el parámetro del *decorador de path operation* `response_model` en lugar del tipo de retorno.
+En esos casos, puedes usar el parámetro del decorador de path operation `response_model` en lugar del tipo de retorno.
 
 Puedes usar el parámetro `response_model` en cualquiera de las *path operations*:
 
@@ -153,7 +153,7 @@ Primero vamos a ver cómo los editores, mypy y otras herramientas verían esto.
 
 `BaseUser` tiene los campos base. Luego `UserIn` hereda de `BaseUser` y añade el campo `password`, por lo que incluirá todos los campos de ambos modelos.
 
-Anotamos el tipo de retorno de la función como `BaseUser`, pero en realidad estamos devolviendo un `UserIn` instance.
+Anotamos el tipo de retorno de la función como `BaseUser`, pero en realidad estamos devolviendo un instance de `UserIn`.
 
 El editor, mypy y otras herramientas no se quejarán de esto porque, en términos de tipificación, `UserIn` es una subclase de `BaseUser`, lo que significa que es un tipo *válido* cuando se espera algo que es un `BaseUser`.
 
@@ -252,6 +252,20 @@ Entonces, si envías un request a esa *path operation* para el ítem con ID `foo
 
 /// info | Información
 
+En Pydantic v1 el método se llamaba `.dict()`, fue deprecado (pero aún soportado) en Pydantic v2, y renombrado a `.model_dump()`.
+
+Los ejemplos aquí usan `.dict()` para compatibilidad con Pydantic v1, pero deberías usar `.model_dump()` en su lugar si puedes usar Pydantic v2.
+
+///
+
+/// info | Información
+
+FastAPI usa el método `.dict()` del modelo de Pydantic con <a href="https://docs.pydantic.dev/1.10/usage/exporting_models/#modeldict" class="external-link" target="_blank">su parámetro `exclude_unset`</a> para lograr esto.
+
+///
+
+/// info | Información
+
 También puedes usar:
 
 * `response_model_exclude_defaults=True`

docs/es/docs/tutorial/schema-extra-example.md

@@ -8,13 +8,35 @@ Aquí tienes varias formas de hacerlo.
 
 Puedes declarar `examples` para un modelo de Pydantic que se añadirá al JSON Schema generado.
 
+//// tab | Pydantic v2
+
 {* ../../docs_src/schema_extra_example/tutorial001_py310.py hl[13:24] *}
 
-Esa información extra se añadirá tal cual al **JSON Schema** resultante para ese modelo, y se usará en la documentación de la API.
+////
 
-Puedes usar el atributo `model_config` que toma un `dict` como se describe en <a href="https://docs.pydantic.dev/latest/api/config/" class="external-link" target="_blank">la documentación de Pydantic: Configuración</a>.
+//// tab | Pydantic v1
 
-Puedes establecer `"json_schema_extra"` con un `dict` que contenga cualquier dato adicional que te gustaría que aparezca en el JSON Schema generado, incluyendo `examples`.
+{* ../../docs_src/schema_extra_example/tutorial001_pv1_py310.py hl[13:23] *}
+
+////
+
+Esa información extra se añadirá tal cual al **JSON Schema** generado para ese modelo, y se usará en la documentación de la API.
+
+//// tab | Pydantic v2
+
+En Pydantic versión 2, usarías el atributo `model_config`, que toma un `dict` como se describe en <a href="https://docs.pydantic.dev/latest/api/config/" class="external-link" target="_blank">la documentación de Pydantic: Configuración</a>.
+
+Puedes establecer `"json_schema_extra"` con un `dict` que contenga cualquier dato adicional que desees que aparezca en el JSON Schema generado, incluyendo `examples`.
+
+////
+
+//// tab | Pydantic v1
+
+En Pydantic versión 1, usarías una clase interna `Config` y `schema_extra`, como se describe en <a href="https://docs.pydantic.dev/1.10/usage/schema/#schema-customization" class="external-link" target="_blank">la documentación de Pydantic: Personalización de Esquema</a>.
+
+Puedes establecer `schema_extra` con un `dict` que contenga cualquier dato adicional que desees que aparezca en el JSON Schema generado, incluyendo `examples`.
+
+////
 
 /// tip | Consejo
 
@@ -28,7 +50,7 @@ Por ejemplo, podrías usarlo para añadir metadatos para una interfaz de usuario
 
 OpenAPI 3.1.0 (usado desde FastAPI 0.99.0) añadió soporte para `examples`, que es parte del estándar de **JSON Schema**.
 
-Antes de eso, solo soportaba la palabra clave `example` con un solo ejemplo. Eso aún es soportado por OpenAPI 3.1.0, pero está obsoleto y no es parte del estándar de JSON Schema. Así que se te anima a migrar `example` a `examples`. 🤓
+Antes de eso, solo soportaba la palabra clave `example` con un solo ejemplo. Eso aún es soportado por OpenAPI 3.1.0, pero está obsoleto y no es parte del estándar de JSON Schema. Así que se recomienda migrar de `example` a `examples`. 🤓
 
 Puedes leer más al final de esta página.
 
@@ -72,7 +94,7 @@ Por supuesto, también puedes pasar múltiples `examples`:
 
 {* ../../docs_src/schema_extra_example/tutorial004_an_py310.py hl[23:38] *}
 
-Cuando haces esto, los ejemplos serán parte del **JSON Schema** interno para esos datos del body.
+Cuando haces esto, los ejemplos serán parte del **JSON Schema** interno para esos datos de body.
 
 Sin embargo, al <abbr title="2023-08-26">momento de escribir esto</abbr>, Swagger UI, la herramienta encargada de mostrar la interfaz de documentación, no soporta mostrar múltiples ejemplos para los datos en **JSON Schema**. Pero lee más abajo para una solución alternativa.
 
@@ -181,17 +203,17 @@ Debido a eso, las versiones de FastAPI anteriores a 0.99.0 todavía usaban versi
 
 ### `examples` de Pydantic y FastAPI { #pydantic-and-fastapi-examples }
 
-Cuando añades `examples` dentro de un modelo de Pydantic, usando `schema_extra` o `Field(examples=["something"])`, ese ejemplo se añade al **JSON Schema** para ese modelo de Pydantic.
+Cuando añades `examples` dentro de un modelo de Pydantic, usando `schema_extra` o `Field(examples=["algo"])`, ese ejemplo se añade al **JSON Schema** para ese modelo de Pydantic.
 
 Y ese **JSON Schema** del modelo de Pydantic se incluye en el **OpenAPI** de tu API, y luego se usa en la interfaz de documentación.
 
-En las versiones de FastAPI antes de 0.99.0 (0.99.0 y superiores usan el nuevo OpenAPI 3.1.0) cuando usabas `example` o `examples` con cualquiera de las otras utilidades (`Query()`, `Body()`, etc.) esos ejemplos no se añadían al JSON Schema que describe esos datos (ni siquiera a la propia versión de JSON Schema de OpenAPI), se añadían directamente a la declaración de la *path operation* en OpenAPI (fuera de las partes de OpenAPI que usan JSON Schema).
+En las versiones de FastAPI antes de 0.99.0 (0.99.0 y superior usan el nuevo OpenAPI 3.1.0) cuando usabas `example` o `examples` con cualquiera de las otras utilidades (`Query()`, `Body()`, etc.) esos ejemplos no se añadían al JSON Schema que describe esos datos (ni siquiera a la propia versión de JSON Schema de OpenAPI), se añadían directamente a la declaración de la *path operation* en OpenAPI (fuera de las partes de OpenAPI que usan JSON Schema).
 
 Pero ahora que FastAPI 0.99.0 y superiores usa OpenAPI 3.1.0, que usa JSON Schema 2020-12, y Swagger UI 5.0.0 y superiores, todo es más consistente y los ejemplos se incluyen en JSON Schema.
 
 ### Swagger UI y `examples` específicos de OpenAPI { #swagger-ui-and-openapi-specific-examples }
 
-Ahora, como Swagger UI no soportaba múltiples ejemplos de JSON Schema (a fecha de 2023-08-26), los usuarios no tenían una forma de mostrar múltiples ejemplos en la documentación.
+Ahora, como Swagger UI no soportaba múltiples ejemplos de JSON Schema (a fecha de 2023-08-26), los usuarios no tenían una forma de mostrar múltiples ejemplos en los documentos.
 
 Para resolver eso, FastAPI `0.103.0` **añadió soporte** para declarar el mismo viejo campo **específico de OpenAPI** `examples` con el nuevo parámetro `openapi_examples`. 🤓
 

docs/fr/llm-prompt.md

@@ -6,127 +6,123 @@ Language code: fr.
 
 ### Grammar to use when talking to the reader
 
-Use the formal grammar (use `vous` instead of `tu`).
-
-Additionally, in instructional sentences, prefer the present tense for obligations:
-
-- Prefer `vous devez …` over `vous devrez …`, unless the English source explicitly refers to a future requirement.
-
-- When translating “make sure (that) … is …”, prefer the indicative after `vous assurer que` (e.g. `Vous devez vous assurer qu'il est …`) instead of the subjunctive (e.g. `qu'il soit …`).
+Use the formal grammar (use «vous» instead of «tu»).
 
 ### Quotes
 
-- Convert neutral double quotes (`"`) to French guillemets (`«` and `»`).
+1) Convert neutral double quotes («"») and English double typographic quotes («“» and «”») to French guillemets (««» and «»»).
 
-- Do not convert quotes inside code blocks, inline code, paths, URLs, or anything wrapped in backticks.
+2) In the French docs, guillemets are written without extra spaces: use «texte», not « texte ».
+
+3) Do not convert quotes inside code blocks, inline code, paths, URLs, or anything wrapped in backticks.
 
 Examples:
 
-Source (English):
+    Source (English):
 
-```
-"Hello world"
-“Hello Universe”
-"He said: 'Hello'"
-"The module is `__main__`"
-```
+        «««
+        "Hello world"
+        “Hello Universe”
+        "He said: 'Hello'"
+        "The module is `__main__`"
+        »»»
 
-Result (French):
+    Result (French):
 
-```
-"Hello world"
-“Hello Universe”
-"He said: 'Hello'"
-"The module is `__main__`"
-```
+        «««
+        «Hello world»
+        «Hello Universe»
+        «He said: 'Hello'»
+        «The module is `__main__`»
+        »»»
 
 ### Ellipsis
 
-- Make sure there is a space between an ellipsis and a word following or preceding the ellipsis.
+1) Make sure there is a space between an ellipsis and a word following or preceding the ellipsis.
 
 Examples:
 
-Source (English):
+    Source (English):
 
-```
-...as we intended.
-...this would work:
-...etc.
-others...
-More to come...
-```
+        «««
+        ...as we intended.
+        ...this would work:
+        ...etc.
+        others...
+        More to come...
+        »»»
 
-Result (French):
+    Result (French):
 
-```
-... comme prévu.
-... cela fonctionnerait :
-... etc.
-D'autres ...
-La suite ...
-```
+        «««
+        ... comme prévu.
+        ... cela fonctionnerait :
+        ... etc.
+        D'autres ...
+        La suite ...
+        »»»
 
-- This does not apply in URLs, code blocks, and code snippets. Do not remove or add spaces there.
+2) This does not apply in URLs, code blocks, and code snippets. Do not remove or add spaces there.
 
 ### Headings
 
-- Prefer translating headings using the infinitive form (as is common in the existing French docs): `Créer…`, `Utiliser…`, `Ajouter…`.
+1) Prefer translating headings using the infinitive form (as is common in the existing French docs): «Créer…», «Utiliser…», «Ajouter…».
 
-- For headings that are instructions written in imperative in English (e.g. `Go check …`), keep them in imperative in French, using the formal grammar (e.g. `Allez voir …`).
+2) For headings that are instructions written in imperative in English (e.g. “Go check …”), keep them in imperative in French, using the formal grammar (e.g. «Allez voir …»).
+
+3) Keep heading punctuation as in the source. In particular, keep occurrences of literal « - » (space-hyphen-space) as « - » (the existing French docs use a hyphen here).
 
 ### French instructions about technical terms
 
-Do not try to translate everything. In particular, keep common programming terms (e.g. `framework`, `endpoint`, `plug-in`, `payload`).
+Do not try to translate everything. In particular, keep common programming terms when that is the established usage in the French docs (e.g. «framework», «endpoint», «plug-in», «payload»). Use French where the existing docs already consistently use French (e.g. «requête», «réponse»).
 
 Keep class names, function names, modules, file names, and CLI commands unchanged.
 
 ### List of English terms and their preferred French translations
 
-Below is a list of English terms and their preferred French translations, separated by a colon (:). Use these translations, do not use your own. If an existing translation does not use these terms, update it to use them.
+Below is a list of English terms and their preferred French translations, separated by a colon («:»). Use these translations, do not use your own. If an existing translation does not use these terms, update it to use them.
 
-- /// note | Technical Details»: /// note | Détails techniques
-- /// note: /// note | Remarque
-- /// tip: /// tip | Astuce
-- /// warning: /// warning | Alertes
-- /// check: /// check | Vérifications
-- /// info: /// info
+* «/// note | Technical Details»: «/// note | Détails techniques»
+* «/// note»: «/// note | Remarque»
+* «/// tip»: «/// tip | Astuce»
+* «/// warning»: «/// warning | Attention»
+* «/// check»: «/// check | vérifier»
+* «/// info»: «/// info»
 
-- the docs: les documents
-- the documentation: la documentation
+* «the docs»: «les documents»
+* «the documentation»: «la documentation»
 
-- Exclude from OpenAPI: Exclusion d'OpenAPI
+* «framework»: «framework» (do not translate to «cadre»)
+* «performance»: «performance»
 
-- framework: framework (do not translate to cadre)
-- performance: performance
+* «type hints»: «annotations de type»
+* «type annotations»: «annotations de type»
 
-- type hints: annotations de type
-- type annotations: annotations de type
+* «autocomplete»: «autocomplétion»
+* «autocompletion»: «autocomplétion»
 
-- autocomplete: autocomplétion
-- autocompletion: autocomplétion
+* «the request» (what the client sends to the server): «la requête»
+* «the response» (what the server sends back to the client): «la réponse»
 
-- the request (what the client sends to the server): la requête
-- the response (what the server sends back to the client): la réponse
+* «the request body»: «le corps de la requête»
+* «the response body»: «le corps de la réponse»
 
-- the request body: le corps de la requête
-- the response body: le corps de la réponse
+* «path operation»: «opération de chemin»
+* «path operations» (plural): «opérations de chemin»
+* «path operation function»: «fonction de chemin»
+* «path operation decorator»: «décorateur d'opération de chemin»
 
-- path operation: chemin d'accès
-- path operations (plural): chemins d'accès
-- path operation function: fonction de chemin d'accès
-- path operation decorator: décorateur de chemin d'accès
+* «path parameter»: «paramètre de chemin»
+* «query parameter»: «paramètre de requête»
 
-- path parameter: paramètre de chemin
-- query parameter: paramètre de requête
+* «the `Request`»: «`Request`» (keep as code identifier)
+* «the `Response`»: «`Response`» (keep as code identifier)
 
-- the `Request`: `Request` (keep as code identifier)
-- the `Response`: `Response` (keep as code identifier)
+* «deployment»: «déploiement»
+* «to upgrade»: «mettre à niveau»
 
-- deployment: déploiement
-- to upgrade: mettre à niveau
+* «deprecated»: «déprécié»
+* «to deprecate»: «déprécier»
 
-- deprecated: déprécié
-- to deprecate: déprécier
-
-- cheat sheet: aide-mémoire
-- plug-in: plug-in
+* «cheat sheet»: «aide-mémoire»
+* «plug-in»: «plug-in»

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

@@ -1,5 +1,5 @@
 import re
-from typing import TypedDict, Union
+from typing import TypedDict
 
 CODE_INCLUDE_RE = re.compile(r"^\{\*\s*(\S+)\s*(.*)\*\}$")
 CODE_INCLUDE_PLACEHOLDER = "<CODE_INCLUDE>"
@@ -50,8 +50,8 @@ class MarkdownLinkInfo(TypedDict):
     line_no: int
     url: str
     text: str
-    title: Union[str, None]
-    attributes: Union[str, None]
+    title: str | None
+    attributes: str | None
     full_match: str
 
 
@@ -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
@@ -285,11 +285,7 @@ def _add_lang_code_to_url(url: str, lang_code: str) -> str:
 
 
 def _construct_markdown_link(
-    url: str,
-    text: str,
-    title: Union[str, None],
-    attributes: Union[str, None],
-    lang_code: str,
+    url: str, text: str, title: str | None, attributes: str | None, lang_code: str
 ) -> str:
     """
     Construct a markdown link, adjusting the URL for the given language code if needed.
@@ -351,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
     """
 
@@ -469,7 +465,7 @@ def replace_html_links(
 
 
 # Multiline code blocks
-# --------------------------------------------------------------------------------------
+# -----------------------------------------------------------------------------------------
 
 
 def get_code_block_lang(line: str) -> str:
@@ -549,7 +545,7 @@ def extract_multiline_code_blocks(text: list[str]) -> list[MultilineCodeBlockInf
     return blocks
 
 
-def _split_hash_comment(line: str) -> tuple[str, Union[str, None]]:
+def _split_hash_comment(line: str) -> tuple[str, str | None]:
     match = HASH_COMMENT_RE.match(line)
     if match:
         code = match.group("code").rstrip()
@@ -558,7 +554,7 @@ def _split_hash_comment(line: str) -> tuple[str, Union[str, None]]:
     return line.rstrip(), None
 
 
-def _split_slashes_comment(line: str) -> tuple[str, Union[str, None]]:
+def _split_slashes_comment(line: str) -> tuple[str, str | None]:
     match = SLASHES_COMMENT_RE.match(line)
     if match:
         code = match.group("code").rstrip()
@@ -604,8 +600,8 @@ def replace_multiline_code_block(
 
     code_block: list[str] = []
     for line_a, line_b in zip(block_a["content"], block_b["content"]):
-        line_a_comment: Union[str, None] = None
-        line_b_comment: Union[str, None] = None
+        line_a_comment: str | None = None
+        line_b_comment: str | None = None
 
         # Handle comments based on language
         if block_language in {
@@ -644,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`.
@@ -670,7 +666,7 @@ def replace_multiline_code_blocks_in_text(
 
 
 # All checks
-# --------------------------------------------------------------------------------------
+# -----------------------------------------------------------------------------------------
 
 
 def check_translation(

scripts/docs.py

@@ -239,7 +239,7 @@ def generate_readme() -> None:
     Generate README.md content from main index.md
     """
     readme_path = Path("README.md")
-    old_content = readme_path.read_text("utf-8")
+    old_content = readme_path.read_text()
     new_content = generate_readme_content()
     if new_content != old_content:
         print("README.md outdated from the latest index.md")

scripts/notify_translations.py

@@ -316,7 +316,7 @@ def main() -> None:
         raise RuntimeError(
             f"No github event file available at: {settings.github_event_path}"
         )
-    contents = settings.github_event_path.read_text("utf-8")
+    contents = settings.github_event_path.read_text()
     github_event = PartialGitHubEvent.model_validate_json(contents)
     logging.info(f"Using GitHub event: {github_event}")
     number = (

scripts/test.sh

@@ -4,4 +4,4 @@ set -e
 set -x
 
 export PYTHONPATH=./docs_src
-coverage run -m pytest tests scripts/tests/ ${@}
+coverage run -m pytest tests ${@}

scripts/tests/test_translation_fixer/conftest.py

@@ -1,19 +1,9 @@
 import shutil
-import sys
 from pathlib import Path
 
 import pytest
 from typer.testing import CliRunner
 
-skip_on_windows = pytest.mark.skipif(
-    sys.platform == "win32", reason="Skipping on Windows"
-)
-
-
-def pytest_collection_modifyitems(items: list[pytest.Item]) -> None:
-    for item in items:
-        item.add_marker(skip_on_windows)
-
 
 @pytest.fixture(name="runner")
 def get_runner():

scripts/tests/test_translation_fixer/test_code_blocks/test_code_blocks_lines_number_mismatch.py

@@ -22,10 +22,10 @@ def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_lines_number_gt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(
+        f"{data_path}/translated_doc_lines_number_gt.md"
+    ).read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output
@@ -46,10 +46,10 @@ def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     # assert result.exit_code == 1, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_lines_number_lt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(
+        f"{data_path}/translated_doc_lines_number_lt.md"
+    ).read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output

scripts/tests/test_translation_fixer/test_code_blocks/test_code_blocks_mermaid.py

@@ -22,10 +22,10 @@ def test_translated(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 0, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
     expected_content = Path(
         f"{data_path}/translated_doc_mermaid_translated.md"
-    ).read_text("utf-8")
+    ).read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert (
@@ -50,10 +50,10 @@ def test_not_translated(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 0, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
     expected_content = Path(
         f"{data_path}/translated_doc_mermaid_not_translated.md"
-    ).read_text("utf-8")
+    ).read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert ("Skipping mermaid code block replacement") not in result.output

scripts/tests/test_translation_fixer/test_code_blocks/test_code_blocks_number_mismatch.py

@@ -22,10 +22,8 @@ def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_number_gt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(f"{data_path}/translated_doc_number_gt.md").read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output
@@ -47,10 +45,8 @@ def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     # assert result.exit_code == 1, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_number_lt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(f"{data_path}/translated_doc_number_lt.md").read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output

scripts/tests/test_translation_fixer/test_code_blocks/test_code_blocks_wrong_lang_code.py

@@ -22,10 +22,10 @@ def test_wrong_lang_code_1(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_wrong_lang_code.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(
+        f"{data_path}/translated_doc_wrong_lang_code.md"
+    ).read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output
@@ -46,10 +46,10 @@ def test_wrong_lang_code_2(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
     expected_content = Path(
         f"{data_path}/translated_doc_wrong_lang_code_2.md"
-    ).read_text("utf-8")
+    ).read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output

scripts/tests/test_translation_fixer/test_code_includes/test_number_mismatch.py

@@ -22,10 +22,8 @@ def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_number_gt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(f"{data_path}/translated_doc_number_gt.md").read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output
@@ -47,10 +45,8 @@ def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_number_lt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(f"{data_path}/translated_doc_number_lt.md").read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output

scripts/tests/test_translation_fixer/test_complex_doc/test_compex_doc.py

@@ -22,8 +22,8 @@ def test_fix(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 0, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = (data_path / "translated_doc_expected.md").read_text("utf-8")
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = (data_path / "translated_doc_expected.md").read_text()
     assert fixed_content == expected_content
 
     assert "Fixing multiline code blocks in" in result.output

scripts/tests/test_translation_fixer/test_header_permalinks/test_header_level_mismatch.py

@@ -22,10 +22,10 @@ def test_level_mismatch_1(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
     expected_content = Path(
         f"{data_path}/translated_doc_level_mismatch_1.md"
-    ).read_text("utf-8")
+    ).read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output
@@ -47,10 +47,10 @@ def test_level_mismatch_2(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
     expected_content = Path(
         f"{data_path}/translated_doc_level_mismatch_2.md"
-    ).read_text("utf-8")
+    ).read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output

scripts/tests/test_translation_fixer/test_header_permalinks/test_header_number_mismatch.py

@@ -22,10 +22,8 @@ def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_number_gt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(f"{data_path}/translated_doc_number_gt.md").read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output
@@ -47,10 +45,8 @@ def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_number_lt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(f"{data_path}/translated_doc_number_lt.md").read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output

scripts/tests/test_translation_fixer/test_html_links/test_html_links_number_mismatch.py

@@ -20,10 +20,8 @@ def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_number_gt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(f"{data_path}/translated_doc_number_gt.md").read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output
@@ -45,10 +43,8 @@ def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     # assert result.exit_code == 1, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_number_lt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(f"{data_path}/translated_doc_number_lt.md").read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output

scripts/tests/test_translation_fixer/test_markdown_links/test_mkd_links_number_mismatch.py

@@ -22,10 +22,8 @@ def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     assert result.exit_code == 1, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_number_gt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(f"{data_path}/translated_doc_number_gt.md").read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output
@@ -47,10 +45,8 @@ def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
     )
     # assert result.exit_code == 1, result.output
 
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text("utf-8")
-    expected_content = Path(f"{data_path}/translated_doc_number_lt.md").read_text(
-        "utf-8"
-    )
+    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
+    expected_content = Path(f"{data_path}/translated_doc_number_lt.md").read_text()
 
     assert fixed_content == expected_content  # Translated doc remains unchanged
     assert "Error processing docs/lang/docs/doc.md" in result.output

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
@@ -25,7 +26,7 @@ non_translated_sections = (
     "contributing.md",
 )
 
-general_prompt_path = Path(__file__).absolute().parent / "general-llm-prompt.md"
+general_prompt_path = Path(__file__).absolute().parent / "llm-general-prompt.md"
 general_prompt = general_prompt_path.read_text(encoding="utf-8")
 
 app = typer.Typer()
@@ -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")
 
@@ -360,9 +379,6 @@ def make_pr(
     command: Annotated[str | None, typer.Option(envvar="COMMAND")] = None,
     github_token: Annotated[str, typer.Option(envvar="GITHUB_TOKEN")],
     github_repository: Annotated[str, typer.Option(envvar="GITHUB_REPOSITORY")],
-    commit_in_place: Annotated[
-        bool, typer.Option(envvar="COMMIT_IN_PLACE", show_default=True)
-    ] = False,
 ) -> None:
     print("Setting up GitHub Actions git user")
     repo = git.Repo(Path(__file__).absolute().parent.parent)
@@ -374,22 +390,14 @@ def make_pr(
         ["git", "config", "user.email", "github-actions[bot]@users.noreply.github.com"],
         check=True,
     )
-    current_branch = repo.active_branch.name
-    if current_branch == "master" and commit_in_place:
-        print("Can't commit directly to master")
-        raise typer.Exit(code=1)
-
-    if not commit_in_place:
-        branch_name = "translate"
-        if language:
-            branch_name += f"-{language}"
-        if command:
-            branch_name += f"-{command}"
-        branch_name += f"-{secrets.token_hex(4)}"
-        print(f"Creating a new branch {branch_name}")
-        subprocess.run(["git", "checkout", "-b", branch_name], check=True)
-    else:
-        print(f"Committing in place on branch {current_branch}")
+    branch_name = "translate"
+    if language:
+        branch_name += f"-{language}"
+    if command:
+        branch_name += f"-{command}"
+    branch_name += f"-{secrets.token_hex(4)}"
+    print(f"Creating a new branch {branch_name}")
+    subprocess.run(["git", "checkout", "-b", branch_name], check=True)
     print("Adding updated files")
     git_path = Path("docs")
     subprocess.run(["git", "add", str(git_path)], check=True)
@@ -402,20 +410,17 @@ def make_pr(
     subprocess.run(["git", "commit", "-m", message], check=True)
     print("Pushing branch")
     subprocess.run(["git", "push", "origin", branch_name], check=True)
-    if not commit_in_place:
-        print("Creating PR")
-        g = Github(github_token)
-        gh_repo = g.get_repo(github_repository)
-        body = (
-            message
-            + "\n\nThis PR was created automatically using LLMs."
-            + f"\n\nIt uses the prompt file https://github.com/fastapi/fastapi/blob/master/docs/{language}/llm-prompt.md."
-            + "\n\nIn most cases, it's better to make PRs updating that file so that the LLM can do a better job generating the translations than suggesting changes in this PR."
-        )
-        pr = gh_repo.create_pull(
-            title=message, body=body, base="master", head=branch_name
-        )
-        print(f"Created PR: {pr.number}")
+    print("Creating PR")
+    g = Github(github_token)
+    gh_repo = g.get_repo(github_repository)
+    body = (
+        message
+        + "\n\nThis PR was created automatically using LLMs."
+        + f"\n\nIt uses the prompt file https://github.com/fastapi/fastapi/blob/master/docs/{language}/llm-prompt.md."
+        + "\n\nIn most cases, it's better to make PRs updating that file so that the LLM can do a better job generating the translations than suggesting changes in this PR."
+    )
+    pr = gh_repo.create_pull(title=message, body=body, base="master", head=branch_name)
+    print(f"Created PR: {pr.number}")
     print("Finished")