Build status

Author: m-aciek

build_status.py

@@ -0,0 +1,37 @@
+"""
+Fetch build status of languages in the https://docs.python.org.
+
+Yield a tuple of language code and a Boolean indicating
+whether it is in the language switcher.
+"""
+
+import tomllib
+from collections.abc import Generator
+
+import requests
+
+
+def get_languages() -> Generator[tuple[str, str]]:
+    data = requests.get(
+        'https://raw.githubusercontent.com/'
+        'python/docsbuild-scripts/refs/heads/main/config.toml',
+        timeout=10,
+    ).text
+    config = tomllib.loads(data)
+    languages = config['languages']
+    defaults = config['defaults']
+    for code, language in languages.items():
+        language_code = code.lower().replace('_', '-')
+        switcher = language.get('in_prod', defaults['in_prod'])
+        yield language_code, switcher
+
+
+def main() -> None:
+    languages = {language: switcher for language, switcher in get_languages()}
+    print(languages)
+    for code in ('en', 'pl', 'ar', 'zh-cn', 'id'):
+        print(f'{code}: {code in languages and languages[code]}')
+
+
+if __name__ == '__main__':
+    main()

generate.py

@@ -17,7 +17,7 @@
 from jinja2 import Template
 
 import repositories
-import switcher
+import build_status
 import visitors
 from completion import branches_from_devguide, get_completion
 
@@ -41,7 +41,7 @@
     subprocess.run(
         ['make', '-C', Path(clones_dir, 'cpython/Doc'), 'gettext'], check=True
     )
-    switcher_languages = list(switcher.get_languages())
+    switcher_languages = {language: switcher for language, switcher in build_status.get_languages()}
     for language, repo in repositories.get_languages_and_repos(devguide_dir):
         if repo:
             completion_number, translators_number = get_completion(clones_dir, repo)
@@ -56,6 +56,7 @@
                 translators_number,
                 visitors_number,
                 language in switcher_languages,
+                switcher_languages.get(language),
             )
         )
         print(completion_progress[-1])
@@ -80,7 +81,7 @@
 </tr>
 </thead>
 <tbody>
-{% for language, repo, completion, translators, visitors, in_switcher in completion_progress | sort(attribute='2,3') | reverse %}
+{% for language, repo, completion, translators, visitors, build, in_switcher in completion_progress | sort(attribute='2,3') | reverse %}
 <tr>
   {% if repo %}
   <td data-label="language">
@@ -92,8 +93,8 @@
   <td data-label="language">{{ language }}</td>
   {% endif %}
   <td data-label="build">
-    {% if in_switcher %}
-      <a href="https://docs.python.org/{{ language }}/">in switcher</a>
+    {% if build %}
+      <a href="https://docs.python.org/{{ language }}/" target="_blank">✓{% if switcher %}in switcher{% endif %}</a>
     {% else %}
       ✗
     {% endif %}