MTPPy2.0 0.1.5__py3-none-any.whl

mtppy/pea/pea_opcua_server/marshalling.py

@@ -0,0 +1,60 @@
+"""Class for marshalling OPC UA subscriptions."""
+
+__copyright__ = (
+    "Copyright (c) 2026 Dresden University of Technology, Process-to-Order Group"
+)
+__license__ = "MIT"
+
+from mtppy.utils.logging import logger
+import sys
+import traceback
+
+from mtppy.pea.pea_opcua_server.subscription_list import SubscriptionList
+
+
+class Marshalling(object):
+    def __init__(self) -> None:
+        """Initialize marshalling OPC UA subscriptions class."""
+        self.subscription_list = None
+
+    def import_subscription_list(self, subscription_list: SubscriptionList):
+        """Import a subscription list.
+
+        Args:
+            subscription_list: Subscription list.
+        """
+        self.subscription_list = subscription_list
+
+    def datachange_notification(self, node, val, data):
+        """Execute a callback function if there was an external data value changes.
+
+        Args:
+            node: OPC UA node.
+            val: Value after change.
+            data: Not used. Keep due to indirect call from opc ua package
+        """
+        callback = self.find_set_callback(node)
+        callback_name = callback.__name__ if callback else "None"
+        logger.debug(f"node={node}, val={val}, callback={callback_name}")
+        if callback is not None:
+            try:
+                callback(val)
+            except Exception as exc:
+                exc_type, exc_value, exc_traceback = sys.exc_info()
+                logger.warning(
+                    f"{callback_name}({val}) threw exception {exc_type},{exc_value}"
+                )
+                logger.warning(
+                    f"{callback_name}({val}) exception {traceback.format_tb(exc_traceback)}"
+                )
+
+    def find_set_callback(self, node_id):
+        """Find a callback function to a specific OPC UA node by nodeid.
+
+        Args:
+            node_id: Node id.
+
+        Returns:
+            Callback function.
+        """
+        return self.subscription_list.get_callback(node_id)

mtppy/pea/pea_opcua_server/opcua_options_provider/__init__.py

@@ -0,0 +1,4 @@
+__copyright__ = (
+    "Copyright (c) 2026 Dresden University of Technology, Process-to-Order Group"
+)
+__license__ = "MIT"

mtppy/pea/pea_opcua_server/opcua_options_provider/instances/basic_opcua_options_provider.py

@@ -0,0 +1,50 @@
+"""Basic Realisation of the abstract OPCUAOptionsProvider."""
+
+__copyright__ = (
+    "Copyright (c) 2026 Dresden University of Technology, Process-to-Order Group"
+)
+__license__ = "MIT"
+
+from mtppy.pea.pea_opcua_server.opcua_options_provider.opcua_options_provider import (
+    OPCUAOptionsProvider,
+)
+
+
+class BasicOPCUAOptionsProvider(OPCUAOptionsProvider):
+    def __init__(self):
+        super().__init__()
+        self.type = "BasicNodeIdProvider"
+
+    def get_default_namespace_uri(self):
+        return "https://tu-dresden.de/p2o"
+
+    # As base variant a string node is generated
+    def generate_node_id(
+        self,
+        data_assembly_name: str,
+        data_item_name: str,
+        custom_node_id_value_prefix: str | None = None,
+        data_assembly_type: str | None = None,
+    ):
+        node_id_value = "s="
+        delimiter = "."
+
+        # Conditional prefix
+        if custom_node_id_value_prefix is not None:
+            node_id_value = f"{node_id_value}{custom_node_id_value_prefix}{delimiter}"
+
+        node_id_value = f"{node_id_value}{data_assembly_name}{delimiter}"
+
+        # Conditional DataAssembly type injection
+        if data_assembly_type is not None:
+            node_id_value = f"{node_id_value}{data_assembly_type}{delimiter}"
+
+        node_id_value = f"{node_id_value}{data_item_name}"
+
+        return node_id_value
+
+    def generate_browse_name(self, data_assembly_name: str, data_item_name: str):
+        return f"{data_assembly_name}.{data_item_name}"
+
+    def generate_display_name(self, data_assembly_name: str, data_item_name: str):
+        return f"{data_assembly_name}.{data_item_name}"

mtppy/pea/pea_opcua_server/opcua_options_provider/opcua_options_provider.py

@@ -0,0 +1,103 @@
+"""OPCUA Options Provider.
+
+This abstract base class defines the interface for providing OPC UA options
+such as node IDs, browse names, and display names for data assemblies.
+
+Attributes:
+    type: The type of the provider, defaulting to "NodeIdProvider".
+"""
+
+__copyright__ = (
+    "Copyright (c) 2026 Dresden University of Technology, Process-to-Order Group"
+)
+__license__ = "MIT"
+
+import abc
+
+
+class OPCUAOptionsProvider(abc.ABC):
+    """Abstract base class for OPC UA options providers.
+
+    This class defines the interface that all OPC UA options providers must
+    implement to generate OPC UA identifiers and names for data assemblies.
+    """
+
+    __metaclass__ = abc.ABCMeta
+
+    def __init__(self):
+        """Initialize the OPC UA options provider."""
+        self.type = "NodeIdProvider"
+
+    @staticmethod
+    def get_max_sessions():
+        """Get the maximum number of concurrent sessions.
+
+        Returns:
+            int: The maximum number of sessions allowed (default is 20).
+        """
+        return 20
+
+    @staticmethod
+    def get_minimum_update_rate():
+        """Get the minimum update rate in milliseconds.
+
+        Returns:
+            int: The minimum update rate in milliseconds (default is 1000).
+        """
+        return 1000
+
+    @abc.abstractmethod
+    def get_default_namespace_uri(self):
+        """Get the default namespace URI for the OPC UA server.
+
+        Returns:
+            str: The default namespace URI.
+        """
+        return
+
+    @abc.abstractmethod
+    def generate_node_id(
+        self,
+        data_assembly_name: str,
+        data_item_name: str,
+        custom_node_id_value_prefix: str | None = None,
+        data_assembly_type: str | None = None,
+    ):
+        """Generate a NodeID for the given data assembly and item.
+
+        Args:
+            data_assembly_name: The name of the data assembly.
+            data_item_name: The name of the data item within the assembly.
+            custom_node_id_value_prefix: Optional prefix for the node ID value.
+            data_assembly_type: Optional type of the data assembly.
+
+        Returns:
+            The generated NodeID for the specified data item.
+        """
+        return
+
+    @abc.abstractmethod
+    def generate_browse_name(self, data_assembly_name: str, data_item_name: str):
+        """Generate a browse name for the given data assembly and item.
+
+        Args:
+            data_assembly_name: The name of the data assembly.
+            data_item_name: The name of the data item within the assembly.
+
+        Returns:
+            The browse name for the specified data item.
+        """
+        return
+
+    @abc.abstractmethod
+    def generate_display_name(self, data_assembly_name: str, data_item_name: str):
+        """Generate a display name for the given data assembly and item.
+
+        Args:
+            data_assembly_name: The name of the data assembly.
+            data_item_name: The name of the data item within the assembly.
+
+        Returns:
+            The display name for the specified data item.
+        """
+        return