Add little function to detect unconnected COMs and ENUMs

Author: lord-haffi

docs/test_uml.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 
-from docs.uml import PlantUMLNetwork, build_network
+from docs.uml import PlantUMLNetwork, build_network, get_unconnected_coms_and_enums
 
 
 def test_network_build() -> None:
@@ -10,3 +10,5 @@ def test_network_build() -> None:
     project_root_dir = Path(__file__).parent.parent
     module_dir = project_root_dir / "src/bo4e"
     _network, _namespaces_to_parse = build_network(module_dir, PlantUMLNetwork)
+    unconnected_els = get_unconnected_coms_and_enums(_network)
+    print(unconnected_els)

docs/uml.py

@@ -14,6 +14,7 @@
 import shlex
 import subprocess
 from abc import ABCMeta, abstractmethod
+from copy import copy
 from pathlib import Path
 from types import NoneType
 from typing import Any, Dict, List, Optional, Tuple, Type, Union, cast, get_args
@@ -594,3 +595,16 @@ def compile_files_plantuml(input_dir: Path, output_dir: Path, executable: Path)
     """
     command = f'java -jar "{executable}" "{input_dir}" -svg -o "{output_dir}"'
     subprocess.call(shlex.split(command))
+
+
+def get_unconnected_coms_and_enums(graph: _UMLNetworkABC) -> set[str]:
+    """
+    Detects all COMs and ENUMs which are not reachable from any BO inside the `graph`.
+    """
+    all_nodes = set(graph.nodes)
+    all_bos = set(filter(lambda modl_namespace: modl_namespace.startswith("bo4e.bo"), all_nodes))
+    connected_nodes = copy(all_bos)
+    for bo in all_bos:
+        connected_nodes |= set(nx.descendants(graph, bo))
+
+    return all_nodes - connected_nodes