OpenSMI-Core 0.1.1__tar.gz → 0.2__tar.gz

{opensmi_core-0.1.1 → opensmi_core-0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: OpenSMI-Core
-Version: 0.1.1
+Version: 0.2
 Summary: Smart Machine Interface core functionality for server and client applications.
 Author-email: Carsten Harms <Carsten.Harms@dfki.de>, Simon Jungbluth <Simon.Jungbluth@smartfactory.de>
 Classifier: Development Status :: 4 - Beta

{opensmi_core-0.1.1 → opensmi_core-0.2}/src/OpenSMI_Core.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: OpenSMI-Core
-Version: 0.1.1
+Version: 0.2
 Summary: Smart Machine Interface core functionality for server and client applications.
 Author-email: Carsten Harms <Carsten.Harms@dfki.de>, Simon Jungbluth <Simon.Jungbluth@smartfactory.de>
 Classifier: Development Status :: 4 - Beta

opensmi_core-0.2/src/OpenSMI_Core.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.2",
+  "distance": 0,
+  "node": "g90c7c0325f86ebe6f93c7c832b29f4672c03faa6",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-09-23"
+}

{opensmi_core-0.1.1 → opensmi_core-0.2}/src/opensmi/core/base_ua_object.py

@@ -21,11 +21,14 @@ _ServerType = TypeVar("_ServerType", bound="BaseServer")
 class BaseUaObject(Generic[_ServerType]):
     """Base class for all UA objects, both client- and server-side."""
 
+    _parent: "BaseUaObject[_ServerType] | None" = None
+
     def __init__(
         self,
         *,
         name: str | None = None,
         server: _ServerType | None = None,
+        parent: "BaseUaObject[_ServerType] | None" = None,
         **kwargs,
     ) -> None:
         """*Cooperative* constructor.
@@ -33,6 +36,8 @@ class BaseUaObject(Generic[_ServerType]):
         :param name: The name of the UA object. Defaults to the class name.
         :param server: The associated server of the UA object. Note that there must be at least one non ``None`` in
             the hierarchy.
+        :param parent: The parent of the UA object. Only Machines are allowed to have no parent. Can be set later before
+            asynchronous initialization.
         """
         if name is None:
             name = self.__class__.__name__
@@ -42,6 +47,8 @@ class BaseUaObject(Generic[_ServerType]):
 
         self._name: str = name
         self._server: _ServerType | None = server
+        if parent is not None:
+            self.parent = parent  # via setter to allow optional runtime type checking
         self._ua_node: Node | None = None
         self._logger: structlog.BoundLogger = structlog.get_logger(
             f"opensmi.{self.__class__.__name__}", name=self.name
@@ -76,16 +83,17 @@ class BaseUaObject(Generic[_ServerType]):
     @property
     @deprecated("Use path instead")
     def full_name(self) -> str:
-        parent = getattr(self, "parent", None)
-        if isinstance(parent, BaseUaObject):
-            return f"{parent.full_name}/{self.name}"
+        if self.parent is not None:
+            assert isinstance(self.parent, BaseUaObject)
+            return f"{self.parent.full_name}/{self.name}"
         return f"/{self.name}"
 
     @property
     def path(self) -> PurePosixPath:
         """Return the full path of the object."""
-        if isinstance(parent := getattr(self, "parent", None), BaseUaObject):
-            return parent.path / self.name
+        if self.parent is not None:
+            assert isinstance(self.parent, BaseUaObject)
+            return self.parent.path / self.name
         return PurePosixPath("/") / self.name
 
     @property
@@ -93,6 +101,17 @@ class BaseUaObject(Generic[_ServerType]):
         """Logger associated with the `UaObject` instance."""
         return self._logger  # type: ignore
 
+    @property
+    def parent(self) -> "BaseUaObject[_ServerType] | None":
+        """Return the untyped parent of the UA object."""
+        return self._parent
+
+    @parent.setter
+    def parent(self, parent: "BaseUaObject[_ServerType]") -> None:
+        """Set the parent of the UA object. Given ``parent`` must be an instance of `BaseUaObject`."""
+        assert isinstance(parent, BaseUaObject)
+        self._parent = parent
+
     # TODO
     # @override
     # def _repr_items(self) -> Iterator[tuple[str, object]]:

{opensmi_core-0.1.1 → opensmi_core-0.2}/src/opensmi/core/ua_node_util.py

@@ -21,6 +21,8 @@ from opensmi.core import Unit
 NULL_NODE_ID = ua.NodeId()
 """ This node id indicates an invalid Node ID and should be treated as 'None'. """
 
+_LOGGER = structlog.getLogger(__name__)
+
 
 async def read_value(node: Node) -> Any:
     """Read the value of the given node and transforms the NULL_NODE_ID into None."""
@@ -126,17 +128,22 @@ async def get_properties(node: Node, *, logger: structlog.stdlib.BoundLogger | N
     return result
 
 
-async def get_type_definition(ua_node: Node) -> str:
-    """Return the browse name of the OPC UA type definition of the given node."""
-    try:
-        type_definition_list = await ua_node.get_references(
-            ua.object_ids.ObjectIds.HasTypeDefinition,
-            ua.BrowseDirection.Forward,
-        )
+async def get_type_definition(ua_node: Node, *, default: str = "UNKNOWN") -> str:
+    """Return the browse name of the OPC UA type definition of the given node.
+
+    :param ua_node: OPC UA node to operate on.
+    :param default: Default value to return if type definition cannot be determined.
+    """
+    assert ua_node is not None, "No node node given!"
+    type_definition_list = await ua_node.get_references(
+        ua.object_ids.ObjectIds.HasTypeDefinition,
+        ua.BrowseDirection.Forward,
+    )
+    if len(type_definition_list) > 0:
         return type_definition_list[0].BrowseName.Name
-    except Exception as ex:
-        msg = f"Could not find type definition for node {ua_node.nodeid.to_string()}!"
-        raise RuntimeError(msg) from ex
+
+    _LOGGER.warning("Could not determine type definition!", ua_node = ua_node.nodeid.to_string(), default=default)
+    return default
 
 
 def get_node_id(

opensmi_core-0.1.1/src/OpenSMI_Core.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "0.1.1",
-  "distance": 0,
-  "node": "ga4ff41ae9039d37aefd1ee2c5848d346c782f6cc",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-09-15"
-}