From 273b06adab5fd527492ff9ed3f98cfa653d10002 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Jul 2025 23:27:35 +0200
Subject: [PATCH] =?UTF-8?q?=E2=9A=92=EF=B8=8F=20Update=20translate=20scrip?=
 =?UTF-8?q?t,=20show=20and=20update=20outdated=20translations=20(#13933)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 requirements-translations.txt |  1 +
 scripts/translate.py          | 35 +++++++++++++++++++++++++++++++++++
 2 files changed, 36 insertions(+)

diff --git a/requirements-translations.txt b/requirements-translations.txt
index 7a2a8004e..90f718032 100644
--- a/requirements-translations.txt
+++ b/requirements-translations.txt
@@ -1 +1,2 @@
 pydantic-ai==0.0.30
+GitPython==3.1.45
diff --git a/scripts/translate.py b/scripts/translate.py
index 6af12dc98..b78d7211b 100644
--- a/scripts/translate.py
+++ b/scripts/translate.py
@@ -2,6 +2,7 @@ from functools import lru_cache
 from pathlib import Path
 from typing import Iterable
 
+import git
 import typer
 import yaml
 from pydantic_ai import Agent
@@ -243,5 +244,39 @@ def remove_all_removable() -> None:
     print("Done removing all removable paths")
 
 
+@app.command()
+def list_outdated(lang: str) -> list[Path]:
+    dir_path = Path(__file__).absolute().parent.parent
+    repo = git.Repo(dir_path)
+
+    outdated_paths: list[Path] = []
+    en_lang_paths = list(iter_en_paths_to_translate())
+    for path in en_lang_paths:
+        lang_path = generate_lang_path(lang=lang, path=path)
+        if not lang_path.exists():
+            outdated_paths.append(path)
+            continue
+        en_commit_datetime = list(repo.iter_commits(paths=path, max_count=1))[
+            0
+        ].committed_datetime
+        lang_commit_datetime = list(repo.iter_commits(paths=lang_path, max_count=1))[
+            0
+        ].committed_datetime
+        if lang_commit_datetime < en_commit_datetime:
+            outdated_paths.append(path)
+    print(outdated_paths)
+    return outdated_paths
+
+
+@app.command()
+def update_outdated(lang: str) -> None:
+    outdated_paths = list_outdated(lang)
+    for path in outdated_paths:
+        print(f"Updating lang: {lang} path: {path}")
+        translate_page(lang=lang, path=path)
+        print(f"Done updating: {path}")
+    print("Done updating all outdated paths")
+
+
 if __name__ == "__main__":
     app()