[gi-docgen/property-annotations: 3/3] generate: Prefer GIR annotations to gi-docgen attributes

[Emmanuele Bassi <ebassi src gnome org>]

commit 7471570603bfe4efb7631a062399a3a190ad39d8
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Sat Sep 25 17:52:38 2021 +0100

    generate: Prefer GIR annotations to gi-docgen attributes
    
    Starting from gobject-introspection 1.70, the GIR data now contains
    annotations that replace the special gi-docgen attributes when it comes
    to linking properties and their accessors.
    
    These new attributes are validated by the introspection generator, so we
    can simplify the code that generates the links.

 gidocgen/gdgenerate.py | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
---
diff --git a/gidocgen/gdgenerate.py b/gidocgen/gdgenerate.py
index f57107b..8f21f50 100644
--- a/gidocgen/gdgenerate.py
+++ b/gidocgen/gdgenerate.py
@@ -458,6 +458,23 @@ class TemplateProperty:
                     self.attributes[label] = transform(namespace, prop, value)
             else:
                 self.attributes[name] = value
+
+        def gen_method_link(ns, t, method):
+            for m in t.methods:
+                if m.name == method:
+                    href = f"method.{t.name}.{m.name}.html"
+                    return Markup(f'<a href="{href}"><code>{m.identifier}()</code></a>')
+            return None
+
+        if prop.setter is not None:
+            link = gen_method_link(namespace, type_, prop.setter)
+            if link is not None:
+                self.attributes["Setter method"] = link
+        if prop.getter is not None:
+            link = gen_method_link(namespace, type_, prop.getter)
+            if link is not None:
+                self.attributes["Getter method"] = link
+
         if self.type_name is not None:
             name = self.type_name
             if '.' in name:
@@ -787,6 +804,24 @@ class TemplateMethod:
             else:
                 self.attributes[name] = value
 
+        def gen_property_link(namespace, t, prop_name):
+            if prop_name not in t.properties:
+                return None
+            prop = t.properties[prop_name]
+            text = f"{namespace.name}.{t.name}:{prop.name}"
+            href = f"property.{t.name}.{prop.name}.html"
+            return Markup(f'<a href="{href}"><code>{text}</code></a>')
+
+        if isinstance(method, gir.Method):
+            if method.set_property is not None:
+                link = gen_property_link(namespace, type_, method.set_property)
+                if link is not None:
+                    self.attributes["Sets property"] = link
+            if method.get_property is not None:
+                link = gen_property_link(namespace, type_, method.get_property)
+                if link is not None:
+                    self.attributes["Gets property"] = link
+
     @property
     def c_decl(self):
         res = []