Move deprecated handling to field metadata

Signed-off-by: Cristian Le <[email protected]>

Author: LecrisUT

src/scikit_build_core/settings/documentation.py

@@ -54,6 +54,7 @@ class DCDoc:
     name: str
     default: str
     docs: str
+    deprecated: bool = False
 
     def __str__(self) -> str:
         docs = "\n".join(f"# {s}" for s in textwrap.wrap(self.docs, width=78))
@@ -107,4 +108,5 @@ def mk_docs(dc: type[object], prefix: str = "") -> Generator[DCDoc, None, None]:
             name=f"{prefix}{field.name}".replace("_", "-"),
             default=sanitize_default_field(default),
             docs=docs[field.name],
+            deprecated=get_metadata_field(field, "deprecated", False),  # noqa: FBT003
         )

src/scikit_build_core/settings/skbuild_docs.py

@@ -13,14 +13,12 @@ def __dir__() -> list[str]:
 
 version = ".".join(__version__.split(".")[:2])
 
-INV = {"cmake.minimum-version", "ninja.minimum-version"}
-
 
 def mk_skbuild_docs() -> str:
     """
     Makes documentation for the skbuild model.
     """
-    items = [x for x in mk_docs(ScikitBuildSettings) if x.name not in INV]
+    items = [x for x in mk_docs(ScikitBuildSettings) if not x.deprecated]
     for item in items:
         if item.name == "minimum-version":
             item.default = f'"{version}"  # current version'

src/scikit_build_core/settings/skbuild_model.py

@@ -36,6 +36,8 @@ class SettingsFieldMetadata(Mapping[str, Any]):
     Convenience dataclass to store field metadata for documentation.
     """
 
+    deprecated: bool = False
+
     def __getitem__(self, key: str) -> Any:
         return getattr(self, key)
 
@@ -71,7 +73,9 @@ def escape_semicolons(item: str) -> str:
 
 @dataclasses.dataclass
 class CMakeSettings:
-    minimum_version: Optional[Version] = None
+    minimum_version: Optional[Version] = dataclasses.field(
+        default=None, metadata=SettingsFieldMetadata(deprecated=True)
+    )
     """
     DEPRECATED in 0.8; use version instead.
     """
@@ -132,7 +136,9 @@ class SearchSettings:
 
 @dataclasses.dataclass
 class NinjaSettings:
-    minimum_version: Optional[Version] = None
+    minimum_version: Optional[Version] = dataclasses.field(
+        default=None, metadata=SettingsFieldMetadata(deprecated=True)
+    )
     """
     DEPRECATED in 0.8; use version instead.
     """