Fix Griffe warnings.

examples/uploads/lynx_chatbot_scenario_selector.yaml

@@ -42,7 +42,7 @@
         where appropriate. Avoid phrases like 'According to this article' to maintain a natural
         tone.
   link_answer: &link # When present, formatted node link appends to answer, should contain {link}
-        "\n\nPlease visit <a href='{link}' target='_blank'>{link}</a> for further information."
+        "\n\nPlease visit {link} for further information."
   min_similarity_score: -1  # Only need to specify if > -1 and in RETRIEVE_LLM or RETRIEVE_ONLY mode
 - name: life_sciences_interest
   mode: retrieve_llm

lynxkite-core/src/lynxkite/core/ops.py

@@ -247,7 +247,7 @@ def op(
     """Decorator for defining an operation."""
 
     def decorator(func):
-        doc = parse_doc(func.__doc__)
+        doc = parse_doc(func)
         sig = inspect.signature(func)
         _view = view
         if view == "matplotlib":
@@ -444,16 +444,45 @@ def run_user_script(script_path: pathlib.Path):
 
 
 @functools.cache
-def parse_doc(doc):
-    """Griffe is an optional dependency. When available, we returned the parsed docstring."""
+def parse_doc(func):
+    """Griffe is an optional dependency. When available, we return the parsed docstring."""
+    doc = func.__doc__
     try:
         import griffe
     except ImportError:
         return doc
     if doc is None:
         return None
+    ds = griffe.Docstring(doc, parent=_get_griffe_function(func))
     if "----" in doc:
-        doc = griffe.Docstring(doc).parse("numpy")
+        ds = ds.parse("numpy")
     else:
-        doc = griffe.Docstring(doc).parse("google")
-    return json.loads(json.dumps(doc, cls=griffe.JSONEncoder))
+        ds = ds.parse("google")
+    return json.loads(json.dumps(ds, cls=griffe.JSONEncoder))
+
+
+def _get_griffe_function(func):
+    """Returns a griffe.Function object based on the signature of the function."""
+    import griffe
+
+    sig = inspect.signature(func)
+    parameters = []
+    for name, param in sig.parameters.items():
+        if param.annotation is inspect.Parameter.empty:
+            annotation = None
+        else:
+            annotation = param.annotation.__name__
+        parameters.append(
+            griffe.Parameter(
+                name,
+                annotation=annotation,
+                kind=griffe.ParameterKind.keyword_only
+                if param.kind == inspect.Parameter.KEYWORD_ONLY
+                else griffe.ParameterKind.positional_or_keyword,
+            )
+        )
+    return griffe.Function(
+        func.__name__,
+        parameters=griffe.Parameters(*parameters),
+        returns=str(sig.return_annotation),
+    )

lynxkite-graph-analytics/src/lynxkite_graph_analytics/lynxkite_ops.py

@@ -303,7 +303,7 @@ def create_graph(bundle: core.Bundle, *, relations: str = None) -> core.Bundle:
         relations (str, optional): Set of relations to set for the bundle. The parameter
             should be a JSON object where the keys are relation names and the values are
             a dictionary representation of a `RelationDefinition`.
-        Defaults to None.
+            Defaults to None.
 
     Returns:
         Bundle: The input bundle with the new relations set.