Revert "add an extension for indicating library requirements"

This reverts commit 6df1740.

Author: picnixz

Doc/conf.py

@@ -35,7 +35,6 @@
     'misc_news',
     'pydoc_topics',
     'pyspecific',
-    'requirements',
     'sphinx.ext.coverage',
     'sphinx.ext.doctest',
     'sphinx.ext.extlinks',

Doc/tools/extensions/__init__.py

@@ -4,8 +4,11 @@
 
 from typing import TYPE_CHECKING
 
+from docutils import nodes
+from sphinx import addnodes
+from sphinx.locale import _ as sphinx_gettext
 from sphinx.util import logging
-from support import SmartItemList
+from sphinx.util.docutils import SphinxDirective
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -46,33 +49,71 @@
 KNOWN_PLATFORMS = _PLATFORMS | _LIBC | _THREADING
 
 
-class Availability(SmartItemList):
-    """Parse platform information from arguments
-
-    Arguments is a comma-separated string of platforms. A platform may
-    be prefixed with "not " to indicate that a feature is not available.
-
-    Example::
-
-       .. availability:: Windows, Linux >= 4.2, not WASI
-
-    Arguments like "Linux >= 3.17 with glibc >= 2.27" are currently not
-    parsed into separate tokens.
-    """
-
-    title = "Availability"
-    reftarget = "availability"
-    classes = ["availability"]
-
-    def check_information(self, platforms: dict[str, str | bool], /) -> None:
-        unknown = platforms.keys() - KNOWN_PLATFORMS
-        self._check_information(
-            logger,
-            f"{__file__}:KNOWN_PLATFORMS",
-            unknown,
-            ("platform", "platforms"),
-            len(platforms),
+class Availability(SphinxDirective):
+    has_content = True
+    required_arguments = 1
+    optional_arguments = 0
+    final_argument_whitespace = True
+
+    def run(self) -> list[nodes.container]:
+        title = sphinx_gettext("Availability")
+        refnode = addnodes.pending_xref(
+            title,
+            nodes.inline(title, title, classes=["xref", "std", "std-ref"]),
+            refdoc=self.env.docname,
+            refdomain="std",
+            refexplicit=True,
+            reftarget="availability",
+            reftype="ref",
+            refwarn=True,
         )
+        sep = nodes.Text(": ")
+        parsed, msgs = self.state.inline_text(self.arguments[0], 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]
+
+    def parse_platforms(self) -> dict[str, str | bool]:
+        """Parse platform information from arguments
+
+        Arguments is a comma-separated string of platforms. A platform may
+        be prefixed with "not " to indicate that a feature is not available.
+
+        Example::
+
+           .. availability:: Windows, Linux >= 4.2, not WASI
+
+        Arguments like "Linux >= 3.17 with glibc >= 2.27" are currently not
+        parsed into separate tokens.
+        """
+        platforms = {}
+        for arg in self.arguments[0].rstrip(".").split(","):
+            arg = arg.strip()
+            platform, _, version = arg.partition(" >= ")
+            if platform.startswith("not "):
+                version = False
+                platform = platform.removeprefix("not ")
+            elif not version:
+                version = True
+            platforms[platform] = version
+
+        if unknown := set(platforms).difference(KNOWN_PLATFORMS):
+            logger.warning(
+                "Unknown platform%s or syntax '%s' in '.. availability:: %s', "
+                "see %s:KNOWN_PLATFORMS for a set of known platforms.",
+                "s" if len(platforms) != 1 else "",
+                " ".join(sorted(unknown)),
+                self.arguments[0],
+                __file__,
+            )
+
+        return platforms
 
 
 def setup(app: Sphinx) -> ExtensionMetadata: