Clean up Lint

python · StanFromIreland · Jan 30, 2025 · Jan 30, 2025 · Jan 30, 2025 · Jan 30, 2025
commit 1a95fb618c0823bed5e8670ead72825bed181006
@@ -1,13 +1,13 @@
 """Support for documenting platform availability"""
 
 from __future__ import annotations
 from docutils import nodes
+from sphinx import addnodes
 from sphinx.util import logging
 from sphinx.util.docutils import SphinxDirective
 
 
 class Availability(SphinxDirective):
-
     has_content = True
     required_arguments = 1
     optional_arguments = 0
@@ -42,10 +42,14 @@
 
     def parse_platforms(self):
         """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.
         """
@@ -65,16 +69,16 @@
            cls = type(self)
            logger = logging.getLogger(cls.__qualname__)
            logger.warning(
                f"Unknown platform(s) or syntax '{' '.join(sorted(unknown))}' "
                f"in '.. availability:: {self.arguments[0]}', see "
                f"{__file__}:{cls.__qualname__}.known_platforms for a set "
                "known platforms."
            )

        return platforms


 def setup(app: Sphinx) -> ExtensionMetadata:
    app.add_directive("availability", Availability)

    return {