👥 Update FastAPI GitHub topic repositories

.github/dependabot.yml

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

.github/workflows/build-docs.yml

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

.github/workflows/contributors.yml

@@ -10,9 +10,6 @@ on:
         required: false
         default: "false"
 
-env:
-  UV_SYSTEM_PYTHON: 1
-
 jobs:
   job:
     if: github.repository_owner == 'fastapi'
@@ -28,17 +25,16 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.11"
+          python-version-file: ".python-version"
       - 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 pip install -r requirements-github-actions.txt
+        run: uv sync --locked --no-dev --group github-actions
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
@@ -48,6 +44,6 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.FASTAPI_PR_TOKEN }}
       - name: FastAPI People Contributors
-        run: python ./scripts/contributors.py
+        run: uv run ./scripts/contributors.py
         env:
           GITHUB_TOKEN: ${{ secrets.FASTAPI_PR_TOKEN }}

.github/workflows/deploy-docs.yml

@@ -12,9 +12,6 @@ permissions:
   pull-requests: write
   statuses: write
 
-env:
-  UV_SYSTEM_PYTHON: 1
-
 jobs:
   deploy-docs:
     runs-on: ubuntu-latest
@@ -27,19 +24,18 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.11"
+          python-version-file: ".python-version"
       - 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 pip install -r requirements-github-actions.txt
+        run: uv sync --locked --no-dev --group github-actions
       - name: Deploy Docs Status Pending
-        run: python ./scripts/deploy_docs_status.py
+        run: uv run ./scripts/deploy_docs_status.py
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           COMMIT_SHA: ${{ github.event.workflow_run.head_sha }}
@@ -70,14 +66,14 @@ jobs:
           command: pages deploy ./site --project-name=${{ env.PROJECT_NAME }} --branch=${{ env.BRANCH }}
       - name: Deploy Docs Status Error
         if: failure()
-        run: python ./scripts/deploy_docs_status.py
+        run: uv run ./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: python ./scripts/deploy_docs_status.py
+        run: uv run ./scripts/deploy_docs_status.py
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           DEPLOY_URL: ${{ steps.deploy.outputs.deployment-url }}

.github/workflows/label-approved.yml

@@ -8,9 +8,6 @@ on:
 permissions:
   pull-requests: write
 
-env:
-  UV_SYSTEM_PYTHON: 1
-
 jobs:
   label-approved:
     if: github.repository_owner == 'fastapi'
@@ -24,19 +21,18 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v6
       with:
-        python-version: "3.11"
+        python-version-file: ".python-version"
     - 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 pip install -r requirements-github-actions.txt
+      run: uv sync --locked --no-dev --group github-actions
     - name: Label Approved
-      run: python ./scripts/label_approved.py
+      run: uv run ./scripts/label_approved.py
       env:
         TOKEN: ${{ secrets.GITHUB_TOKEN }}
         CONFIG: >

.github/workflows/notify-translations.yml

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

.github/workflows/people.yml

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

.github/workflows/pre-commit.yml

@@ -40,18 +40,15 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.14"
+          python-version-file: ".python-version"
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
           cache-dependency-glob: |
-            requirements**.txt
             pyproject.toml
             uv.lock
       - name: Install Dependencies
-        run: |
-          uv venv
-          uv pip install -r requirements.txt
+        run: uv sync --locked --extra all
       - 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,6 +15,7 @@ jobs:
           - fastapi-slim
     permissions:
       id-token: write
+      contents: read
     steps:
       - name: Dump GitHub context
         env:
@@ -24,19 +25,15 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.10"
+          python-version-file: ".python-version"
           # Issue ref: https://github.com/actions/setup-python/issues/436
           # cache: "pip"
           # cache-dependency-path: pyproject.toml
-      - name: Install build dependencies
-        run: pip install build
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
       - name: Build distribution
+        run: uv build
         env:
           TIANGOLO_BUILD_PACKAGE: ${{ matrix.package }}
-        run: python -m build
       - name: Publish
-        uses: pypa/gh-action-pypi-publish@v1.13.0
-      - name: Dump GitHub context
-        env:
-          GITHUB_CONTEXT: ${{ toJson(github) }}
-        run: echo "$GITHUB_CONTEXT"
+        run: uv publish

.github/workflows/smokeshow.yml

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

.github/workflows/sponsors.yml

@@ -10,9 +10,6 @@ on:
         required: false
         default: "false"
 
-env:
-  UV_SYSTEM_PYTHON: 1
-
 jobs:
   job:
     if: github.repository_owner == 'fastapi'
@@ -28,17 +25,16 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.11"
+          python-version-file: ".python-version"
       - 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 pip install -r requirements-github-actions.txt
+        run: uv sync --locked --no-dev --group github-actions
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
@@ -46,7 +42,7 @@ jobs:
         with:
           limit-access-to-actor: true
       - name: FastAPI People Sponsors
-        run: python ./scripts/sponsors.py
+        run: uv run ./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: "3.10"
+          python-version-file: ".python-version"
       - 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 -r requirements-tests.txt
+          pip install --group tests --editable .[all]
         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_SYSTEM_PYTHON: 1
+  UV_NO_SYNC: true
 
 jobs:
   test:
@@ -44,6 +44,8 @@ jobs:
             coverage: coverage
       fail-fast: false
     runs-on: ${{ matrix.os }}
+    env:
+      UV_PYTHON: ${{ matrix.python-version }}
     steps:
       - name: Dump GitHub context
         env:
@@ -57,17 +59,16 @@ 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 pip install -r requirements-tests.txt
+        run: uv sync --locked --no-dev --group tests --extra all
       - run: mkdir coverage
       - name: Test
         if: matrix.codspeed != 'codspeed'
-        run: bash scripts/test.sh
+        run: uv run bash scripts/test.sh
         env:
           COVERAGE_FILE: coverage/.coverage.${{ runner.os }}-py${{ matrix.python-version }}
           CONTEXT: ${{ runner.os }}-py${{ matrix.python-version }}
@@ -79,7 +80,7 @@ jobs:
             CONTEXT: ${{ runner.os }}-py${{ matrix.python-version }}
         with:
           mode: simulation
-          run: coverage run -m pytest tests/ --codspeed
+          run: uv 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'
@@ -100,17 +101,16 @@ jobs:
       - uses: actions/checkout@v6
       - uses: actions/setup-python@v6
         with:
-          python-version: '3.11'
+          python-version-file: ".python-version"
       - 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 pip install -r requirements-tests.txt
+        run: uv sync --locked --no-dev --group tests --extra all
       - 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: coverage combine coverage
-      - run: coverage html --title "Coverage for ${{ github.sha }}"
+      - run: uv run coverage combine coverage
+      - run: uv 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: coverage report --fail-under=100
+      - run: uv 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,9 +5,6 @@ on:
     - cron: "0 12 1 * *"
   workflow_dispatch:
 
-env:
-  UV_SYSTEM_PYTHON: 1
-
 jobs:
   topic-repos:
     if: github.repository_owner == 'fastapi'
@@ -23,18 +20,17 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.11"
+          python-version-file: ".python-version"
       - 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 pip install -r requirements-github-actions.txt
+        run: uv sync --locked --no-dev --group github-actions
       - name: Update Topic Repos
-        run: python ./scripts/topic_repos.py
+        run: uv run ./scripts/topic_repos.py
         env:
           GITHUB_TOKEN: ${{ secrets.FASTAPI_PR_TOKEN }}

.github/workflows/translate.yml

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

.gitignore

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

.pre-commit-config.yaml

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

.python-version

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

docs/en/data/topic_repos.yml

@@ -1,171 +1,171 @@
 - name: full-stack-fastapi-template
   html_url: https://github.com/fastapi/full-stack-fastapi-template
-  stars: 40334
+  stars: 40534
   owner_login: fastapi
   owner_html_url: https://github.com/fastapi
 - name: Hello-Python
   html_url: https://github.com/mouredev/Hello-Python
-  stars: 33628
+  stars: 33839
   owner_login: mouredev
   owner_html_url: https://github.com/mouredev
 - name: serve
   html_url: https://github.com/jina-ai/serve
-  stars: 21817
+  stars: 21819
   owner_login: jina-ai
   owner_html_url: https://github.com/jina-ai
 - name: HivisionIDPhotos
   html_url: https://github.com/Zeyi-Lin/HivisionIDPhotos
-  stars: 20409
+  stars: 20457
   owner_login: Zeyi-Lin
   owner_html_url: https://github.com/Zeyi-Lin
 - name: sqlmodel
   html_url: https://github.com/fastapi/sqlmodel
-  stars: 17415
+  stars: 17458
   owner_login: fastapi
   owner_html_url: https://github.com/fastapi
 - name: fastapi-best-practices
   html_url: https://github.com/zhanymkanov/fastapi-best-practices
-  stars: 15776
+  stars: 15923
   owner_login: zhanymkanov
   owner_html_url: https://github.com/zhanymkanov
 - name: Douyin_TikTok_Download_API
   html_url: https://github.com/Evil0ctal/Douyin_TikTok_Download_API
-  stars: 15588
+  stars: 15763
   owner_login: Evil0ctal
   owner_html_url: https://github.com/Evil0ctal
 - name: machine-learning-zoomcamp
   html_url: https://github.com/DataTalksClub/machine-learning-zoomcamp
-  stars: 12447
+  stars: 12477
   owner_login: DataTalksClub
   owner_html_url: https://github.com/DataTalksClub
 - name: SurfSense
   html_url: https://github.com/MODSetter/SurfSense
-  stars: 12128
+  stars: 12299
   owner_login: MODSetter
   owner_html_url: https://github.com/MODSetter
 - name: fastapi_mcp
   html_url: https://github.com/tadata-org/fastapi_mcp
-  stars: 11326
+  stars: 11351
   owner_login: tadata-org
   owner_html_url: https://github.com/tadata-org
 - name: awesome-fastapi
   html_url: https://github.com/mjhea0/awesome-fastapi
-  stars: 10901
+  stars: 10932
   owner_login: mjhea0
   owner_html_url: https://github.com/mjhea0
 - name: XHS-Downloader
   html_url: https://github.com/JoeanAmier/XHS-Downloader
-  stars: 9584
+  stars: 9696
   owner_login: JoeanAmier
   owner_html_url: https://github.com/JoeanAmier
 - name: polar
   html_url: https://github.com/polarsource/polar
-  stars: 8951
+  stars: 9000
   owner_login: polarsource
   owner_html_url: https://github.com/polarsource
 - name: FastUI
   html_url: https://github.com/pydantic/FastUI
-  stars: 8934
+  stars: 8938
   owner_login: pydantic
   owner_html_url: https://github.com/pydantic
 - name: FileCodeBox
   html_url: https://github.com/vastsa/FileCodeBox
-  stars: 7934
+  stars: 7979
   owner_login: vastsa
   owner_html_url: https://github.com/vastsa
 - name: nonebot2
   html_url: https://github.com/nonebot/nonebot2
-  stars: 7248
+  stars: 7270
   owner_login: nonebot
   owner_html_url: https://github.com/nonebot
 - name: hatchet
   html_url: https://github.com/hatchet-dev/hatchet
-  stars: 6392
+  stars: 6422
   owner_login: hatchet-dev
   owner_html_url: https://github.com/hatchet-dev
 - name: fastapi-users
   html_url: https://github.com/fastapi-users/fastapi-users
-  stars: 5899
+  stars: 5915
   owner_login: fastapi-users
   owner_html_url: https://github.com/fastapi-users
 - name: serge
   html_url: https://github.com/serge-chat/serge
-  stars: 5754
+  stars: 5751
   owner_login: serge-chat
   owner_html_url: https://github.com/serge-chat
 - name: strawberry
   html_url: https://github.com/strawberry-graphql/strawberry
-  stars: 4577
+  stars: 4580
   owner_login: strawberry-graphql
   owner_html_url: https://github.com/strawberry-graphql
 - name: poem
   html_url: https://github.com/poem-web/poem
-  stars: 4303
+  stars: 4312
   owner_login: poem-web
   owner_html_url: https://github.com/poem-web
 - name: chatgpt-web-share
   html_url: https://github.com/chatpire/chatgpt-web-share
-  stars: 4287
+  stars: 4284
   owner_login: chatpire
   owner_html_url: https://github.com/chatpire
-- name: dynaconf
-  html_url: https://github.com/dynaconf/dynaconf
-  stars: 4221
-  owner_login: dynaconf
-  owner_html_url: https://github.com/dynaconf
 - name: Kokoro-FastAPI
   html_url: https://github.com/remsky/Kokoro-FastAPI
-  stars: 4181
+  stars: 4241
   owner_login: remsky
   owner_html_url: https://github.com/remsky
-- name: atrilabs-engine
-  html_url: https://github.com/Atri-Labs/atrilabs-engine
-  stars: 4090
-  owner_login: Atri-Labs
-  owner_html_url: https://github.com/Atri-Labs
+- name: dynaconf
+  html_url: https://github.com/dynaconf/dynaconf
+  stars: 4227
+  owner_login: dynaconf
+  owner_html_url: https://github.com/dynaconf
 - name: devpush
   html_url: https://github.com/hunvreus/devpush
-  stars: 4037
+  stars: 4173
   owner_login: hunvreus
   owner_html_url: https://github.com/hunvreus
+- name: atrilabs-engine
+  html_url: https://github.com/Atri-Labs/atrilabs-engine
+  stars: 4091
+  owner_login: Atri-Labs
+  owner_html_url: https://github.com/Atri-Labs
 - name: logfire
   html_url: https://github.com/pydantic/logfire
-  stars: 3896
+  stars: 3917
   owner_login: pydantic
   owner_html_url: https://github.com/pydantic
+- name: Yuxi-Know
+  html_url: https://github.com/xerrors/Yuxi-Know
+  stars: 3825
+  owner_login: xerrors
+  owner_html_url: https://github.com/xerrors
 - name: LitServe
   html_url: https://github.com/Lightning-AI/LitServe
-  stars: 3756
+  stars: 3767
   owner_login: Lightning-AI
   owner_html_url: https://github.com/Lightning-AI
 - name: huma
   html_url: https://github.com/danielgtaylor/huma
-  stars: 3702
+  stars: 3721
   owner_login: danielgtaylor
   owner_html_url: https://github.com/danielgtaylor
-- name: Yuxi-Know
-  html_url: https://github.com/xerrors/Yuxi-Know
-  stars: 3680
-  owner_login: xerrors
-  owner_html_url: https://github.com/xerrors
 - name: datamodel-code-generator
   html_url: https://github.com/koxudaxi/datamodel-code-generator
-  stars: 3675
+  stars: 3693
   owner_login: koxudaxi
   owner_html_url: https://github.com/koxudaxi
 - name: fastapi-admin
   html_url: https://github.com/fastapi-admin/fastapi-admin
-  stars: 3659
+  stars: 3667
   owner_login: fastapi-admin
   owner_html_url: https://github.com/fastapi-admin
 - name: farfalle
   html_url: https://github.com/rashadphz/farfalle
-  stars: 3497
+  stars: 3495
   owner_login: rashadphz
   owner_html_url: https://github.com/rashadphz
 - name: tracecat
   html_url: https://github.com/TracecatHQ/tracecat
-  stars: 3421
+  stars: 3425
   owner_login: TracecatHQ
   owner_html_url: https://github.com/TracecatHQ
 - name: opyrator
@@ -175,19 +175,19 @@
   owner_html_url: https://github.com/ml-tooling
 - name: docarray
   html_url: https://github.com/docarray/docarray
-  stars: 3111
+  stars: 3112
   owner_login: docarray
   owner_html_url: https://github.com/docarray
-- name: fastapi-realworld-example-app
-  html_url: https://github.com/nsidnev/fastapi-realworld-example-app
-  stars: 3051
-  owner_login: nsidnev
-  owner_html_url: https://github.com/nsidnev
 - name: mcp-context-forge
   html_url: https://github.com/IBM/mcp-context-forge
-  stars: 3034
+  stars: 3073
   owner_login: IBM
   owner_html_url: https://github.com/IBM
+- name: fastapi-realworld-example-app
+  html_url: https://github.com/nsidnev/fastapi-realworld-example-app
+  stars: 3057
+  owner_login: nsidnev
+  owner_html_url: https://github.com/nsidnev
 - name: uvicorn-gunicorn-fastapi-docker
   html_url: https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker
   stars: 2904
@@ -195,27 +195,27 @@
   owner_html_url: https://github.com/tiangolo
 - name: FastAPI-template
   html_url: https://github.com/s3rius/FastAPI-template
-  stars: 2680
+  stars: 2691
   owner_login: s3rius
   owner_html_url: https://github.com/s3rius
 - name: best-of-web-python
   html_url: https://github.com/ml-tooling/best-of-web-python
-  stars: 2662
+  stars: 2666
   owner_login: ml-tooling
   owner_html_url: https://github.com/ml-tooling
 - name: YC-Killer
   html_url: https://github.com/sahibzada-allahyar/YC-Killer
-  stars: 2614
+  stars: 2612
   owner_login: sahibzada-allahyar
   owner_html_url: https://github.com/sahibzada-allahyar
 - name: sqladmin
   html_url: https://github.com/aminalaee/sqladmin
-  stars: 2587
+  stars: 2600
   owner_login: aminalaee
   owner_html_url: https://github.com/aminalaee
 - name: fastapi-react
   html_url: https://github.com/Buuntu/fastapi-react
-  stars: 2566
+  stars: 2567
   owner_login: Buuntu
   owner_html_url: https://github.com/Buuntu
 - name: RasaGPT
@@ -225,49 +225,49 @@
   owner_html_url: https://github.com/paulpierre
 - name: supabase-py
   html_url: https://github.com/supabase/supabase-py
-  stars: 2394
+  stars: 2406
   owner_login: supabase
   owner_html_url: https://github.com/supabase
 - name: nextpy
   html_url: https://github.com/dot-agent/nextpy
-  stars: 2338
+  stars: 2337
   owner_login: dot-agent
   owner_html_url: https://github.com/dot-agent
 - name: fastapi-utils
   html_url: https://github.com/fastapiutils/fastapi-utils
-  stars: 2289
+  stars: 2290
   owner_login: fastapiutils
   owner_html_url: https://github.com/fastapiutils
 - name: langserve
   html_url: https://github.com/langchain-ai/langserve
-  stars: 2234
+  stars: 2240
   owner_login: langchain-ai
   owner_html_url: https://github.com/langchain-ai
 - name: 30-Days-of-Python
   html_url: https://github.com/codingforentrepreneurs/30-Days-of-Python
-  stars: 2232
+  stars: 2234
   owner_login: codingforentrepreneurs
   owner_html_url: https://github.com/codingforentrepreneurs
 - name: solara
   html_url: https://github.com/widgetti/solara
-  stars: 2141
+  stars: 2144
   owner_login: widgetti
   owner_html_url: https://github.com/widgetti
 - name: mangum
   html_url: https://github.com/Kludex/mangum
-  stars: 2046
+  stars: 2051
   owner_login: Kludex
   owner_html_url: https://github.com/Kludex
-- name: fastapi_best_architecture
-  html_url: https://github.com/fastapi-practices/fastapi_best_architecture
-  stars: 1963
-  owner_login: fastapi-practices
-  owner_html_url: https://github.com/fastapi-practices
 - name: NoteDiscovery
   html_url: https://github.com/gamosoft/NoteDiscovery
-  stars: 1943
+  stars: 2038
   owner_login: gamosoft
   owner_html_url: https://github.com/gamosoft
+- name: fastapi_best_architecture
+  html_url: https://github.com/fastapi-practices/fastapi_best_architecture
+  stars: 1985
+  owner_login: fastapi-practices
+  owner_html_url: https://github.com/fastapi-practices
 - name: agentkit
   html_url: https://github.com/BCG-X-Official/agentkit
   stars: 1936
@@ -275,27 +275,27 @@
   owner_html_url: https://github.com/BCG-X-Official
 - name: vue-fastapi-admin
   html_url: https://github.com/mizhexiaoxiao/vue-fastapi-admin
-  stars: 1909
+  stars: 1930
   owner_login: mizhexiaoxiao
   owner_html_url: https://github.com/mizhexiaoxiao
 - name: manage-fastapi
   html_url: https://github.com/ycd/manage-fastapi
-  stars: 1887
+  stars: 1893
   owner_login: ycd
   owner_html_url: https://github.com/ycd
 - name: openapi-python-client
   html_url: https://github.com/openapi-generators/openapi-python-client
-  stars: 1879
+  stars: 1885
   owner_login: openapi-generators
   owner_html_url: https://github.com/openapi-generators
 - name: slowapi
   html_url: https://github.com/laurentS/slowapi
-  stars: 1845
+  stars: 1859
   owner_login: laurentS
   owner_html_url: https://github.com/laurentS
 - name: piccolo
   html_url: https://github.com/piccolo-orm/piccolo
-  stars: 1843
+  stars: 1848
   owner_login: piccolo-orm
   owner_html_url: https://github.com/piccolo-orm
 - name: python-week-2022
@@ -305,47 +305,47 @@
   owner_html_url: https://github.com/rochacbruno
 - name: fastapi-cache
   html_url: https://github.com/long2ice/fastapi-cache
-  stars: 1805
+  stars: 1808
   owner_login: long2ice
   owner_html_url: https://github.com/long2ice
-- name: ormar
-  html_url: https://github.com/collerek/ormar
-  stars: 1785
-  owner_login: collerek
-  owner_html_url: https://github.com/collerek
 - name: fastapi-langgraph-agent-production-ready-template
   html_url: https://github.com/wassim249/fastapi-langgraph-agent-production-ready-template
-  stars: 1780
+  stars: 1808
   owner_login: wassim249
   owner_html_url: https://github.com/wassim249
+- name: ormar
+  html_url: https://github.com/collerek/ormar
+  stars: 1787
+  owner_login: collerek
+  owner_html_url: https://github.com/collerek
 - name: FastAPI-boilerplate
   html_url: https://github.com/benavlabs/FastAPI-boilerplate
-  stars: 1734
+  stars: 1755
   owner_login: benavlabs
   owner_html_url: https://github.com/benavlabs
 - name: termpair
   html_url: https://github.com/cs01/termpair
-  stars: 1724
+  stars: 1725
   owner_login: cs01
   owner_html_url: https://github.com/cs01
 - name: fastapi-crudrouter
   html_url: https://github.com/awtkns/fastapi-crudrouter
-  stars: 1671
+  stars: 1673
   owner_login: awtkns
   owner_html_url: https://github.com/awtkns
 - name: langchain-serve
   html_url: https://github.com/jina-ai/langchain-serve
-  stars: 1633
+  stars: 1631
   owner_login: jina-ai
   owner_html_url: https://github.com/jina-ai
 - name: fastapi-pagination
   html_url: https://github.com/uriyyo/fastapi-pagination
-  stars: 1588
+  stars: 1590
   owner_login: uriyyo
   owner_html_url: https://github.com/uriyyo
 - name: awesome-fastapi-projects
   html_url: https://github.com/Kludex/awesome-fastapi-projects
-  stars: 1583
+  stars: 1586
   owner_login: Kludex
   owner_html_url: https://github.com/Kludex
 - name: coronavirus-tracker-api
@@ -355,42 +355,42 @@
   owner_html_url: https://github.com/ExpDev07
 - name: bracket
   html_url: https://github.com/evroon/bracket
-  stars: 1549
+  stars: 1554
   owner_login: evroon
   owner_html_url: https://github.com/evroon
 - name: fastapi-amis-admin
   html_url: https://github.com/amisadmin/fastapi-amis-admin
-  stars: 1491
+  stars: 1499
   owner_login: amisadmin
   owner_html_url: https://github.com/amisadmin
-- name: fastapi-boilerplate
-  html_url: https://github.com/teamhide/fastapi-boilerplate
-  stars: 1452
-  owner_login: teamhide
-  owner_html_url: https://github.com/teamhide
 - name: fastcrud
   html_url: https://github.com/benavlabs/fastcrud
-  stars: 1452
+  stars: 1455
   owner_login: benavlabs
   owner_html_url: https://github.com/benavlabs
+- name: fastapi-boilerplate
+  html_url: https://github.com/teamhide/fastapi-boilerplate
+  stars: 1454
+  owner_login: teamhide
+  owner_html_url: https://github.com/teamhide
 - name: awesome-python-resources
   html_url: https://github.com/DjangoEx/awesome-python-resources
-  stars: 1430
+  stars: 1434
   owner_login: DjangoEx
   owner_html_url: https://github.com/DjangoEx
 - name: prometheus-fastapi-instrumentator
   html_url: https://github.com/trallnag/prometheus-fastapi-instrumentator
-  stars: 1399
+  stars: 1405
   owner_login: trallnag
   owner_html_url: https://github.com/trallnag
 - name: fastapi-code-generator
   html_url: https://github.com/koxudaxi/fastapi-code-generator
-  stars: 1371
+  stars: 1373
   owner_login: koxudaxi
   owner_html_url: https://github.com/koxudaxi
 - name: fastapi-tutorial
   html_url: https://github.com/liaogx/fastapi-tutorial
-  stars: 1346
+  stars: 1352
   owner_login: liaogx
   owner_html_url: https://github.com/liaogx
 - name: budgetml
@@ -400,92 +400,92 @@
   owner_html_url: https://github.com/ebhy
 - name: fastapi-scaff
   html_url: https://github.com/atpuxiner/fastapi-scaff
-  stars: 1331
+  stars: 1342
   owner_login: atpuxiner
   owner_html_url: https://github.com/atpuxiner
 - name: bolt-python
   html_url: https://github.com/slackapi/bolt-python
-  stars: 1266
+  stars: 1269
   owner_login: slackapi
   owner_html_url: https://github.com/slackapi
 - name: bedrock-chat
   html_url: https://github.com/aws-samples/bedrock-chat
-  stars: 1266
+  stars: 1265
   owner_login: aws-samples
   owner_html_url: https://github.com/aws-samples
 - name: fastapi-alembic-sqlmodel-async
   html_url: https://github.com/jonra1993/fastapi-alembic-sqlmodel-async
-  stars: 1260
+  stars: 1261
   owner_login: jonra1993
   owner_html_url: https://github.com/jonra1993
 - name: fastapi_production_template
   html_url: https://github.com/zhanymkanov/fastapi_production_template
-  stars: 1222
+  stars: 1220
   owner_login: zhanymkanov
   owner_html_url: https://github.com/zhanymkanov
 - name: langchain-extract
   html_url: https://github.com/langchain-ai/langchain-extract
-  stars: 1179
+  stars: 1178
   owner_login: langchain-ai
   owner_html_url: https://github.com/langchain-ai
 - name: restish
   html_url: https://github.com/rest-sh/restish
-  stars: 1152
+  stars: 1156
   owner_login: rest-sh
   owner_html_url: https://github.com/rest-sh
 - name: odmantic
   html_url: https://github.com/art049/odmantic
-  stars: 1143
+  stars: 1145
   owner_login: art049
   owner_html_url: https://github.com/art049
 - name: authx
   html_url: https://github.com/yezz123/authx
-  stars: 1128
+  stars: 1130
   owner_login: yezz123
   owner_html_url: https://github.com/yezz123
 - name: SAG
   html_url: https://github.com/Zleap-AI/SAG
-  stars: 1104
+  stars: 1108
   owner_login: Zleap-AI
   owner_html_url: https://github.com/Zleap-AI
-- name: aktools
-  html_url: https://github.com/akfamily/aktools
-  stars: 1072
-  owner_login: akfamily
-  owner_html_url: https://github.com/akfamily
 - name: RuoYi-Vue3-FastAPI
   html_url: https://github.com/insistence/RuoYi-Vue3-FastAPI
-  stars: 1063
+  stars: 1092
   owner_login: insistence
   owner_html_url: https://github.com/insistence
+- name: aktools
+  html_url: https://github.com/akfamily/aktools
+  stars: 1089
+  owner_login: akfamily
+  owner_html_url: https://github.com/akfamily
 - name: flock
   html_url: https://github.com/Onelevenvy/flock
-  stars: 1059
+  stars: 1060
   owner_login: Onelevenvy
   owner_html_url: https://github.com/Onelevenvy
 - name: fastapi-observability
   html_url: https://github.com/blueswen/fastapi-observability
-  stars: 1046
+  stars: 1050
   owner_login: blueswen
   owner_html_url: https://github.com/blueswen
 - name: enterprise-deep-research
   html_url: https://github.com/SalesforceAIResearch/enterprise-deep-research
-  stars: 1019
+  stars: 1028
   owner_login: SalesforceAIResearch
   owner_html_url: https://github.com/SalesforceAIResearch
 - name: titiler
   html_url: https://github.com/developmentseed/titiler
-  stars: 1016
+  stars: 1020
   owner_login: developmentseed
   owner_html_url: https://github.com/developmentseed
 - name: every-pdf
   html_url: https://github.com/DDULDDUCK/every-pdf
-  stars: 1004
+  stars: 1005
   owner_login: DDULDDUCK
   owner_html_url: https://github.com/DDULDDUCK
 - name: autollm
   html_url: https://github.com/viddexa/autollm
-  stars: 1003
+  stars: 1004
   owner_login: viddexa
   owner_html_url: https://github.com/viddexa
 - name: lanarky

docs/en/docs/contributing.md

@@ -6,44 +6,20 @@ 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
 
