Merge branch 'develop' into m/core-604/add_or_update_ds

docs/sphinx_api_docs_source/include_exclude_definition.py

@@ -31,3 +31,5 @@ def __post_init__(self):
             raise ValueError(  # noqa: TRY003
                 "You must provide at least a filepath or filepath and name."
             )
+        if self.filepath and not self.filepath.exists():
+            raise FileNotFoundError(f"File {self.filepath} does not exist.")  # noqa: TRY003

docs/sphinx_api_docs_source/printable_definition.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+import pathlib
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class PrintableDefinition:
+    file: pathlib.Path
+    name: str
+
+    def __post_init__(self):
+        if not self.file.exists():
+            raise FileNotFoundError(f"File {self.file} does not exist.")  # noqa: TRY003
+
+    def __str__(self) -> str:  # type: ignore[explicit-override]
+        return f"File: {self.file} Name: {self.name}"
+
+    def __lt__(self, other) -> bool:
+        return str(self) < str(other)