Add language names

Author: m-aciek

generate.py

@@ -30,6 +30,7 @@
 def get_completion_progress() -> (
     Iterator[
         tuple[
+            str,
             str,
             str,
             float,
@@ -63,14 +64,15 @@ def get_completion_progress() -> (
             ['make', '-C', Path(clones_dir, 'cpython/Doc'), 'gettext'], check=True
         )
         languages_built = dict(build_status.get_languages())
-        for lang, repo in repositories.get_languages_and_repos(devguide_dir):
+        for lang, lang_name, repo in repositories.get_languages_and_repos(devguide_dir):
             built = lang in languages_built
             in_switcher = languages_built.get(lang)
             tx = lang in contribute.pulling_from_transifex
             contrib_link = contribute.get_contrib_link(lang)
             if not repo:
                 yield (
                     lang,
+                    lang_name,
                     cast(str, repo),
                     0.0,
                     0,
@@ -86,6 +88,7 @@ def get_completion_progress() -> (
             visitors_num = visitors.get_number_of_visitors(lang) if built else 0
             yield (
                 lang,
+                lang_name,
                 repo,
                 completion,
                 translators,

repositories.py

@@ -1,24 +1,36 @@
 import re
 from collections.abc import Iterator
 from pathlib import Path
+from tempfile import TemporaryDirectory
 
 from docutils import core
 from docutils.nodes import table, row
+from git import Repo
 
 
-def get_languages_and_repos(devguide_dir: Path) -> Iterator[tuple[str, str | None]]:
+def get_languages_and_repos(
+    devguide_dir: Path,
+) -> Iterator[tuple[str, str, str | None]]:
     translating = devguide_dir.joinpath('documentation/translating.rst').read_text()
     doctree = core.publish_doctree(translating)
 
     for node in doctree.traverse(table):
         for row_node in node.traverse(row)[1:]:
             language = row_node[0].astext()
             repo = row_node[2].astext()
-            language_match = re.match(r'.* \((.*)\)', language)
+            language_match = re.match(r'(.*) \((.*)\)', language)
             if not language_match:
                 raise ValueError(
                     f'Expected a language code in brackets in devguide table, found {language}'
                 )
-            language_code = language_match.group(1).lower().replace('_', '-')
+            language_name = language_match.group(1)
+            language_code = language_match.group(2).lower().replace('_', '-')
             repo_match = re.match(':github:`GitHub <(.*)>`', repo)
-            yield language_code, repo_match and repo_match.group(1)
+            yield language_code, language_name, repo_match and repo_match.group(1)
+
+
+if __name__ == '__main__':
+    with TemporaryDirectory() as directory:
+        Repo.clone_from('https://github.com/python/devguide.git', directory, depth=1)
+        for item in get_languages_and_repos(Path(directory)):
+            print(item)

template.html.jinja

@@ -17,12 +17,12 @@
 </tr>
 </thead>
 <tbody>
-{% for language, repo, completion, translators, translators_link, visitors, build, in_switcher, on_platform, contrib_link in completion_progress | sort(attribute='2,3') | reverse %}
+{% for language, language_name, repo, completion, translators, translators_link, visitors, build, in_switcher, on_platform, contrib_link in completion_progress | sort(attribute='2,3') | reverse %}
 <tr>
   {% if repo %}
   <td data-label="language">
     <a href="https://github.com/{{ repo }}" target="_blank">
-      {{ language }}
+      {{ language_name }} ({{ language }})
     </a>
   </td>
   {% else %}