-After activating the environment, install the required packages:
-
-//// tab | `pip`
+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>:
 
 <div class="termy">
 
 ```console
-$ pip install -r requirements.txt
+$ uv sync
 
 ---> 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
@@ -56,9 +32,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 this included `requirements.txt` instead of running `pip install fastapi` directly.
+This only happens when you install using `uv sync` instead of running `pip install fastapi` directly.
 
-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.
+That is because `uv sync` will install the local version of FastAPI in "editable" mode by default.
 
 ///
 

pyproject.toml

@@ -123,6 +123,68 @@ 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
@@ -131,11 +193,10 @@ 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

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

requirements-docs.txt

@@ -1,21 +0,0 @@
--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

@@ -1,6 +0,0 @@
-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

@@ -1,18 +0,0 @@
--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

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

requirements.txt

@@ -1,7 +0,0 @@
--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,729 +0,0 @@
-import re
-from typing import TypedDict
-
-CODE_INCLUDE_RE = re.compile(r"^\{\*\s*(\S+)\s*(.*)\*\}$")
-CODE_INCLUDE_PLACEHOLDER = "<CODE_INCLUDE>"
-
-HEADER_WITH_PERMALINK_RE = re.compile(r"^(#{1,6}) (.+?)(\s*\{\s*#.*\s*\})?\s*$")
-HEADER_LINE_RE = re.compile(r"^(#{1,6}) (.+?)(?:\s*\{\s*(#.*)\s*\})?\s*$")
-
-TIANGOLO_COM = "https://fastapi.tiangolo.com"
-ASSETS_URL_PREFIXES = ("/img/", "/css/", "/js/")
-
-MARKDOWN_LINK_RE = re.compile(
-    r"(?<!\\)(?<!\!)"  # not an image ![...] and not escaped \[...]
-    r"\[(?P<text>.*?)\]"  # link text (non-greedy)
-    r"\("
-    r"(?P<url>[^)\s]+)"  # url (no spaces and `)`)
-    r'(?:\s+["\'](?P<title>.*?)["\'])?'  # optional title in "" or ''
-    r"\)"
-    r"(?:\s*\{(?P<attrs>[^}]*)\})?"  # optional attributes in {}
-)
-
-HTML_LINK_RE = re.compile(r"<a\s+[^>]*>.*?</a>")
-HTML_LINK_TEXT_RE = re.compile(r"<a\b([^>]*)>(.*?)</a>")
-HTML_LINK_OPEN_TAG_RE = re.compile(r"<a\b([^>]*)>")
-HTML_ATTR_RE = re.compile(r'(\w+)\s*=\s*([\'"])(.*?)\2')
-
-CODE_BLOCK_LANG_RE = re.compile(r"^`{3,4}([\w-]*)", re.MULTILINE)
-
-SLASHES_COMMENT_RE = re.compile(
-    r"^(?P<code>.*?)(?P<comment>(?:(?<= )// .*)|(?:^// .*))?$"
-)
-
-HASH_COMMENT_RE = re.compile(r"^(?P<code>.*?)(?P<comment>(?:(?<= )# .*)|(?:^# .*))?$")
-
-
-class CodeIncludeInfo(TypedDict):
-    line_no: int
-    line: str
-
-
-class HeaderPermalinkInfo(TypedDict):
-    line_no: int
-    hashes: str
-    title: str
-    permalink: str
-
-
-class MarkdownLinkInfo(TypedDict):
-    line_no: int
-    url: str
-    text: str
-    title: str | None
-    attributes: str | None
-    full_match: str
-
-
-class HTMLLinkAttribute(TypedDict):
-    name: str
-    quote: str
-    value: str
-
-
-class HtmlLinkInfo(TypedDict):
-    line_no: int
-    full_tag: str
-    attributes: list[HTMLLinkAttribute]
-    text: str
-
-
-class MultilineCodeBlockInfo(TypedDict):
-    lang: str
-    start_line_no: int
-    content: list[str]
-
-
-# Code includes
-# -----------------------------------------------------------------------------------------
-
-
-def extract_code_includes(lines: list[str]) -> list[CodeIncludeInfo]:
-    """
-    Exctract lines that contain code includes.
-
-    Return list of CodeIncludeInfo namedtuples, where each tuple contains:
-    - `line_no` - line number (1-based)
-    - `line` - text of the line
-    """
-
-    includes: list[CodeIncludeInfo] = []
-    for line_no, line in enumerate(lines, start=1):
-        if CODE_INCLUDE_RE.match(line):
-            includes.append(CodeIncludeInfo(line_no=line_no, line=line))
-    return includes
-
-
-def replace_code_includes_with_placeholders(text: list[str]) -> list[str]:
-    """
-    Replace code includes with placeholders.
-    """
-
-    modified_text = text.copy()
-    includes = extract_code_includes(text)
-    for include in includes:
-        modified_text[include["line_no"] - 1] = CODE_INCLUDE_PLACEHOLDER
-    return modified_text
-
-
-def replace_placeholders_with_code_includes(
-    text: list[str], original_includes: list[CodeIncludeInfo]
-) -> list[str]:
-    """
-    Replace code includes placeholders with actual code includes from the original (English) document.
-    Fail if the number of placeholders does not match the number of original includes.
-    """
-
-    code_include_lines = [
-        line_no
-        for line_no, line in enumerate(text)
-        if line.strip() == CODE_INCLUDE_PLACEHOLDER
-    ]
-
-    if len(code_include_lines) != len(original_includes):
-        raise ValueError(
-            "Number of code include placeholders does not match the number of code includes "
-            "in the original document "
-            f"({len(code_include_lines)} vs {len(original_includes)})"
-        )
-
-    modified_text = text.copy()
-    for i, line_no in enumerate(code_include_lines):
-        modified_text[line_no] = original_includes[i]["line"]
-
-    return modified_text
-
-
-# Header permalinks
-# -----------------------------------------------------------------------------------------
-
-
-def extract_header_permalinks(lines: list[str]) -> list[HeaderPermalinkInfo]:
-    """
-    Extract list of header permalinks from the given lines.
-
-    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}")
-    """
-
-    headers: list[HeaderPermalinkInfo] = []
-    in_code_block3 = False
-    in_code_block4 = False
-
-    for line_no, line in enumerate(lines, start=1):
-        if not (in_code_block3 or in_code_block4):
-            if line.startswith("```"):
-                count = len(line) - len(line.lstrip("`"))
-                if count == 3:
-                    in_code_block3 = True
-                    continue
-                elif count >= 4:
-                    in_code_block4 = True
-                    continue
-
-            header_match = HEADER_WITH_PERMALINK_RE.match(line)
-            if header_match:
-                hashes, title, permalink = header_match.groups()
-                headers.append(
-                    HeaderPermalinkInfo(
-                        hashes=hashes, line_no=line_no, permalink=permalink, title=title
-                    )
-                )
-
-        elif in_code_block3:
-            if line.startswith("```"):
-                count = len(line) - len(line.lstrip("`"))
-                if count == 3:
-                    in_code_block3 = False
-                    continue
-
-        elif in_code_block4:
-            if line.startswith("````"):
-                count = len(line) - len(line.lstrip("`"))
-                if count >= 4:
-                    in_code_block4 = False
-                    continue
-
-    return headers
-
-
-def remove_header_permalinks(lines: list[str]) -> list[str]:
-    """
-    Remove permalinks from headers in the given lines.
-    """
-
-    modified_lines: list[str] = []
-    for line in lines:
-        header_match = HEADER_WITH_PERMALINK_RE.match(line)
-        if header_match:
-            hashes, title, _permalink = header_match.groups()
-            modified_line = f"{hashes} {title}"
-            modified_lines.append(modified_line)
-        else:
-            modified_lines.append(line)
-    return modified_lines
-
-
-def replace_header_permalinks(
-    text: list[str],
-    header_permalinks: list[HeaderPermalinkInfo],
-    original_header_permalinks: list[HeaderPermalinkInfo],
-) -> list[str]:
-    """
-    Replace permalinks in the given text with the permalinks from the original document.
-
-    Fail if the number or level of headers does not match the original.
-    """
-
-    modified_text: list[str] = text.copy()
-
-    if len(header_permalinks) != len(original_header_permalinks):
-        raise ValueError(
-            "Number of headers with permalinks does not match the number in the "
-            "original document "
-            f"({len(header_permalinks)} vs {len(original_header_permalinks)})"
-        )
-
-    for header_no in range(len(header_permalinks)):
-        header_info = header_permalinks[header_no]
-        original_header_info = original_header_permalinks[header_no]
-
-        if header_info["hashes"] != original_header_info["hashes"]:
-            raise ValueError(
-                "Header levels do not match between document and original document"
-                f" (found {header_info['hashes']}, expected {original_header_info['hashes']})"
-                f" for header №{header_no + 1} in line {header_info['line_no']}"
-            )
-        line_no = header_info["line_no"] - 1
-        hashes = header_info["hashes"]
-        title = header_info["title"]
-        permalink = original_header_info["permalink"]
-        modified_text[line_no] = f"{hashes} {title}{permalink}"
-
-    return modified_text
-
-
-# Markdown links
-# -----------------------------------------------------------------------------------------
-
-
-def extract_markdown_links(lines: list[str]) -> list[tuple[str, int]]:
-    """
-    Extract all markdown links from the given lines.
-
-    Return list of MarkdownLinkInfo namedtuples, where each tuple contains:
-    - `line_no` - line number (1-based)
-    - `url` - link URL
-    - `text` - link text
-    - `title` - link title (if any)
-    """
-
-    links: list[MarkdownLinkInfo] = []
-    for line_no, line in enumerate(lines, start=1):
-        for m in MARKDOWN_LINK_RE.finditer(line):
-            links.append(
-                MarkdownLinkInfo(
-                    line_no=line_no,
-                    url=m.group("url"),
-                    text=m.group("text"),
-                    title=m.group("title"),
-                    attributes=m.group("attrs"),
-                    full_match=m.group(0),
-                )
-            )
-    return links
-
-
-def _add_lang_code_to_url(url: str, lang_code: str) -> str:
-    if url.startswith(TIANGOLO_COM):
-        rel_url = url[len(TIANGOLO_COM) :]
-        if not rel_url.startswith(ASSETS_URL_PREFIXES):
-            url = url.replace(TIANGOLO_COM, f"{TIANGOLO_COM}/{lang_code}")
-    return url
-
-
-def _construct_markdown_link(
-    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.
-    """
-    url = _add_lang_code_to_url(url, lang_code)
-
-    if title:
-        link = f'[{text}]({url} "{title}")'
-    else:
-        link = f"[{text}]({url})"
-
-    if attributes:
-        link += f"{{{attributes}}}"
-
-    return link
-
-
-def replace_markdown_links(
-    text: list[str],
-    links: list[MarkdownLinkInfo],
-    original_links: list[MarkdownLinkInfo],
-    lang_code: str,
-) -> list[str]:
-    """
-    Replace markdown links in the given text with the original links.
-
-    Fail if the number of links does not match the original.
-    """
-
-    if len(links) != len(original_links):
-        raise ValueError(
-            "Number of markdown links does not match the number in the "
-            "original document "
-            f"({len(links)} vs {len(original_links)})"
-        )
-
-    modified_text = text.copy()
-    for i, link_info in enumerate(links):
-        link_text = link_info["text"]
-        link_title = link_info["title"]
-        original_link_info = original_links[i]
-
-        # Replace
-        replacement_link = _construct_markdown_link(
-            url=original_link_info["url"],
-            text=link_text,
-            title=link_title,
-            attributes=original_link_info["attributes"],
-            lang_code=lang_code,
-        )
-        line_no = link_info["line_no"] - 1
-        modified_line = modified_text[line_no]
-        modified_line = modified_line.replace(
-            link_info["full_match"], replacement_link, 1
-        )
-        modified_text[line_no] = modified_line
-
-    return modified_text
-
-
-# HTML links
-# -----------------------------------------------------------------------------------------
-
-
-def extract_html_links(lines: list[str]) -> list[HtmlLinkInfo]:
-    """
-    Extract all HTML links from the given lines.
-
-    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 namedtuples (name, quote, value)
-    - `text` - link text
-    """
-
-    links = []
-    for line_no, line in enumerate(lines, start=1):
-        for html_link in HTML_LINK_RE.finditer(line):
-            link_str = html_link.group(0)
-
-            link_text_match = HTML_LINK_TEXT_RE.match(link_str)
-            assert link_text_match is not None
-            link_text = link_text_match.group(2)
-            assert isinstance(link_text, str)
-
-            link_open_tag_match = HTML_LINK_OPEN_TAG_RE.match(link_str)
-            assert link_open_tag_match is not None
-            link_open_tag = link_open_tag_match.group(1)
-            assert isinstance(link_open_tag, str)
-
-            attributes: list[HTMLLinkAttribute] = []
-            for attr_name, attr_quote, attr_value in re.findall(
-                HTML_ATTR_RE, link_open_tag
-            ):
-                assert isinstance(attr_name, str)
-                assert isinstance(attr_quote, str)
-                assert isinstance(attr_value, str)
-                attributes.append(
-                    HTMLLinkAttribute(
-                        name=attr_name, quote=attr_quote, value=attr_value
-                    )
-                )
-            links.append(
-                HtmlLinkInfo(
-                    line_no=line_no,
-                    full_tag=link_str,
-                    attributes=attributes,
-                    text=link_text,
-                )
-            )
-    return links
-
-
-def _construct_html_link(
-    link_text: str,
-    attributes: list[HTMLLinkAttribute],
-    lang_code: str,
-) -> str:
-    """
-    Reconstruct HTML link, adjusting the URL for the given language code if needed.
-    """
-
-    attributes_upd: list[HTMLLinkAttribute] = []
-    for attribute in attributes:
-        if attribute["name"] == "href":
-            original_url = attribute["value"]
-            url = _add_lang_code_to_url(original_url, lang_code)
-            attributes_upd.append(
-                HTMLLinkAttribute(name="href", quote=attribute["quote"], value=url)
-            )
-        else:
-            attributes_upd.append(attribute)
-
-    attrs_str = " ".join(
-        f"{attribute['name']}={attribute['quote']}{attribute['value']}{attribute['quote']}"
-        for attribute in attributes_upd
-    )
-    return f"<a {attrs_str}>{link_text}</a>"
-
-
-def replace_html_links(
-    text: list[str],
-    links: list[HtmlLinkInfo],
-    original_links: list[HtmlLinkInfo],
-    lang_code: str,
-) -> list[str]:
-    """
-    Replace HTML links in the given text with the links from the original document.
-
-    Adjust URLs for the given language code.
-    Fail if the number of links does not match the original.
-    """
-
-    if len(links) != len(original_links):
-        raise ValueError(
-            "Number of HTML links does not match the number in the "
-            "original document "
-            f"({len(links)} vs {len(original_links)})"
-        )
-
-    modified_text = text.copy()
-    for link_index, link in enumerate(links):
-        original_link_info = original_links[link_index]
-
-        # Replace in the document text
-        replacement_link = _construct_html_link(
-            link_text=link["text"],
-            attributes=original_link_info["attributes"],
-            lang_code=lang_code,
-        )
-        line_no = link["line_no"] - 1
-        modified_text[line_no] = modified_text[line_no].replace(
-            link["full_tag"], replacement_link, 1
-        )
-
-    return modified_text
-
-
-# Multiline code blocks
-# -----------------------------------------------------------------------------------------
-
-
-def get_code_block_lang(line: str) -> str:
-    match = CODE_BLOCK_LANG_RE.match(line)
-    if match:
-        return match.group(1)
-    return ""
-
-
-def extract_multiline_code_blocks(text: list[str]) -> list[MultilineCodeBlockInfo]:
-    blocks: list[MultilineCodeBlockInfo] = []
-
-    in_code_block3 = False
-    in_code_block4 = False
-    current_block_lang = ""
-    current_block_start_line = -1
-    current_block_lines = []
-
-    for line_no, line in enumerate(text, start=1):
-        stripped = line.lstrip()
-
-        # --- Detect opening fence ---
-        if not (in_code_block3 or in_code_block4):
-            if stripped.startswith("```"):
-                current_block_start_line = line_no
-                count = len(stripped) - len(stripped.lstrip("`"))
-                if count == 3:
-                    in_code_block3 = True
-                    current_block_lang = get_code_block_lang(stripped)
-                    current_block_lines = [line]
-                    continue
-                elif count >= 4:
-                    in_code_block4 = True
-                    current_block_lang = get_code_block_lang(stripped)
-                    current_block_lines = [line]
-                    continue
-
-        # --- Detect closing fence ---
-        elif in_code_block3:
-            if stripped.startswith("```"):
-                count = len(stripped) - len(stripped.lstrip("`"))
-                if count == 3:
-                    current_block_lines.append(line)
-                    blocks.append(
-                        MultilineCodeBlockInfo(
-                            lang=current_block_lang,
-                            start_line_no=current_block_start_line,
-                            content=current_block_lines,
-                        )
-                    )
-                    in_code_block3 = False
-                    current_block_lang = ""
-                    current_block_start_line = -1
-                    current_block_lines = []
-                    continue
-            current_block_lines.append(line)
-
-        elif in_code_block4:
-            if stripped.startswith("````"):
-                count = len(stripped) - len(stripped.lstrip("`"))
-                if count >= 4:
-                    current_block_lines.append(line)
-                    blocks.append(
-                        MultilineCodeBlockInfo(
-                            lang=current_block_lang,
-                            start_line_no=current_block_start_line,
-                            content=current_block_lines,
-                        )
-                    )
-                    in_code_block4 = False
-                    current_block_lang = ""
-                    current_block_start_line = -1
-                    current_block_lines = []
-                    continue
-            current_block_lines.append(line)
-
-    return blocks
-
-
-def _split_hash_comment(line: str) -> tuple[str, str | None]:
-    match = HASH_COMMENT_RE.match(line)
-    if match:
-        code = match.group("code").rstrip()
-        comment = match.group("comment")
-        return code, comment
-    return line.rstrip(), None
-
-
-def _split_slashes_comment(line: str) -> tuple[str, str | None]:
-    match = SLASHES_COMMENT_RE.match(line)
-    if match:
-        code = match.group("code").rstrip()
-        comment = match.group("comment")
-        return code, comment
-    return line, None
-
-
-def replace_multiline_code_block(
-    block_a: MultilineCodeBlockInfo, block_b: MultilineCodeBlockInfo
-) -> list[str]:
-    """
-    Replace multiline code block `a` with block `b` leaving comments intact.
-
-    Syntax of comments depends on the language of the code block.
-    Raises ValueError if the blocks are not compatible (different languages or different number of lines).
-    """
-
-    start_line = block_a["start_line_no"]
-    end_line_no = start_line + len(block_a["content"]) - 1
-
-    if block_a["lang"] != block_b["lang"]:
-        raise ValueError(
-            f"Code block (lines {start_line}-{end_line_no}) "
-            "has different language than the original block "
-            f"('{block_a['lang']}' vs '{block_b['lang']}')"
-        )
-    if len(block_a["content"]) != len(block_b["content"]):
-        raise ValueError(
-            f"Code block (lines {start_line}-{end_line_no}) "
-            "has different number of lines than the original block "
-            f"({len(block_a['content'])} vs {len(block_b['content'])})"
-        )
-
-    block_language = block_a["lang"].lower()
-    if block_language in {"mermaid"}:
-        if block_a != block_b:
-            print(
-                f"Skipping mermaid code block replacement (lines {start_line}-{end_line_no}). "
-                "This should be checked manually."
-            )
-        return block_a["content"].copy()  # We don't handle mermaid code blocks for now
-
-    code_block: list[str] = []
-    for line_a, line_b in zip(block_a["content"], block_b["content"]):
-        line_a_comment: str | None = None
-        line_b_comment: str | None = None
-
-        # Handle comments based on language
-        if block_language in {
-            "python",
-            "py",
-            "sh",
-            "bash",
-            "dockerfile",
-            "requirements",
-            "gitignore",
-            "toml",
-            "yaml",
-            "yml",
-            "hash-style-comments",
-        }:
-            _line_a_code, line_a_comment = _split_hash_comment(line_a)
-            _line_b_code, line_b_comment = _split_hash_comment(line_b)
-            res_line = line_b
-            if line_b_comment:
-                res_line = res_line.replace(line_b_comment, line_a_comment, 1)
-            code_block.append(res_line)
-        elif block_language in {"console", "json", "slash-style-comments"}:
-            _line_a_code, line_a_comment = _split_slashes_comment(line_a)
-            _line_b_code, line_b_comment = _split_slashes_comment(line_b)
-            res_line = line_b
-            if line_b_comment:
-                res_line = res_line.replace(line_b_comment, line_a_comment, 1)
-            code_block.append(res_line)
-        else:
-            code_block.append(line_b)
-
-    return code_block
-
-
-def replace_multiline_code_blocks_in_text(
-    text: list[str],
-    code_blocks: list[MultilineCodeBlockInfo],
-    original_code_blocks: list[MultilineCodeBlockInfo],
-) -> list[MultilineCodeBlockInfo]:
-    """
-    Update each code block in `text` with the corresponding code block from
-    `original_code_blocks` with comments taken from `code_blocks`.
-
-    Raises ValueError if the number, language, or shape of code blocks do not match.
-    """
-
-    if len(code_blocks) != len(original_code_blocks):
-        raise ValueError(
-            "Number of code blocks does not match the number in the original document "
-            f"({len(code_blocks)} vs {len(original_code_blocks)})"
-        )
-
-    modified_text = text.copy()
-    for block, original_block in zip(code_blocks, original_code_blocks):
-        updated_content = replace_multiline_code_block(block, original_block)
-
-        start_line_index = block["start_line_no"] - 1
-        for i, updated_line in enumerate(updated_content):
-            modified_text[start_line_index + i] = updated_line
-
-    return modified_text
-
-
-# All checks
-# -----------------------------------------------------------------------------------------
-
-
-def check_translation(
-    doc_lines: list[str],
-    en_doc_lines: list[str],
-    lang_code: str,
-    auto_fix: bool,
-    path: str,
-) -> list[str]:
-    # Fix code includes
-    en_code_includes = extract_code_includes(en_doc_lines)
-    doc_lines_with_placeholders = replace_code_includes_with_placeholders(doc_lines)
-    fixed_doc_lines = replace_placeholders_with_code_includes(
-        doc_lines_with_placeholders, en_code_includes
-    )
-    if auto_fix and (fixed_doc_lines != doc_lines):
-        print(f"Fixing code includes in: {path}")
-        doc_lines = fixed_doc_lines
-
-    # Fix permalinks
-    en_permalinks = extract_header_permalinks(en_doc_lines)
-    doc_permalinks = extract_header_permalinks(doc_lines)
-    fixed_doc_lines = replace_header_permalinks(
-        doc_lines, doc_permalinks, en_permalinks
-    )
-    if auto_fix and (fixed_doc_lines != doc_lines):
-        print(f"Fixing header permalinks in: {path}")
-        doc_lines = fixed_doc_lines
-
-    # Fix markdown links
-    en_markdown_links = extract_markdown_links(en_doc_lines)
-    doc_markdown_links = extract_markdown_links(doc_lines)
-    fixed_doc_lines = replace_markdown_links(
-        doc_lines, doc_markdown_links, en_markdown_links, lang_code
-    )
-    if auto_fix and (fixed_doc_lines != doc_lines):
-        print(f"Fixing markdown links in: {path}")
-        doc_lines = fixed_doc_lines
-
-    # Fix HTML links
-    en_html_links = extract_html_links(en_doc_lines)
-    doc_html_links = extract_html_links(doc_lines)
-    fixed_doc_lines = replace_html_links(
-        doc_lines, doc_html_links, en_html_links, lang_code
-    )
-    if auto_fix and (fixed_doc_lines != doc_lines):
-        print(f"Fixing HTML links in: {path}")
-        doc_lines = fixed_doc_lines
-
-    # Fix multiline code blocks
-    en_code_blocks = extract_multiline_code_blocks(en_doc_lines)
-    doc_code_blocks = extract_multiline_code_blocks(doc_lines)
-    fixed_doc_lines = replace_multiline_code_blocks_in_text(
-        doc_lines, doc_code_blocks, en_code_blocks
-    )
-    if auto_fix and (fixed_doc_lines != doc_lines):
-        print(f"Fixing multiline code blocks in: {path}")
-        doc_lines = fixed_doc_lines
-
-    return doc_lines

scripts/tests/test_translation_fixer/conftest.py

@@ -1,32 +0,0 @@
-import shutil
-from pathlib import Path
-
-import pytest
-from typer.testing import CliRunner
-
-
-@pytest.fixture(name="runner")
-def get_runner():
-    runner = CliRunner()
-    with runner.isolated_filesystem():
-        yield runner
-
-
-@pytest.fixture(name="root_dir")
-def prepare_paths(runner):
-    docs_dir = Path("docs")
-    en_docs_dir = docs_dir / "en" / "docs"
-    lang_docs_dir = docs_dir / "lang" / "docs"
-    en_docs_dir.mkdir(parents=True, exist_ok=True)
-    lang_docs_dir.mkdir(parents=True, exist_ok=True)
-    yield Path.cwd()
-
-
-@pytest.fixture
-def copy_test_files(root_dir: Path, request: pytest.FixtureRequest):
-    en_file_path = Path(request.param[0])
-    translation_file_path = Path(request.param[1])
-    shutil.copy(str(en_file_path), str(root_dir / "docs" / "en" / "docs" / "doc.md"))
-    shutil.copy(
-        str(translation_file_path), str(root_dir / "docs" / "lang" / "docs" / "doc.md")
-    )

scripts/tests/test_translation_fixer/test_code_blocks/data/en_doc.md

@@ -1,44 +0,0 @@
-# Code blocks { #code-blocks }
-
-Some text
-
-```python
-# This is a sample Python code block
-def hello_world():
-    # Comment with indentation
-    print("Hello, world!")  # Print greeting
-```
-
-Some more text
-
-```toml
-# This is a sample TOML code block
-title = "TOML Example"  # Title of the document
-```
-
-And more text
-
-```console
-// Use the command "live" and pass the language code as a CLI argument
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-And even more text
-
-```json
-{
-    // This is a sample JSON code block
-    "greeting": "Hello, world!" // Greeting
-}
-```
-
-Mermaid diagram
-
-```mermaid
-flowchart LR
-    stone(philosophers-stone) -->|requires| harry-1[harry v1]
-```

scripts/tests/test_translation_fixer/test_code_blocks/data/translated_doc_lines_number_gt.md

@@ -1,45 +0,0 @@
-# Code blocks { #code-blocks }
-
-Some text
-
-```python
-# This is a sample Python code block
-def hello_world():
-    # Comment with indentation
-    print("Hello, world!")  # Print greeting
-```
-
-Some more text
-
-```toml
-# Extra line
-# This is a sample TOML code block
-title = "TOML Example"  # Title of the document
-```
-
-And more text
-
-```console
-// Use the command "live" and pass the language code as a CLI argument
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-And even more text
-
-```json
-{
-    // This is a sample JSON code block
-    "greeting": "Hello, world!" // Greeting
-}
-```
-
-Диаграма Mermaid
-
-```mermaid
-flowchart LR
-    stone(philosophers-stone) -->|requires| harry-1[harry v1]
-```

scripts/tests/test_translation_fixer/test_code_blocks/data/translated_doc_lines_number_lt.md

@@ -1,45 +0,0 @@
-# Code blocks { #code-blocks }
-
-Some text
-
-```python
-# This is a sample Python code block
-def hello_world():
-    # Comment with indentation
-    print("Hello, world!")  # Print greeting
-```
-
-Some more text
-
-The following block is missing first line:
-
-```toml
-title = "TOML Example"  # Title of the document
-```
-
-And more text
-
-```console
-// Use the command "live" and pass the language code as a CLI argument
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-And even more text
-
-```json
-{
-    // This is a sample JSON code block
-    "greeting": "Hello, world!" // Greeting
-}
-```
-
-Диаграма Mermaid
-
-```mermaid
-flowchart LR
-    stone(philosophers-stone) -->|requires| harry-1[harry v1]
-```

scripts/tests/test_translation_fixer/test_code_blocks/data/translated_doc_mermaid_not_translated.md

@@ -1,44 +0,0 @@
-# Code blocks { #code-blocks }
-
-Some text
-
-```python
-# This is a sample Python code block
-def hello_world():
-    # Comment with indentation
-    print("Hello, world!")  # Print greeting
-```
-
-Some more text
-
-```toml
-# This is a sample TOML code block
-title = "TOML Example"  # Title of the document
-```
-
-And more text
-
-```console
-// Use the command "live" and pass the language code as a CLI argument
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-And even more text
-
-```json
-{
-    // This is a sample JSON code block
-    "greeting": "Hello, world!" // Greeting
-}
-```
-
-Диаграма Mermaid
-
-```mermaid
-flowchart LR
-    stone(philosophers-stone) -->|requires| harry-1[harry v1]
-```

scripts/tests/test_translation_fixer/test_code_blocks/data/translated_doc_mermaid_translated.md

@@ -1,44 +0,0 @@
-# Code blocks { #code-blocks }
-
-Some text
-
-```python
-# This is a sample Python code block
-def hello_world():
-    # Comment with indentation
-    print("Hello, world!")  # Print greeting
-```
-
-Some more text
-
-```toml
-# This is a sample TOML code block
-title = "TOML Example"  # Title of the document
-```
-
-And more text
-
-```console
-// Use the command "live" and pass the language code as a CLI argument
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-And even more text
-
-```json
-{
-    // This is a sample JSON code block
-    "greeting": "Hello, world!" // Greeting
-}
-```
-
-Диаграма Mermaid
-
-```mermaid
-flowchart LR
-    stone(philosophers-stone) -->|требует| harry-1[harry v1]
-```

scripts/tests/test_translation_fixer/test_code_blocks/data/translated_doc_number_gt.md

@@ -1,50 +0,0 @@
-# Code blocks { #code-blocks }
-
-Some text
-
-```python
-# This is a sample Python code block
-def hello_world():
-    # Comment with indentation
-    print("Hello, world!")  # Print greeting
-```
-
-Some more text
-
-```toml
-# This is a sample TOML code block
-title = "TOML Example"  # Title of the document
-```
-
-Extra code block
-
-```
-$ cd my_project
-```
-
-And more text
-
-```console
-// Use the command "live" and pass the language code as a CLI argument
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-And even more text
-
-```json
-{
-    // This is a sample JSON code block
-    "greeting": "Hello, world!" // Greeting
-}
-```
-
-Диаграма Mermaid
-
-```mermaid
-flowchart LR
-    stone(philosophers-stone) -->|requires| harry-1[harry v1]
-```

scripts/tests/test_translation_fixer/test_code_blocks/data/translated_doc_number_lt.md

@@ -1,41 +0,0 @@
-# Code blocks { #code-blocks }
-
-Some text
-
-```python
-# This is a sample Python code block
-def hello_world():
-    # Comment with indentation
-    print("Hello, world!")  # Print greeting
-```
-
-Some more text
-
-Missing code block...
-
-And more text
-
-```console
-// Use the command "live" and pass the language code as a CLI argument
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-And even more text
-
-```json
-{
-    // This is a sample JSON code block
-    "greeting": "Hello, world!" // Greeting
-}
-```
-
-Диаграма Mermaid
-
-```mermaid
-flowchart LR
-    stone(philosophers-stone) -->|requires| harry-1[harry v1]
-```

scripts/tests/test_translation_fixer/test_code_blocks/data/translated_doc_wrong_lang_code.md

@@ -1,46 +0,0 @@
-# Code blocks { #code-blocks }
-
-Some text
-
-```python
-# This is a sample Python code block
-def hello_world():
-    # Comment with indentation
-    print("Hello, world!")  # Print greeting
-```
-
-Some more text
-
-The following block has wrong language code (should be TOML):
-
-```yaml
-# This is a sample TOML code block
-title = "TOML Example"  # Title of the document
-```
-
-And more text
-
-```console
-// Use the command "live" and pass the language code as a CLI argument
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-And even more text
-
-```json
-{
-    // This is a sample JSON code block
-    "greeting": "Hello, world!" // Greeting
-}
-```
-
-Диаграма Mermaid
-
-```mermaid
-flowchart LR
-    stone(philosophers-stone) -->|requires| harry-1[harry v1]
-```

scripts/tests/test_translation_fixer/test_code_blocks/data/translated_doc_wrong_lang_code_2.md

@@ -1,46 +0,0 @@
-# Code blocks { #code-blocks }
-
-Some text
-
-```python
-# This is a sample Python code block
-def hello_world():
-    # Comment with indentation
-    print("Hello, world!")  # Print greeting
-```
-
-Some more text
-
-The following block has wrong language code (should be TOML):
-
-```
-# This is a sample TOML code block
-title = "TOML Example"  # Title of the document
-```
-
-And more text
-
-```console
-// Use the command "live" and pass the language code as a CLI argument
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-And even more text
-
-```json
-{
-    // This is a sample JSON code block
-    "greeting": "Hello, world!" // Greeting
-}
-```
-
-Диаграма Mermaid
-
-```mermaid
-flowchart LR
-    stone(philosophers-stone) -->|requires| harry-1[harry v1]
-```

scripts/tests/test_translation_fixer/test_code_blocks/test_code_blocks_lines_number_mismatch.py

@@ -1,58 +0,0 @@
-from pathlib import Path
-
-import pytest
-from typer.testing import CliRunner
-
-from scripts.translation_fixer import cli
-
-data_path = Path(
-    "scripts/tests/test_translation_fixer/test_code_blocks/data"
-).absolute()
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_lines_number_gt.md")],
-    indirect=True,
-)
-def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1, result.output
-
-    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
-    assert (
-        "Code block (lines 14-18) has different number of lines than the original block (5 vs 4)"
-    ) in result.output
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_lines_number_lt.md")],
-    indirect=True,
-)
-def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    # assert result.exit_code == 1, result.output
-
-    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
-    assert (
-        "Code block (lines 16-18) has different number of lines than the original block (3 vs 4)"
-    ) in result.output

scripts/tests/test_translation_fixer/test_code_blocks/test_code_blocks_mermaid.py

@@ -1,59 +0,0 @@
-from pathlib import Path
-
-import pytest
-from typer.testing import CliRunner
-
-from scripts.translation_fixer import cli
-
-data_path = Path(
-    "scripts/tests/test_translation_fixer/test_code_blocks/data"
-).absolute()
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_mermaid_translated.md")],
-    indirect=True,
-)
-def test_translated(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 0, result.output
-
-    fixed_content = (root_dir / "docs" / "lang" / "docs" / "doc.md").read_text()
-    expected_content = Path(
-        f"{data_path}/translated_doc_mermaid_translated.md"
-    ).read_text()
-
-    assert fixed_content == expected_content  # Translated doc remains unchanged
-    assert (
-        "Skipping mermaid code block replacement (lines 41-44). This should be checked manually."
-    ) in result.output
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [
-        (
-            f"{data_path}/en_doc.md",
-            f"{data_path}/translated_doc_mermaid_not_translated.md",
-        )
-    ],
-    indirect=True,
-)
-def test_not_translated(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 0, result.output
-
-    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()
-
-    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

@@ -1,56 +0,0 @@
-from pathlib import Path
-
-import pytest
-from typer.testing import CliRunner
-
-from scripts.translation_fixer import cli
-
-data_path = Path(
-    "scripts/tests/test_translation_fixer/test_code_blocks/data"
-).absolute()
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_gt.md")],
-    indirect=True,
-)
-def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1, result.output
-
-    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
-    assert (
-        "Number of code blocks does not match the number "
-        "in the original document (6 vs 5)"
-    ) in result.output
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_lt.md")],
-    indirect=True,
-)
-def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    # assert result.exit_code == 1, result.output
-
-    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
-    assert (
-        "Number of code blocks does not match the number "
-        "in the original document (4 vs 5)"
-    ) in result.output

scripts/tests/test_translation_fixer/test_code_blocks/test_code_blocks_wrong_lang_code.py

@@ -1,58 +0,0 @@
-from pathlib import Path
-
-import pytest
-from typer.testing import CliRunner
-
-from scripts.translation_fixer import cli
-
-data_path = Path(
-    "scripts/tests/test_translation_fixer/test_code_blocks/data"
-).absolute()
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_wrong_lang_code.md")],
-    indirect=True,
-)
-def test_wrong_lang_code_1(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1, result.output
-
-    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
-    assert (
-        "Code block (lines 16-19) has different language than the original block ('yaml' vs 'toml')"
-    ) in result.output
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_wrong_lang_code_2.md")],
-    indirect=True,
-)
-def test_wrong_lang_code_2(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1, result.output
-
-    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()
-
-    assert fixed_content == expected_content  # Translated doc remains unchanged
-    assert "Error processing docs/lang/docs/doc.md" in result.output
-    assert (
-        "Code block (lines 16-19) has different language than the original block ('' vs 'toml')"
-    ) in result.output

scripts/tests/test_translation_fixer/test_code_includes/data/en_doc.md

@@ -1,13 +0,0 @@
-# Header
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[19:21] *}
-
-Some text
-
-{* ../../docs_src/bigger_applications/app_an_py39/internal/admin.py hl[3] title["app/internal/admin.py"] *}
-
-Some more text
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[30:38] hl[31:33] *}
-
-And even more text

scripts/tests/test_translation_fixer/test_code_includes/data/translated_doc_number_gt.md

@@ -1,15 +0,0 @@
-# Header
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[19:21] *}
-
-Some text
-
-{* ../../docs_src/bigger_applications/app_an_py39/internal/admin.py hl[3] title["app/internal/admin.py"] *}
-
-Some more text
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[30:38] hl[31:33] *}
-
-And even more text
-
-{* ../../docs_src/python_types/tutorial001_py39.py *}

scripts/tests/test_translation_fixer/test_code_includes/data/translated_doc_number_lt.md

@@ -1,13 +0,0 @@
-# Header
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[19:21] *}
-
-Some text
-
-{* ../../docs_src/bigger_applications/app_an_py39/internal/admin.py hl[3] title["app/internal/admin.py"] *}
-
-Some more text
-
-...
-
-And even more text

scripts/tests/test_translation_fixer/test_code_includes/test_number_mismatch.py

@@ -1,56 +0,0 @@
-from pathlib import Path
-
-import pytest
-from typer.testing import CliRunner
-
-from scripts.translation_fixer import cli
-
-data_path = Path(
-    "scripts/tests/test_translation_fixer/test_code_includes/data"
-).absolute()
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_gt.md")],
-    indirect=True,
-)
-def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1
-
-    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
-    assert (
-        "Number of code include placeholders does not match the number of code includes "
-        "in the original document (4 vs 3)"
-    ) in result.output
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_lt.md")],
-    indirect=True,
-)
-def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1
-
-    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
-    assert (
-        "Number of code include placeholders does not match the number of code includes "
-        "in the original document (2 vs 3)"
-    ) in result.output

scripts/tests/test_translation_fixer/test_complex_doc/data/en_doc.md

@@ -1,244 +0,0 @@
-# Test translation fixer tool { #test-translation-fixer }
-
-## Code blocks with and without comments { #code-blocks-with-and-without-comments }
-
-This is a test page for the translation fixer tool.
-
-### Code blocks with comments { #code-blocks-with-comments }
-
-The following code blocks include comments in different styles.
-Fixer tool should fix content, but preserve comments correctly.
-
-```python
-# This is a sample Python code block
-def hello_world():
-    # Comment with indentation
-    print("Hello, world!")  # Print greeting
-```
-
-```toml
-# This is a sample TOML code block
-title = "TOML Example"  # Title of the document
-```
-
-```console
-// Use the command "live" and pass the language code as a CLI argument
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-```json
-{
-    // This is a sample JSON code block
-    "greeting": "Hello, world!" // Greeting
-}
-```
-
-
-### Code blocks with comments where language uses different comment styles { #code-blocks-with-different-comment-styles }
-
-The following code blocks include comments in different styles based on the language.
-Fixer tool will not preserve comments in these blocks.
-
-```json
-{
-    # This is a sample JSON code block
-    "greeting": "Hello, world!" # Print greeting
-}
-```
-
-```console
-# This is a sample console code block
-$ echo "Hello, world!"  # Print greeting
-```
-
-```toml
-// This is a sample TOML code block
-title = "TOML Example"  // Title of the document
-```
-
-
-### Code blocks with comments with unsupported languages or without language specified { #code-blocks-with-unsupported-languages }
-
-The following code blocks use unsupported languages for comment preservation.
-Fixer tool will not preserve comments in these blocks.
-
-```javascript
-// This is a sample JavaScript code block
-console.log("Hello, world!"); // Print greeting
-```
-
-```
-# This is a sample console code block
-$ echo "Hello, world!"  # Print greeting
-```
-
-```
-// This is a sample console code block
-$ echo "Hello, world!"  // Print greeting
-```
-
-
-### Code blocks with comments that don't follow pattern { #code-blocks-with-comments-without-pattern }
-
-Fixer tool expects comments that follow specific pattern:
-
-- For hash-style comments: comment starts with `# ` (hash following by whitespace) in the beginning of the string or after a whitespace.
-- For slash-style comments: comment starts with `// ` (two slashes following by whitespace) in the beginning of the string or after a whitespace.
-
-If comment doesn't follow this pattern, fixer tool will not preserve it.
-
-```python
-#Function declaration
-def hello_world():# Print greeting
-    print("Hello, world!")  #Print greeting without space after hash
-```
-
-```console
-//Function declaration
-def hello_world():// Print greeting
-    print("Hello, world!")  //Print greeting without space after slashes
-```
-
-## Code blocks with quadruple backticks { #code-blocks-with-quadruple-backticks }
-
-The following code block uses quadruple backticks.
-
-````python
-# Hello world function
-def hello_world():
-    print("Hello, world!")  # Print greeting
-````
-
-### Backticks number mismatch is fixable { #backticks-number-mismatch-is-fixable }
-
-The following code block has triple backticks in the original document, but quadruple backticks in the translated document.
-It will be fixed by the fixer tool (will convert to triple backticks).
-
-```Python
-# Some Python code
-```
-
-### Triple backticks inside quadruple backticks { #triple-backticks-inside-quadruple-backticks }
-
-Comments inside nested code block will NOT be preserved.
-
-````
-Here is a code block with quadruple backticks that contains triple backticks inside:
-
-```python
-# This is a sample Python code block
-def hello_world():
-    print("Hello, world!")  # Print greeting
-```
-
-````
-
-# Code includes { #code-includes }
-
-## Simple code includes { #simple-code-includes }
-
-{* ../../docs_src/python_types/tutorial001_py39.py *}
-
-{* ../../docs_src/python_types/tutorial002_py39.py *}
-
-
-## Code includes with highlighting { #code-includes-with-highlighting }
-
-{* ../../docs_src/python_types/tutorial002_py39.py hl[1] *}
-
-{* ../../docs_src/python_types/tutorial006_py39.py hl[10] *}
-
-
-## Code includes with line ranges { #code-includes-with-line-ranges }
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[19:21] *}
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[30:38] *}
-
-
-## Code includes with line ranges and highlighting { #code-includes-with-line-ranges-and-highlighting }
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[30:38] hl[31:33] *}
-
-{* ../../docs_src/dependencies/tutorial015_an_py310.py ln[10:15] hl[12:14] *}
-
-
-## Code includes qith title { #code-includes-with-title }
-
-{* ../../docs_src/bigger_applications/app_an_py39/routers/users.py hl[1,3] title["app/routers/users.py"] *}
-
-{* ../../docs_src/bigger_applications/app_an_py39/internal/admin.py hl[3] title["app/internal/admin.py"] *}
-
-## Code includes with unknown attributes { #code-includes-with-unknown-attributes }
-
-{* ../../docs_src/python_types/tutorial001_py39.py unknown[123] *}
-
-## Some more code includes to test fixing { #some-more-code-includes-to-test-fixing }
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[19:21] *}
-
-{* ../../docs_src/bigger_applications/app_an_py39/internal/admin.py hl[3] title["app/internal/admin.py"] *}
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[30:38] hl[31:33] *}
-
-
-
-# Links { #links }
-
-## Markdown-style links { #markdown-style-links }
-
-This is a [Markdown link](https://example.com) to an external site.
-
-This is a link with attributes: [**FastAPI** Project Generators](project-generation.md){.internal-link target=_blank}
-
-This is a link to the main FastAPI site: [FastAPI](https://fastapi.tiangolo.com) - tool should add language code to the URL.
-
-This is a link to one of the pages on FastAPI site: [How to](https://fastapi.tiangolo.com/how-to/) - tool should add language code to the URL.
-
-Link to test wrong attribute: [**FastAPI** Project Generators](project-generation.md){.internal-link} - tool should fix the attribute.
-
-Link with a title: [Example](https://example.com "Example site") - URL will be fixed, title preserved.
-
-### Markdown link to static assets { #markdown-link-to-static-assets }
-
-These are links to static assets:
-
-* [FastAPI Logo](https://fastapi.tiangolo.com/img/fastapi-logo.png)
-* [FastAPI CSS](https://fastapi.tiangolo.com/css/fastapi.css)
-* [FastAPI JS](https://fastapi.tiangolo.com/js/fastapi.js)
-
-Tool should NOT add language code to their URLs.
-
-## HTML-style links { #html-style-links }
-
-This is an <a href="https://example.com" target="_blank" class="external-link">HTML link</a> to an external site.
-
-This is an <a href="https://fastapi.tiangolo.com">link to the main FastAPI site</a> - tool should add language code to the URL.
-
-This is an <a href="https://fastapi.tiangolo.com/how-to/">link to one of the pages on FastAPI site</a> - tool should add language code to the URL.
-
-Link to test wrong attribute: <a href="project-generation.md" class="internal-link">**FastAPI** Project Generators</a> - tool should fix the attribute.
-
-### HTML links to static assets { #html-links-to-static-assets }
-
-These are links to static assets:
-
-* <a href="https://fastapi.tiangolo.com/img/fastapi-logo.png">FastAPI Logo</a>
-* <a href="https://fastapi.tiangolo.com/css/fastapi.css">FastAPI CSS</a>
-* <a href="https://fastapi.tiangolo.com/js/fastapi.js">FastAPI JS</a>
-
-Tool should NOT add language code to their URLs.
-
-# Header (with HTML link to <a href="https://tiangolo.com">tiangolo.com</a>) { #header-with-html-link-to-tiangolo-com }
-
-#Not a header
-
-```Python
-# Also not a header
-```
-
-Some text

scripts/tests/test_translation_fixer/test_complex_doc/data/translated_doc.md

@@ -1,240 +0,0 @@
-# Тестовый инструмент исправления переводов { #test-translation-fixer }
-
-## Блоки кода с комментариями и без комментариев { #code-blocks-with-and-without-comments }
-
-Это тестовая страница для инструмента исправления переводов.
-
-### Блоки кода с комментариями { #code-blocks-with-comments }
-
-Следующие блоки кода содержат комментарии в разных стилях.
-Инструмент исправления должен исправлять содержимое, но корректно сохранять комментарии.
-
-```python
-# Это пример блока кода на Python
-def hello_world():
-    # Комментарий с отступом
-    print("Hello, world!")  # Печать приветствия
-```
-
-```toml
-# Это пример блока кода на TOML
-title = "TOML Example"  # Заголовок документа
-```
-
-```console
-// Используйте команду "live" и передайте код языка в качестве аргумента CLI
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-```json
-{
-    // Это пример блока кода на JSON
-    "greeting": "Hello, world!" // Печать приветствия
-}
-```
-
-
-### Блоки кода с комментариями, где язык использует другие стили комментариев { #code-blocks-with-different-comment-styles }
-
-Следующие блоки кода содержат комментарии в разных стилях в зависимости от языка.
-Инструмент исправления не будет сохранять комментарии в этих блоках.
-
-```json
-{
-    # Это пример блока кода на JSON
-    "greeting": "Hello, world!" # Печать приветствия
-}
-```
-
-```console
-# Это пример блока кода консоли
-$ echo "Hello, world!"  # Печать приветствия
-```
-
-```toml
-// Это пример блока кода на TOML
-title = "TOML Example"  // Заголовок документа
-```
-
-### Блоки кода с комментариями на неподдерживаемых языках или без указания языка { #code-blocks-with-unsupported-languages }
-
-Следующие блоки кода используют неподдерживаемые языки для сохранения комментариев.
-Инструмент исправления не будет сохранять комментарии в этих блоках.
-
-```javascript
-// Это пример блока кода на JavaScript
-console.log("Hello, world!"); // Печать приветствия
-```
-
-```
-# Это пример блока кода консоли
-$ echo "Hello, world!"  # Печать приветствия
-```
-
-```
-// Это пример блока кода консоли
-$ echo "Hello, world!"  // Печать приветствия
-```
-
-### Блоки кода с комментариями, которые не соответствуют шаблону { #code-blocks-with-comments-without-pattern }
-
-Инструмент исправления ожидает комментарии, которые соответствуют определённому шаблону:
-
-- Для комментариев в стиле с решёткой: комментарий начинается с `# ` (решётка, затем пробел) в начале строки или после пробела.
-- Для комментариев в стиле со слешами: комментарий начинается с `// ` (два слеша, затем пробел) в начале строки или после пробела.
-
-Если комментарий не соответствует этому шаблону, инструмент исправления не будет его сохранять.
-
-```python
-#Объявление функции
-def hello_world():# Печать приветствия
-    print("Hello, world!")  #Печать приветствия без пробела после решётки
-```
-
-```console
-//Объявление функции
-def hello_world():// Печать приветствия
-    print("Hello, world!")  //Печать приветствия без пробела после слешей
-```
-
-## Блок кода с четырёхкратными обратными кавычками { #code-blocks-with-quadruple-backticks }
-
-Следующий блок кода содержит четырёхкратные обратные кавычки.
-
-````python
-# Функция приветствия
-def hello_world():
-    print("Hello, world")  # Печать приветствия
-````
-
-### Несоответствие обратных кавычек фиксится { #backticks-number-mismatch-is-fixable }
-
-Следующий блок кода имеет тройные обратные кавычки в оригинальном документе, но четырёхкратные обратные кавычки в переведённом документе.
-Это будет исправлено инструментом исправления (будет преобразовано в тройные обратные кавычки).
-
-````Python
-# Немного кода на Python
-````
-
-### Блок кода в тройных обратных кавычка внутри блока кода в четырёхкратных обратных кавычках { #triple-backticks-inside-quadruple-backticks }
-
-Комментарии внутри вложенного блока кода в тройных обратных кавычках НЕ БУДУТ сохранены.
-
-````
-Here is a code block with quadruple backticks that contains triple backticks inside:
-
-```python
-# Этот комментарий НЕ будет сохранён
-def hello_world():
-    print("Hello, world")  # Как и этот комментарий
-```
-
-````
-
-# Включения кода { #code-includes }
-
-## Простые включения кода { #simple-code-includes }
-
-{* ../../docs_src/python_types/tutorial001_py39.py *}
-
-{* ../../docs_src/python_types/tutorial002_py39.py *}
-
-
-## Включения кода с подсветкой { #code-includes-with-highlighting }
-
-{* ../../docs_src/python_types/tutorial002_py39.py hl[1] *}
-
-{* ../../docs_src/python_types/tutorial006_py39.py hl[10] *}
-
-
-## Включения кода с диапазонами строк { #code-includes-with-line-ranges }
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[19:21] *}
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[30:38] *}
-
-
-## Включения кода с диапазонами строк и подсветкой { #code-includes-with-line-ranges-and-highlighting }
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[30:38] hl[31:33] *}
-
-{* ../../docs_src/dependencies/tutorial015_an_py310.py ln[10:15] hl[12:14] *}
-
-
-## Включения кода с заголовком { #code-includes-with-title }
-
-{* ../../docs_src/bigger_applications/app_an_py39/routers/users.py hl[1,3] title["app/routers/users.py"] *}
-
-{* ../../docs_src/bigger_applications/app_an_py39/internal/admin.py hl[3] title["app/internal/admin.py"] *}
-
-## Включения кода с неизвестными атрибутами { #code-includes-with-unknown-attributes }
-
-{* ../../docs_src/python_types/tutorial001_py39.py unknown[123] *}
-
-## Ещё включения кода для тестирования исправления { #some-more-code-includes-to-test-fixing }
-
-{*    ../../docs_src/dependencies/tutorial013_an_py310.py     ln[19 : 21]    *}
-
-{* ../../docs_src/bigger_applications/app_an_py39/wrong.py hl[3] title["app/internal/admin.py"] *}
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[1:30] hl[1:10] *}
-
-# Ссылки { #links }
-
-## Ссылки в стиле Markdown { #markdown-style-links }
-
-Это [Markdown-ссылка](https://example.com) на внешний сайт.
-
-Это ссылка с атрибутами: [**FastAPI** генераторы проектов](project-generation.md){.internal-link target=_blank}
-
-Это ссылка на основной сайт FastAPI: [FastAPI](https://fastapi.tiangolo.com) — инструмент должен добавить код языка в URL.
-
-Это ссылка на одну из страниц на сайте FastAPI: [How to](https://fastapi.tiangolo.com/how-to) — инструмент должен добавить код языка в URL.
-
-Ссылка для тестирования неправильного атрибута: [**FastAPI** генераторы проектов](project-generation.md){.external-link} - инструмент должен исправить атрибут.
-
-Ссылка с заголовком: [Пример](http://example.com/ "Сайт для примера") - URL будет исправлен инструментом, заголовок сохранится.
-
-### Markdown ссылки на статические ресурсы { #markdown-link-to-static-assets }
-
-Это ссылки на статические ресурсы:
-
-* [FastAPI Logo](https://fastapi.tiangolo.com/img/fastapi-logo.png)
-* [FastAPI CSS](https://fastapi.tiangolo.com/css/fastapi.css)
-* [FastAPI JS](https://fastapi.tiangolo.com/js/fastapi.js)
-
-Инструмент НЕ должен добавлять код языка в их URL.
-
-## Ссылки в стиле HTML { #html-style-links }
-
-Это <a href="https://example.com" target="_blank" class="external-link">HTML-ссылка</a> на внешний сайт.
-
-Это <a href="https://fastapi.tiangolo.com">ссылка на основной сайт FastAPI</a> — инструмент должен добавить код языка в URL.
-
-Это <a href="https://fastapi.tiangolo.com/how-to/">ссылка на одну из страниц на сайте FastAPI</a> — инструмент должен добавить код языка в URL.
-
-Ссылка для тестирования неправильного атрибута: <a href="project-generation.md" class="external-link">**FastAPI** генераторы проектов</a> - инструмент должен исправить атрибут.
-
-### HTML ссылки на статические ресурсы { #html-links-to-static-assets }
-
-Это ссылки на статические ресурсы:
-
-* <a href="https://fastapi.tiangolo.com/img/fastapi-logo.png">FastAPI Logo</a>
-* <a href="https://fastapi.tiangolo.com/css/fastapi.css">FastAPI CSS</a>
-* <a href="https://fastapi.tiangolo.com/js/fastapi.js">FastAPI JS</a>
-
-Инструмент НЕ должен добавлять код языка в их URL.
-
-# Заголовок (с HTML ссылкой на <a href="https://tiangolo.com">tiangolo.com</a>) { #header-5 }
-
-#Не заголовок
-
-```Python
-# Также не заголовок
-```
-
-Немного текста

scripts/tests/test_translation_fixer/test_complex_doc/data/translated_doc_expected.md

@@ -1,240 +0,0 @@
-# Тестовый инструмент исправления переводов { #test-translation-fixer }
-
-## Блоки кода с комментариями и без комментариев { #code-blocks-with-and-without-comments }
-
-Это тестовая страница для инструмента исправления переводов.
-
-### Блоки кода с комментариями { #code-blocks-with-comments }
-
-Следующие блоки кода содержат комментарии в разных стилях.
-Инструмент исправления должен исправлять содержимое, но корректно сохранять комментарии.
-
-```python
-# Это пример блока кода на Python
-def hello_world():
-    # Комментарий с отступом
-    print("Hello, world!")  # Печать приветствия
-```
-
-```toml
-# Это пример блока кода на TOML
-title = "TOML Example"  # Заголовок документа
-```
-
-```console
-// Используйте команду "live" и передайте код языка в качестве аргумента CLI
-$ python ./scripts/docs.py live es
-
-<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
-<span style="color: green;">[INFO]</span> Start watching changes
-<span style="color: green;">[INFO]</span> Start detecting changes
-```
-
-```json
-{
-    // Это пример блока кода на JSON
-    "greeting": "Hello, world!" // Печать приветствия
-}
-```
-
-
-### Блоки кода с комментариями, где язык использует другие стили комментариев { #code-blocks-with-different-comment-styles }
-
-Следующие блоки кода содержат комментарии в разных стилях в зависимости от языка.
-Инструмент исправления не будет сохранять комментарии в этих блоках.
-
-```json
-{
-    # This is a sample JSON code block
-    "greeting": "Hello, world!" # Print greeting
-}
-```
-
-```console
-# This is a sample console code block
-$ echo "Hello, world!"  # Print greeting
-```
-
-```toml
-// This is a sample TOML code block
-title = "TOML Example"  // Title of the document
-```
-
-### Блоки кода с комментариями на неподдерживаемых языках или без указания языка { #code-blocks-with-unsupported-languages }
-
-Следующие блоки кода используют неподдерживаемые языки для сохранения комментариев.
-Инструмент исправления не будет сохранять комментарии в этих блоках.
-
-```javascript
-// This is a sample JavaScript code block
-console.log("Hello, world!"); // Print greeting
-```
-
-```
-# This is a sample console code block
-$ echo "Hello, world!"  # Print greeting
-```
-
-```
-// This is a sample console code block
-$ echo "Hello, world!"  // Print greeting
-```
-
-### Блоки кода с комментариями, которые не соответствуют шаблону { #code-blocks-with-comments-without-pattern }
-
-Инструмент исправления ожидает комментарии, которые соответствуют определённому шаблону:
-
-- Для комментариев в стиле с решёткой: комментарий начинается с `# ` (решётка, затем пробел) в начале строки или после пробела.
-- Для комментариев в стиле со слешами: комментарий начинается с `// ` (два слеша, затем пробел) в начале строки или после пробела.
-
-Если комментарий не соответствует этому шаблону, инструмент исправления не будет его сохранять.
-
-```python
-#Function declaration
-def hello_world():# Print greeting
-    print("Hello, world!")  #Print greeting without space after hash
-```
-
-```console
-//Function declaration
-def hello_world():// Print greeting
-    print("Hello, world!")  //Print greeting without space after slashes
-```
-
-## Блок кода с четырёхкратными обратными кавычками { #code-blocks-with-quadruple-backticks }
-
-Следующий блок кода содержит четырёхкратные обратные кавычки.
-
-````python
-# Функция приветствия
-def hello_world():
-    print("Hello, world!")  # Печать приветствия
-````
-
-### Несоответствие обратных кавычек фиксится { #backticks-number-mismatch-is-fixable }
-
-Следующий блок кода имеет тройные обратные кавычки в оригинальном документе, но четырёхкратные обратные кавычки в переведённом документе.
-Это будет исправлено инструментом исправления (будет преобразовано в тройные обратные кавычки).
-
-```Python
-# Немного кода на Python
-```
-
-### Блок кода в тройных обратных кавычка внутри блока кода в четырёхкратных обратных кавычках { #triple-backticks-inside-quadruple-backticks }
-
-Комментарии внутри вложенного блока кода в тройных обратных кавычках НЕ БУДУТ сохранены.
-
-````
-Here is a code block with quadruple backticks that contains triple backticks inside:
-
-```python
-# This is a sample Python code block
-def hello_world():
-    print("Hello, world!")  # Print greeting
-```
-
-````
-
-# Включения кода { #code-includes }
-
-## Простые включения кода { #simple-code-includes }
-
-{* ../../docs_src/python_types/tutorial001_py39.py *}
-
-{* ../../docs_src/python_types/tutorial002_py39.py *}
-
-
-## Включения кода с подсветкой { #code-includes-with-highlighting }
-
-{* ../../docs_src/python_types/tutorial002_py39.py hl[1] *}
-
-{* ../../docs_src/python_types/tutorial006_py39.py hl[10] *}
-
-
-## Включения кода с диапазонами строк { #code-includes-with-line-ranges }
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[19:21] *}
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[30:38] *}
-
-
-## Включения кода с диапазонами строк и подсветкой { #code-includes-with-line-ranges-and-highlighting }
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[30:38] hl[31:33] *}
-
-{* ../../docs_src/dependencies/tutorial015_an_py310.py ln[10:15] hl[12:14] *}
-
-
-## Включения кода с заголовком { #code-includes-with-title }
-
-{* ../../docs_src/bigger_applications/app_an_py39/routers/users.py hl[1,3] title["app/routers/users.py"] *}
-
-{* ../../docs_src/bigger_applications/app_an_py39/internal/admin.py hl[3] title["app/internal/admin.py"] *}
-
-## Включения кода с неизвестными атрибутами { #code-includes-with-unknown-attributes }
-
-{* ../../docs_src/python_types/tutorial001_py39.py unknown[123] *}
-
-## Ещё включения кода для тестирования исправления { #some-more-code-includes-to-test-fixing }
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[19:21] *}
-
-{* ../../docs_src/bigger_applications/app_an_py39/internal/admin.py hl[3] title["app/internal/admin.py"] *}
-
-{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[30:38] hl[31:33] *}
-
-# Ссылки { #links }
-
-## Ссылки в стиле Markdown { #markdown-style-links }
-
-Это [Markdown-ссылка](https://example.com) на внешний сайт.
-
-Это ссылка с атрибутами: [**FastAPI** генераторы проектов](project-generation.md){.internal-link target=_blank}
-
-Это ссылка на основной сайт FastAPI: [FastAPI](https://fastapi.tiangolo.com/lang) — инструмент должен добавить код языка в URL.
-
-Это ссылка на одну из страниц на сайте FastAPI: [How to](https://fastapi.tiangolo.com/lang/how-to/) — инструмент должен добавить код языка в URL.
-
-Ссылка для тестирования неправильного атрибута: [**FastAPI** генераторы проектов](project-generation.md){.internal-link} - инструмент должен исправить атрибут.
-
-Ссылка с заголовком: [Пример](https://example.com "Сайт для примера") - URL будет исправлен инструментом, заголовок сохранится.
-
-### Markdown ссылки на статические ресурсы { #markdown-link-to-static-assets }
-
-Это ссылки на статические ресурсы:
-
-* [FastAPI Logo](https://fastapi.tiangolo.com/img/fastapi-logo.png)
-* [FastAPI CSS](https://fastapi.tiangolo.com/css/fastapi.css)
-* [FastAPI JS](https://fastapi.tiangolo.com/js/fastapi.js)
-
-Инструмент НЕ должен добавлять код языка в их URL.
-
-## Ссылки в стиле HTML { #html-style-links }
-
-Это <a href="https://example.com" target="_blank" class="external-link">HTML-ссылка</a> на внешний сайт.
-
-Это <a href="https://fastapi.tiangolo.com/lang">ссылка на основной сайт FastAPI</a> — инструмент должен добавить код языка в URL.
-
-Это <a href="https://fastapi.tiangolo.com/lang/how-to/">ссылка на одну из страниц на сайте FastAPI</a> — инструмент должен добавить код языка в URL.
-
-Ссылка для тестирования неправильного атрибута: <a href="project-generation.md" class="internal-link">**FastAPI** генераторы проектов</a> - инструмент должен исправить атрибут.
-
-### HTML ссылки на статические ресурсы { #html-links-to-static-assets }
-
-Это ссылки на статические ресурсы:
-
-* <a href="https://fastapi.tiangolo.com/img/fastapi-logo.png">FastAPI Logo</a>
-* <a href="https://fastapi.tiangolo.com/css/fastapi.css">FastAPI CSS</a>
-* <a href="https://fastapi.tiangolo.com/js/fastapi.js">FastAPI JS</a>
-
-Инструмент НЕ должен добавлять код языка в их URL.
-
-# Заголовок (с HTML ссылкой на <a href="https://tiangolo.com">tiangolo.com</a>) { #header-with-html-link-to-tiangolo-com }
-
-#Не заголовок
-
-```Python
-# Также не заголовок
-```
-
-Немного текста

scripts/tests/test_translation_fixer/test_complex_doc/test_compex_doc.py

@@ -1,30 +0,0 @@
-from pathlib import Path
-
-import pytest
-from typer.testing import CliRunner
-
-from scripts.translation_fixer import cli
-
-data_path = Path(
-    "scripts/tests/test_translation_fixer/test_complex_doc/data"
-).absolute()
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc.md")],
-    indirect=True,
-)
-def test_fix(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 0, result.output
-
-    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
-    assert "Fixing markdown links in" in result.output

scripts/tests/test_translation_fixer/test_header_permalinks/data/en_doc.md

@@ -1,19 +0,0 @@
-# Header 1 { #header-1 }
-
-Some text
-
-## Header 2 { #header-2 }
-
-Some more text
-
-### Header 3 { #header-3 }
-
-Even more text
-
-# Header 4 { #header-4 }
-
-A bit more text
-
-#Not a header
-
-Final portion of text

scripts/tests/test_translation_fixer/test_header_permalinks/data/translated_doc_level_mismatch_1.md

@@ -1,19 +0,0 @@
-# Header 1 { #header-1 }
-
-Some text
-
-# Header 2 { #header-2 }
-
-Some more text
-
-### Header 3 { #header-3 }
-
-Even more text
-
-# Header 4 { #header-4 }
-
-A bit more text
-
-#Not a header
-
-Final portion of text

scripts/tests/test_translation_fixer/test_header_permalinks/data/translated_doc_level_mismatch_2.md

@@ -1,19 +0,0 @@
-# Header 1 { #header-1 }
-
-Some text
-
-## Header 2 { #header-2 }
-
-Some more text
-
-### Header 3 { #header-3 }
-
-Even more text
-
-## Header 4 { #header-4 }
-
-A bit more text
-
-#Not a header
-
-Final portion of text

scripts/tests/test_translation_fixer/test_header_permalinks/data/translated_doc_number_gt.md

@@ -1,19 +0,0 @@
-# Header 1 { #header-1 }
-
-Some text
-
-## Header 2 { #header-2 }
-
-Some more text
-
-### Header 3 { #header-3 }
-
-Even more text
-
-# Header 4 { #header-4 }
-
-A bit more text
-
-# Extra header
-
-Final portion of text

scripts/tests/test_translation_fixer/test_header_permalinks/data/translated_doc_number_lt.md

@@ -1,19 +0,0 @@
-# Header 1 { #header-1 }
-
-Some text
-
-## Header 2 { #header-2 }
-
-Some more text
-
-### Header 3 { #header-3 }
-
-Even more text
-
-Header 4 is missing
-
-A bit more text
-
-#Not a header
-
-Final portion of text

scripts/tests/test_translation_fixer/test_header_permalinks/test_header_level_mismatch.py

@@ -1,60 +0,0 @@
-from pathlib import Path
-
-import pytest
-from typer.testing import CliRunner
-
-from scripts.translation_fixer import cli
-
-data_path = Path(
-    "scripts/tests/test_translation_fixer/test_header_permalinks/data"
-).absolute()
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_level_mismatch_1.md")],
-    indirect=True,
-)
-def test_level_mismatch_1(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1
-
-    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()
-
-    assert fixed_content == expected_content  # Translated doc remains unchanged
-    assert "Error processing docs/lang/docs/doc.md" in result.output
-    assert (
-        "Header levels do not match between document and original document"
-        " (found #, expected ##) for header №2 in line 5"
-    ) in result.output
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_level_mismatch_2.md")],
-    indirect=True,
-)
-def test_level_mismatch_2(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1
-
-    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()
-
-    assert fixed_content == expected_content  # Translated doc remains unchanged
-    assert "Error processing docs/lang/docs/doc.md" in result.output
-    assert (
-        "Header levels do not match between document and original document"
-        " (found ##, expected #) for header №4 in line 13"
-    ) in result.output

scripts/tests/test_translation_fixer/test_header_permalinks/test_header_number_mismatch.py

@@ -1,56 +0,0 @@
-from pathlib import Path
-
-import pytest
-from typer.testing import CliRunner
-
-from scripts.translation_fixer import cli
-
-data_path = Path(
-    "scripts/tests/test_translation_fixer/test_header_permalinks/data"
-).absolute()
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_gt.md")],
-    indirect=True,
-)
-def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1
-
-    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
-    assert (
-        "Number of headers with permalinks does not match the number "
-        "in the original document (5 vs 4)"
-    ) in result.output
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_lt.md")],
-    indirect=True,
-)
-def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1
-
-    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
-    assert (
-        "Number of headers with permalinks does not match the number "
-        "in the original document (3 vs 4)"
-    ) in result.output

scripts/tests/test_translation_fixer/test_html_links/data/en_doc.md

@@ -1,19 +0,0 @@
-# Header 1 { #header-1 }
-
-Some text with a link to <a href="https://fastapi.tiangolo.com">FastAPI</a>.
-
-## Header 2 { #header-2 }
-
-Two links here: <a href="https://fastapi.tiangolo.com/how-to/">How to</a> and <a href="project-generation.md" class="internal-link" target="_blank">Project Generators</a>.
-
-### Header 3 { #header-3 }
-
-Another link: <a href="project-generation.md" class="internal-link" target="_blank" title="Link title">**FastAPI** Project Generators</a> with title.
-
-# Header 4 { #header-4 }
-
-Link to anchor: <a href="#header-2">Header 2</a>
-
-# Header with <a href="http://example.com">link</a> { #header-with-link }
-
-Some text

scripts/tests/test_translation_fixer/test_html_links/data/translated_doc_number_gt.md

@@ -1,21 +0,0 @@
-# Заголовок 1 { #header-1 }
-
-Немного текста со ссылкой на <a href="https://fastapi.tiangolo.com">FastAPI</a>.
-
-## Заголовок 2 { #header-2 }
-
-Две ссылки здесь: <a href="https://fastapi.tiangolo.com/how-to/">How to</a> и <a href="project-generation.md" class="internal-link" target="_blank">Project Generators</a>.
-
-### Заголовок 3 { #header-3 }
-
-Ещё ссылка: <a href="project-generation.md" class="internal-link" target="_blank" title="Тайтл">**FastAPI** Генераторы Проектов</a> с тайтлом.
-
-И ещё одна <a href="https://github.com">экстра ссылка</a>.
-
-# Заголовок 4 { #header-4 }
-
-Ссылка на якорь: <a href="#header-2">Заголовок 2</a>
-
-# Заголовок со <a href="http://example.com">ссылкой</a> { #header-with-link }
-
-Немного текста

scripts/tests/test_translation_fixer/test_html_links/data/translated_doc_number_lt.md

@@ -1,19 +0,0 @@
-# Заголовок 1 { #header-1 }
-
-Немного текста со ссылкой на <a href="https://fastapi.tiangolo.com">FastAPI</a>.
-
-## Заголовок 2 { #header-2 }
-
-Две ссылки здесь: <a href="https://fastapi.tiangolo.com/how-to/">How to</a> и <a href="project-generation.md" class="internal-link" target="_blank">Project Generators</a>.
-
-### Заголовок 3 { #header-3 }
-
-Ещё ссылка: <a href="project-generation.md" class="internal-link" target="_blank" title="Тайтл">**FastAPI** Генераторы Проектов</a> с тайтлом.
-
-# Заголовок 4 { #header-4 }
-
-Ссылка на якорь: <a href="#header-2">Заголовок 2</a>
-
-# Заголовок с потерянной ссылкой { #header-with-link }
-
-Немного текста

scripts/tests/test_translation_fixer/test_html_links/test_html_links_number_mismatch.py

@@ -1,54 +0,0 @@
-from pathlib import Path
-
-import pytest
-from typer.testing import CliRunner
-
-from scripts.translation_fixer import cli
-
-data_path = Path("scripts/tests/test_translation_fixer/test_html_links/data").absolute()
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_gt.md")],
-    indirect=True,
-)
-def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1, result.output
-
-    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
-    assert (
-        "Number of HTML links does not match the number "
-        "in the original document (7 vs 6)"
-    ) in result.output
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_lt.md")],
-    indirect=True,
-)
-def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    # assert result.exit_code == 1, result.output
-
-    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
-    assert (
-        "Number of HTML links does not match the number "
-        "in the original document (5 vs 6)"
-    ) in result.output

scripts/tests/test_translation_fixer/test_markdown_links/data/en_doc.md

@@ -1,19 +0,0 @@
-# Header 1 { #header-1 }
-
-Some text with a link to [FastAPI](https://fastapi.tiangolo.com).
-
-## Header 2 { #header-2 }
-
-Two links here: [How to](https://fastapi.tiangolo.com/how-to/) and [Project Generators](project-generation.md){.internal-link target=_blank}.
-
-### Header 3 { #header-3 }
-
-Another link: [**FastAPI** Project Generators](project-generation.md "Link title"){.internal-link target=_blank} with title.
-
-# Header 4 { #header-4 }
-
-Link to anchor: [Header 2](#header-2)
-
-# Header with [link](http://example.com) { #header-with-link }
-
-Some text

scripts/tests/test_translation_fixer/test_markdown_links/data/translated_doc.md

@@ -1,19 +0,0 @@
-# Заголовок 1 { #header-1 }
-
-Немного текста со ссылкой на [FastAPI](https://fastapi.tiangolo.com).
-
-## Заголовок 2 { #header-2 }
-
-Две ссылки здесь: [How to](https://fastapi.tiangolo.com/how-to/) и [Project Generators](project-generation.md){.internal-link target=_blank}.
-
-### Заголовок 3 { #header-3 }
-
-Ещё ссылка: [**FastAPI** Генераторы Проектов](project-generation.md "Тайтл"){.internal-link target=_blank} с тайтлом.
-
-# Заголовок 4 { #header-4 }
-
-Ссылка на якорь: [Заголовок 2](#header-2)
-
-# Заголовок со [ссылкой](http://example.com) { #header-with-link }
-
-Немного текста

scripts/tests/test_translation_fixer/test_markdown_links/data/translated_doc_number_gt.md

@@ -1,21 +0,0 @@
-# Заголовок 1 { #header-1 }
-
-Немного текста со ссылкой на [FastAPI](https://fastapi.tiangolo.com).
-
-## Заголовок 2 { #header-2 }
-
-Две ссылки здесь: [How to](https://fastapi.tiangolo.com/how-to/) и [Project Generators](project-generation.md){.internal-link target=_blank}.
-
-### Заголовок 3 { #header-3 }
-
-Ещё ссылка: [**FastAPI** Генераторы Проектов](project-generation.md "Тайтл"){.internal-link target=_blank} с тайтлом.
-
-И ещё одна [экстра ссылка](https://github.com).
-
-# Заголовок 4 { #header-4 }
-
-Ссылка на якорь: [Заголовок 2](#header-2)
-
-# Заголовок со [ссылкой](http://example.com) { #header-with-link }
-
-Немного текста

scripts/tests/test_translation_fixer/test_markdown_links/data/translated_doc_number_lt.md

@@ -1,19 +0,0 @@
-# Заголовок 1 { #header-1 }
-
-Немного текста со ссылкой на [FastAPI](https://fastapi.tiangolo.com).
-
-## Заголовок 2 { #header-2 }
-
-Две ссылки здесь: [How to](https://fastapi.tiangolo.com/how-to/) и [Project Generators](project-generation.md){.internal-link target=_blank}.
-
-### Заголовок 3 { #header-3 }
-
-Ещё ссылка: [**FastAPI** Генераторы Проектов](project-generation.md "Тайтл"){.internal-link target=_blank} с тайтлом.
-
-# Заголовок 4 { #header-4 }
-
-Ссылка на якорь: [Заголовок 2](#header-2)
-
-# Заголовок с потерянной ссылкой { #header-with-link }
-
-Немного текста

scripts/tests/test_translation_fixer/test_markdown_links/test_mkd_links_number_mismatch.py

@@ -1,56 +0,0 @@
-from pathlib import Path
-
-import pytest
-from typer.testing import CliRunner
-
-from scripts.translation_fixer import cli
-
-data_path = Path(
-    "scripts/tests/test_translation_fixer/test_markdown_links/data"
-).absolute()
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_gt.md")],
-    indirect=True,
-)
-def test_gt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    assert result.exit_code == 1, result.output
-
-    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
-    assert (
-        "Number of markdown links does not match the number "
-        "in the original document (7 vs 6)"
-    ) in result.output
-
-
-@pytest.mark.parametrize(
-    "copy_test_files",
-    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_lt.md")],
-    indirect=True,
-)
-def test_lt(runner: CliRunner, root_dir: Path, copy_test_files):
-    result = runner.invoke(
-        cli,
-        ["fix-pages", "docs/lang/docs/doc.md"],
-    )
-    # assert result.exit_code == 1, result.output
-
-    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
-    assert (
-        "Number of markdown links does not match the number "
-        "in the original document (5 vs 6)"
-    ) in result.output

scripts/translate.py

@@ -10,7 +10,6 @@ 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
@@ -120,27 +119,9 @@ def translate_page(
         ]
     )
     prompt = "\n\n".join(prompt_segments)
-
-    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"Running agent for {out_path}")
+    result = agent.run_sync(prompt)
+    out_content = f"{result.output.strip()}\n"
     print(f"Saving translation to {out_path}")
     out_path.write_text(out_content, encoding="utf-8", newline="\n")
 

scripts/translation_fixer.py

@@ -1,132 +0,0 @@
-import os
-from collections.abc import Iterable
-from pathlib import Path
-from typing import Annotated
-
-import typer
-
-from scripts.doc_parsing_utils import check_translation
-
-non_translated_sections = (
-    f"reference{os.sep}",
-    "release-notes.md",
-    "fastapi-people.md",
-    "external-links.md",
-    "newsletter.md",
-    "management-tasks.md",
-    "management.md",
-    "contributing.md",
-)
-
-
-cli = typer.Typer()
-
-
-@cli.callback()
-def callback():
-    pass
-
-
-def iter_all_lang_paths(lang_path_root: Path) -> Iterable[Path]:
-    """
-    Iterate on the markdown files to translate in order of priority.
-    """
-
-    first_dirs = [
-        lang_path_root / "learn",
-        lang_path_root / "tutorial",
-        lang_path_root / "advanced",
-        lang_path_root / "about",
-        lang_path_root / "how-to",
-    ]
-    first_parent = lang_path_root
-    yield from first_parent.glob("*.md")
-    for dir_path in first_dirs:
-        yield from dir_path.rglob("*.md")
-    first_dirs_str = tuple(str(d) for d in first_dirs)
-    for path in lang_path_root.rglob("*.md"):
-        if str(path).startswith(first_dirs_str):
-            continue
-        if path.parent == first_parent:
-            continue
-        yield path
-
-
-def get_all_paths(lang: str):
-    res: list[str] = []
-    lang_docs_root = Path("docs") / lang / "docs"
-    for path in iter_all_lang_paths(lang_docs_root):
-        relpath = path.relative_to(lang_docs_root)
-        if not str(relpath).startswith(non_translated_sections):
-            res.append(str(relpath))
-    return res
-
-
-def process_one_page(path: Path) -> bool:
-    """
-    Fix one translated document by comparing it to the English version.
-
-    Returns True if processed successfully, False otherwise.
-    """
-
-    try:
-        lang_code = path.parts[1]
-        if lang_code == "en":
-            print(f"Skipping English document: {path}")
-            return True
-
-        en_doc_path = Path("docs") / "en" / Path(*path.parts[2:])
-
-        doc_lines = path.read_text(encoding="utf-8").splitlines()
-        en_doc_lines = en_doc_path.read_text(encoding="utf-8").splitlines()
-
-        doc_lines = check_translation(
-            doc_lines=doc_lines,
-            en_doc_lines=en_doc_lines,
-            lang_code=lang_code,
-            auto_fix=True,
-            path=str(path),
-        )
-
-        # Write back the fixed document
-        doc_lines.append("")  # Ensure file ends with a newline
-        path.write_text("\n".join(doc_lines), encoding="utf-8")
-
-    except ValueError as e:
-        print(f"Error processing {path}: {e}")
-        return False
-    return True
-
-
-@cli.command()
-def fix_all(ctx: typer.Context, language: str):
-    docs = get_all_paths(language)
-
-    all_good = True
-    for page in docs:
-        doc_path = Path("docs") / language / "docs" / page
-        res = process_one_page(doc_path)
-        all_good = all_good and res
-
-    if not all_good:
-        raise typer.Exit(code=1)
-
-
-@cli.command()
-def fix_pages(
-    doc_paths: Annotated[
-        list[Path],
-        typer.Argument(help="List of paths to documents."),
-    ],
-):
-    all_good = True
-    for path in doc_paths:
-        res = process_one_page(path)
-        all_good = all_good and res
-
-    if not all_good:
-        raise typer.Exit(code=1)
-
-
-if __name__ == "__main__":
-    cli()