Docs: allow translation of a phrase in availability directive

Author: m-aciek

Doc/tools/extensions/availability.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from itertools import starmap
 from typing import TYPE_CHECKING
 
 from docutils import nodes
@@ -11,6 +12,8 @@
 from sphinx.util.docutils import SphinxDirective
 
 if TYPE_CHECKING:
+    from collections.abc import Callable
+
     from sphinx.application import Sphinx
     from sphinx.util.typing import ExtensionMetadata
 
@@ -49,6 +52,16 @@
 KNOWN_PLATFORMS = _PLATFORMS | _LIBC | _THREADING
 
 
+def _print_platform(
+    platform: str, version: str | bool
+) -> str | Callable[[str], str]:
+    if version is True:
+        return platform
+    if not version:
+        return sphinx_gettext("not {platform}").format(platform=platform)
+    return f"{platform} >= {version}"
+
+
 class Availability(SphinxDirective):
     has_content = True
     required_arguments = 1
@@ -68,14 +81,17 @@ def run(self) -> list[nodes.container]:
             refwarn=True,
         )
         sep = nodes.Text(": ")
-        parsed, msgs = self.state.inline_text(self.arguments[0], self.lineno)
+        platforms = self.parse_platforms()
+        platforms_text = (
+            f"{', '.join(starmap(_print_platform, platforms.items()))}."
+        )
+        parsed, msgs = self.state.inline_text(platforms_text, self.lineno)
         pnode = nodes.paragraph(title, "", refnode, sep, *parsed, *msgs)
         self.set_source_info(pnode)
         cnode = nodes.container("", pnode, classes=["availability"])
         self.set_source_info(cnode)
         if self.content:
             self.state.nested_parse(self.content, self.content_offset, cnode)
-        self.parse_platforms()
 
         return [cnode]
 

Doc/tools/templates/dummy.html

@@ -10,6 +10,7 @@
 In extensions/availability.py:
 
 {% trans %}Availability{% endtrans %}
+{% trans %}not {platform}{% endtrans %}
 
 In extensions/c_annotations.py: