FIX: Doc build

doc/sphinxext/related_software.py

@@ -173,6 +173,7 @@ def _get_packages() -> dict[str, str]:
     packages = sorted(packages, key=lambda x: x.lower())
     packages = [RENAMES.get(package, package) for package in packages]
     out = dict()
+    reasons = []
     for package in status_iterator(
         packages, f"Adding {len(packages)} related software packages: "
     ):
@@ -183,12 +184,17 @@ def _get_packages() -> dict[str, str]:
             else:
                 md = importlib.metadata.metadata(package)
         except importlib.metadata.PackageNotFoundError:
-            pass  # raise a complete error later
+            reasons.append(f"{package}: not found, needs to be installed")
+            continue  # raise a complete error later
         else:
             # Every project should really have this
+            do_continue = False
             for key in ("Summary",):
                 if key not in md:
-                    raise ExtensionError(f"Missing {repr(key)} for {package}")
+                    reasons.extend(f"{package}: missing {repr(key)}")
+                    do_continue = True
+            if do_continue:
+                continue
             # It is annoying to find the home page
             url = None
             if "Home-page" in md:
@@ -204,15 +210,17 @@ def _get_packages() -> dict[str, str]:
                     if url is not None:
                         break
                 else:
-                    raise RuntimeError(
-                        f"Could not find Home-page for {package} in:\n"
-                        f"{sorted(set(md))}\nwith Summary:\n{md['Summary']}"
+                    reasons.append(
+                        f"{package}: could not find Home-page in {sorted(md)}"
                     )
+                    continue
             out[package]["url"] = url
             out[package]["description"] = md["Summary"].replace("\n", "")
-    bad = [package for package in packages if not out[package]]
-    if bad and REQUIRE_METADATA:
-        raise ExtensionError(f"Could not find metadata for:\n{' '.join(bad)}")
+    reason_str = "\n".join(reasons)
+    if reason_str and REQUIRE_METADATA:
+        raise ExtensionError(
+            f"Could not find suitable metadata for related software:\n{reason_str}"
+        )
 
     return out