docs: Add support for multiple versions of a client

docs/ext/capabilities.py

@@ -3,13 +3,16 @@
 import pathlib
 import re
 import typing
+from typing import Dict
 from typing import List
+from typing import Optional
 
 import attrs
 from docutils import nodes
 from docutils.parsers.rst import directives
 from lsprotocol import types
 from lsprotocol.converters import get_converter
+from packaging.version import parse as parse_version
 from pygls.capabilities import get_capability
 from sphinx.application import Sphinx
 from sphinx.domains import Domain
@@ -37,19 +40,39 @@ def build_header(self):
 
         return header, colspecs
 
-    def build_body(self, capability: str):
-        rows = []
+    def get_client_support_for(self, capability: str) -> Dict[str, Optional[str]]:
+        """Build a dictionary containing the clients that support the given capability
+        as well as the version that support was introduced in."""
         domain = self.env.domains["capabilities"]
 
+        clients: Dict[str, Optional[str]] = {}
         for (name, version), capabilities in domain.clients.items():
             supported = get_capability(capabilities, capability, False)
+
+            if not supported:
+                if name not in clients:
+                    clients[name] = None
+                continue
+
+            if (existing := clients.get(name, None)) is None:
+                clients[name] = version
+            else:
+                clients[name] = min(existing, version, key=parse_version)
+
+        return clients
+
+    def build_body(self, capability: str):
+        rows = []
+        clients = self.get_client_support_for(capability)
+
+        for name, version in clients.items():
             rows.append(
                 nodes.row(
                     "",
                     nodes.entry("", nodes.Text(name)),
                     nodes.entry(
                         "",
-                        nodes.Text(version if supported else " - "),
+                        nodes.Text(version or " - "),
                         classes=["centered"],
                     ),
                 )

docs/ext/supported_clients.py

@@ -2,6 +2,7 @@
 
 from docutils import nodes
 from docutils.parsers.rst import Directive
+from packaging.version import parse as parse_version
 from sphinx.application import Sphinx
 
 
@@ -26,6 +27,7 @@ def run(self):
         clients = self.load_clients()
 
         for client, versions in clients.items():
+            version_string = ", ".join(sorted(versions, key=parse_version))
             rows.append(
                 nodes.row(
                     "",
@@ -35,7 +37,7 @@ def run(self):
                     ),
                     nodes.entry(
                         "",
-                        nodes.paragraph("", ", ".join(versions)),
+                        nodes.paragraph("", version_string),
                     ),
                 ),
             )