funcnodes-basic 0.2.3__py3-none-any.whl → 1.0.0__py3-none-any.whl

funcnodes_basic/__init__.py

@@ -6,8 +6,9 @@ from .strings import NODE_SHELF as strings_shelf
 from .dicts import NODE_SHELF as dicts_shelf
 from .input import NODE_SHELF as input_shelf
 from .dataclass import NODE_SHELF as dataclass_shelf
+from .pyobjects import NODE_SHELF as pyobjects_shelf
 
-__version__ = "0.2.3"
+__version__ = "1.0.0"
 
 NODE_SHELF = Shelf(
     nodes=[],
@@ -15,6 +16,7 @@ NODE_SHELF = Shelf(
         input_shelf,
         lists_shelf,
         dicts_shelf,
+        pyobjects_shelf,
         dataclass_shelf,
         strings_shelf,
         math_shelf,

funcnodes_basic/logic.py

@@ -1,6 +1,6 @@
 """Logic Nodes for control flow and decision making."""
 
-from funcnodes_core.node import Node, TriggerStack
+from funcnodes_core.node import Node
 from typing import Any, List, Optional
 from funcnodes_core.io import NodeInput, NodeOutput, NoValue
 import asyncio
@@ -35,8 +35,19 @@ class WhileNode(Node):
     async def func(self, condition: bool, input: Any) -> None:
         if self.inputs["condition"].value:
             self.outputs["do"].value = input
-            triggerstack = TriggerStack()
-            await self.outputs["do"].trigger(triggerstack)
+            datapaths = [
+                ip.datapath
+                for ip in self.outputs["do"].connections
+                if ip.datapath is not None
+            ]
+
+            while datapaths:
+                for dp in datapaths:
+                    if dp.done(breaking_nodes=[self]):
+                        datapaths.remove(dp)
+                        break
+                else:
+                    await asyncio.sleep(0.1)
             self.request_trigger()
         else:
             self.outputs["done"].value = input
@@ -94,9 +105,21 @@ class ForNode(Node):
             pass
 
         for i in self.progress(input, desc="Iterating", unit="it", total=iplen):
-            self.outputs["do"].set_value(i, does_trigger=False)
-            triggerstack = TriggerStack()
-            await self.outputs["do"].trigger(triggerstack)
+            self.outputs["do"].set_value(i, does_trigger=True)
+            datapaths = [
+                ip.datapath
+                for ip in self.outputs["do"].connections
+                if ip.datapath is not None
+            ]
+
+            while datapaths:
+                for dp in datapaths:
+                    if dp.done(breaking_nodes=[self]):
+                        datapaths.remove(dp)
+                        break
+                else:
+                    await asyncio.sleep(0.1)
+
             v = self.inputs["collector"].value
             if v is not NoValue:
                 results.append(v)

funcnodes_basic/pyobjects.py

@@ -0,0 +1,183 @@
+"""Utilities that expose common Python object interactions as nodes."""
+
+from __future__ import annotations
+
+from typing import Any, List, Annotated, Dict
+
+import funcnodes_core as fn
+from funcnodes_core.io import InputMeta, OutputMeta
+
+
+def _list_public_attributes(obj: Any) -> List[str]:
+    """Return a sorted list of the object's non-private attribute names."""
+    if obj is None:
+        return []
+    try:
+        attributes = dir(obj)
+    except Exception:  # pragma: no cover - dir() rarely raises but stay defensive
+        return []
+    # Sorting keeps the dropdown stable for UI components that rely on deterministic
+    # value ordering across reruns.
+    return sorted(attr for attr in attributes if not attr.startswith("_"))
+
+
+def _ensure_non_private(attribute: str) -> None:
+    """Reject attribute names that appear private."""
+
+    if attribute.startswith("_"):
+        raise AttributeError(
+            f"Access to private attribute '{attribute}' is not permitted by this node."
+        )
+
+
+@fn.NodeDecorator(
+    id="pyobject_get_attribute",
+    name="Get Attribute",
+    description="Retrieve the value of a non-private attribute from a Python object.",
+    # default_io_options=_attribute_io_options(),
+)
+def get_attribute(
+    obj: Annotated[
+        Any,
+        InputMeta(
+            description="Python object that exposes the desired attribute.",
+            on={
+                "after_set_value": fn.decorator.update_other_io_options(
+                    "attribute",
+                    _list_public_attributes,
+                )
+            }
+        ),
+    ],
+    attribute: Annotated[
+        str,
+        InputMeta(
+            description="Name of the attribute to retrieve; private attributes are rejected.",
+        ),
+    ],
+) -> Annotated[
+    Any,
+    OutputMeta(
+        description="Value read from the requested attribute.",
+    ),
+]:
+    """Return the value of the selected non-private attribute for the provided object."""
+    _ensure_non_private(attribute)
+    if not hasattr(obj, attribute):
+        raise AttributeError(
+            f"Attribute '{attribute}' is not available on object of type {type(obj).__name__}."
+        )
+    # getattr performs the actual attribute retrieval once validation is complete.
+    return getattr(obj, attribute)
+
+
+@fn.NodeDecorator(
+    id="pyobject_has_attribute",
+    name="Has Attribute",
+    description="Check whether an object exposes a given attribute.",
+)
+def has_attribute(
+    obj: Annotated[
+        Any,
+        InputMeta(
+            description="Python object that may expose the attribute.",
+        ),
+    ],
+    attribute: Annotated[
+        str,
+        InputMeta(
+            description="Attribute name to probe; private attributes are rejected.",
+        ),
+    ],
+) -> Annotated[
+    bool,
+    OutputMeta(description="True if the attribute exists on the object."),
+]:
+    """Return True when the object defines the requested attribute."""
+
+    return hasattr(obj, attribute)
+
+
+@fn.NodeDecorator(
+    id="pyobject_set_attribute",
+    name="Set Attribute",
+    description="Assign a new value to a non-private attribute on a Python object.",
+)
+def set_attribute(
+    obj: Annotated[
+        Any,
+        InputMeta(
+            description="Python object whose attribute should be updated.",
+        ),
+    ],
+    attribute: Annotated[
+        str,
+        InputMeta(
+            description="Attribute name that will receive the new value.",
+        ),
+    ],
+    value: Annotated[
+        Any,
+        InputMeta(description="Value to assign to the attribute."),
+    ],
+) -> Annotated[
+    Any,
+    OutputMeta(description="The original object after assignment."),
+]:
+    """Set an attribute on the provided object and return the object for chaining."""
+
+    _ensure_non_private(attribute)
+    setattr(obj, attribute, value)
+    return obj
+
+
+@fn.NodeDecorator(
+    id="pyobject_delete_attribute",
+    name="Delete Attribute",
+    description="Remove a non-private attribute from a Python object.",
+)
+def delete_attribute(
+    obj: Annotated[
+        Any,
+        InputMeta(
+            description="Python object whose attribute should be removed.",
+            on={
+                "after_set_value": fn.decorator.update_other_io_options(
+                    "attribute",
+                    _list_public_attributes,
+                )
+            }
+        ),
+    ],
+    attribute: Annotated[
+        str,
+        InputMeta(
+            description="Attribute name to remove from the object.",
+        ),
+    ],
+) -> Annotated[
+    Any,
+    OutputMeta(description="The original object after deletion."),
+]:
+    """Delete an attribute from the object and return the mutated object."""
+
+    _ensure_non_private(attribute)
+    if not hasattr(obj, attribute):
+        raise AttributeError(
+            f"Attribute '{attribute}' is not available on object of type {type(obj).__name__}."
+        )
+    delattr(obj, attribute)
+    return obj
+
+
+NODE_SHELF = fn.Shelf(
+    nodes=[
+        get_attribute,
+        has_attribute,
+        set_attribute,
+        delete_attribute,
+    ],
+    name="Python Objects",
+    description="Access and transform general Python objects.",
+    subshelves=[],
+)

{funcnodes_basic-0.2.3.dist-info → funcnodes_basic-1.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: funcnodes-basic
-Version: 0.2.3
+Version: 1.0.0
 Summary: Basic functionalities for funcnodes
 Author-email: Julian Kimmig <julian.kimmig@linkdlab.de>
 License: AGPL-3.0
@@ -12,7 +12,7 @@ Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or l
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: funcnodes-core>=0.3.9
+Requires-Dist: funcnodes-core>=1.0.5
 Requires-Dist: funcnodes
 Dynamic: license-file
 

{funcnodes_basic-0.2.3.dist-info → funcnodes_basic-1.0.0.dist-info}/RECORD

@@ -1,14 +1,15 @@
-funcnodes_basic/__init__.py,sha256=J9x7KEw491QUEh5Uwac9DrwOI0xJydob365Xo3vB3Lo,660
+funcnodes_basic/__init__.py,sha256=SIcd0uMAtX6o4OqcWwnbO4qnLO6b0HSdBR2UvLsYq64,738
 funcnodes_basic/dataclass.py,sha256=p7IjTek7XnHOxZCJnFHhmNtmYM1DpacmfuaUePvDQ7Y,1732
 funcnodes_basic/dicts.py,sha256=koNJEwIq9ryC7evBpnI-QmR7MBIbgUWqpPpwhB3M69Y,2507
 funcnodes_basic/input.py,sha256=FSHS1bIJ2dJc9NqWaJO0MxegRBERhfxFdkmDiwAuE6o,1654
 funcnodes_basic/lists.py,sha256=9kGnovK-oClFatslbIeYne27l2-EPEXZbr_6yQ1B1cY,5835
-funcnodes_basic/logic.py,sha256=YwIcAgDqxnmJoLVN_hk9XgqrOJvkx3zczx2DxgBliHU,4304
+funcnodes_basic/logic.py,sha256=HrJzM9h34PJUWiULU9Ol5iQ2tI6rl7c39iTt6RO6mRg,4952
 funcnodes_basic/math_nodes.py,sha256=PasNf-1wAvbJ_c-_qeiIDaUVfgPQEREJApeUcTS4FQg,10586
+funcnodes_basic/pyobjects.py,sha256=DHtMnbEkkpuhDEqrbdgW8UlaN9-WyfESkAbgwYaOFjM,5188
 funcnodes_basic/strings.py,sha256=O6rcxBQJ5eYd765w_tolaD6xMwsNmtBjiPgJ_69tKyA,16429
-funcnodes_basic-0.2.3.dist-info/licenses/LICENSE,sha256=21Lj2q2SYKHMY4768_a3pr3q0jY2VYamAHipoodhMDc,34273
-funcnodes_basic-0.2.3.dist-info/METADATA,sha256=d_LxJhdF-wi7JwpXRlJwrIrWcnBNlK79CZu4DSCEfAo,2001
-funcnodes_basic-0.2.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-funcnodes_basic-0.2.3.dist-info/entry_points.txt,sha256=HZ0g1oDO8PrL_f6b09lfTrS-jXqbZrP0qYf1Km_pVxw,79
-funcnodes_basic-0.2.3.dist-info/top_level.txt,sha256=xYbcX5Jx-Ow3N3kgXtyvh8kuhCahb3eHBIZfMvkpVKI,16
-funcnodes_basic-0.2.3.dist-info/RECORD,,
+funcnodes_basic-1.0.0.dist-info/licenses/LICENSE,sha256=21Lj2q2SYKHMY4768_a3pr3q0jY2VYamAHipoodhMDc,34273
+funcnodes_basic-1.0.0.dist-info/METADATA,sha256=ksWmCMQjJ4OOeXrf_XJWlqo_ZX9iqDujZn8jFW850j4,2001
+funcnodes_basic-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+funcnodes_basic-1.0.0.dist-info/entry_points.txt,sha256=HZ0g1oDO8PrL_f6b09lfTrS-jXqbZrP0qYf1Km_pVxw,79
+funcnodes_basic-1.0.0.dist-info/top_level.txt,sha256=xYbcX5Jx-Ow3N3kgXtyvh8kuhCahb3eHBIZfMvkpVKI,16
+funcnodes_basic-1.0.0.dist-info/RECORD,,