imprv: Generator: Add deprecations

Author: matperc

tools/generate.py

@@ -339,9 +339,9 @@ def _build(parent: ObjectT, namespace: str, overrides: dict[str, str]) -> str:
     typings = "from typing import Any, Callable, Literal, Optional, Tuple, Type, TypeVar, Sequence"
 
     typevars: list[str] = []
-    imports: list[str] = []
+    imports: list[str] = ["from typing_extensions import deprecated"]
     if "cairo" in ns:
-        imports = ["import cairo"]
+        imports += ["import cairo"]
         typevars.append('_SomeSurface = TypeVar("_SomeSurface", bound=cairo.Surface)')
         ns.remove("cairo")
 
@@ -368,7 +368,7 @@ def _generate_full_name(prefix: str, name: str) -> str:
 def _build_function_info(
     current_namespace: str,
     name: str,
-    function: (GI.FunctionInfo | GI.VFuncInfo),
+    function: GI.FunctionInfo | GI.VFuncInfo,
     in_class: Optional[Any],
     needed_namespaces: set[str],
     return_signature: Optional[str] = None,
@@ -601,6 +601,14 @@ def _gi_build_stub(
 
     # Functions
     for name in sorted(functions):
+        if hasattr(functions[name], "is_deprecated"):
+            deprecated = functions[name].is_deprecated()
+            if deprecated:
+                if in_class:
+                    ret += "@deprecated('This method is deprecated')\n"
+                else:
+                    ret += "@deprecated('This function is deprecated')\n"
+
         override = _check_override(prefix_name, name, overrides)
         if override:
             ret += override + "\n"
@@ -615,6 +623,11 @@ def _gi_build_stub(
 
     # Classes
     for name, obj in sorted(classes.items()):
+        if hasattr(obj, "__info__") and hasattr(obj.__info__, "is_deprecated"):
+            deprecated = obj.__info__.is_deprecated()
+            if deprecated:
+                ret += "@deprecated('This class is deprecated')\n"
+
         override = _check_override(prefix_name, name, overrides)
         if override:
             ret += override + "\n\n"