FIX(SPHINXEXT) Convey __doc__ etal from Fn ==> Op; BUG ...

bc Sphinx generated the SAME doc
for all FnOperation module data.

- drop base.Operation.__name__ @Property.
++++ BUG: annotated function DO NOT APPEAR in Autodocuments.

Author: ankostis

graphtik/base.py

@@ -859,10 +859,6 @@ class Operation(Plottable, abc.ABC):
     provides: Items
     op_provides: Items
 
-    @property
-    def __name__(self) -> str:
-        return self.name
-
     @abc.abstractmethod
     def compute(self, named_inputs, outputs=None):
         """

graphtik/fnop.py

@@ -13,7 +13,7 @@
 import logging
 import textwrap
 from collections import abc as cabc
-from functools import wraps
+from functools import update_wrapper, wraps
 from typing import (
     Any,
     Callable,
@@ -340,8 +340,22 @@ def __init__(
         #: any "parents split by dots(``.``)".
         #: :seealso: :ref:`operation-nesting`
         self.name = name
+
         #: Fake function attributes.
-        self.__qualname__ = name
+        #:
+        if fn:
+            update_wrapper(
+                self,
+                fn,
+                assigned=("__module__", "__doc__", "__annotations__"),
+                updated=(),
+            )
+        self.__name__ = name
+        qname = getattr(fn, "__qualname__", None) or name
+        if qname:
+            # "ab.cd" => "ab.NAME", "ab" => "NAME", "" => "NAME"
+            qname = ".".join((*qname.split(".")[:-1], name))
+        self.__qualname__ = qname
 
         #: The :term:`needs` almost as given by the user
         #: (which may contain MULTI-sideffecteds and dupes),

graphtik/pipeline.py

@@ -174,9 +174,11 @@ def __init__(
         ## Set data asap, for debugging, although `net.withset()` will reset them.
         self.name = name
         #: Fake function attributes.
-        self.__qualname__ = name
-        # Remember Outputs for future `compute()`?
+        self.__name__ = self.__qualname__ = name
+
+        #: Remember Outputs for future `compute()`?
         self.outputs = outputs
+        #: Remember Outputs for future `compute()`?
         self.predicate = predicate
 
         # Prune network