Merge branch 'main' into check-against-latest

# Conflicts:
#	completion.py

Author: m-aciek

completion.py

@@ -1,14 +1,28 @@
-import shutil
+from functools import cache
 from pathlib import Path
 from tempfile import TemporaryDirectory
 
 import git
 from potodo import potodo
+import requests
+
+@cache
+def branches_from_devguide() -> list[str]:
+    r = requests.get(
+        "https://raw.githubusercontent.com/"
+        "python/devguide/main/include/release-cycle.json",
+        timeout=10,
+    )
+    data = r.json()
+    return [
+        branch for branch in data if data[branch]["status"] in ("bugfix", "security")
+    ]
 
 
 def get_completion(clones_dir: str, language: str) -> float:
     clone_path = Path(clones_dir, language)
-    for branch in ('3.13', '3.12', '3.11', '3.10', '3.9'):
+
+    for branch in branches_from_devguide():
         try:
             git.Repo.clone_from(
                 f'https://github.com/python/python-docs-{language}.git', clone_path, depth=1, branch=branch

generate.py

@@ -14,18 +14,20 @@
 from git import Repo
 from jinja2 import Template
 
-import completion
 import visitors
+from completion import branches_from_devguide, get_completion
 
 completion_progress = []
 generation_time = datetime.now(timezone.utc)
 
 with TemporaryDirectory() as clones_dir:
-    Repo.clone_from(f'https://github.com/python/cpython.git', Path(clones_dir, 'cpython'), depth=1, branch='3.13')
+    Repo.clone_from(
+        f'https://github.com/python/cpython.git', Path(clones_dir, 'cpython'), depth=1, branch=branches_from_devguide()[0]
+    )
     subprocess.run(['make', '-C', Path(clones_dir, 'cpython/Doc'), 'venv'], check=True)
     subprocess.run(['make', '-C', Path(clones_dir, 'cpython/Doc'), 'gettext'], check=True)
     for language in ('es', 'fr', 'id', 'it', 'ja', 'ko', 'pl', 'pt-br', 'tr', 'uk', 'zh-cn', 'zh-tw'):
-        completion_number = completion.get_completion(clones_dir, language)
+        completion_number = get_completion(clones_dir, language)
         visitors_number = visitors.get_number_of_visitors(language)
         completion_progress.append((language, completion_number, visitors_number))
         print(completion_progress[-1])
@@ -55,7 +57,7 @@
     </a>
   </td>
   <td data-label="visitors">
-    <a href="https://https://plausible.io/docs.python.org?filters=((contains,page,(/{{ language }}/)))" target="_blank">
+    <a href="https://plausible.io/docs.python.org?filters=((contains,page,(/{{ language }}/)))" target="_blank">
       {{ '{:,}'.format(visitors) }}
     </a>
   </td>