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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: OpenSMI-Core
-Version: 0.2
+Version: 0.2.1
 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.1/README.md

@@ -0,0 +1,49 @@
+![OpenSMI Logo](https://smartfactory.de/wp-content/uploads/2026/09/Logo_OpenSMI.png)
+
+[![Docs](https://img.shields.io/badge/docs-online-blue)](https://smartfactory-kl.github.io/opensmi-core/)
+[![PyPI version](https://img.shields.io/pypi/v/opensmi-core.svg)](https://pypi.org/project/opensmi-core/)
+[![Python versions](https://img.shields.io/pypi/pyversions/opensmi-core.svg)](https://pypi.org/project/opensmi-core/)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+# OpenSMI Core
+
+Core functionality for other OpenSMI packages such as:
+
+- [OpenSMI Client](https://github.com/SmartFactory-KL/opensmi-client)
+- [OpenSMI Server](https://github.com/SmartFactory-KL/opensmi-server)
+
+## Features
+
+- (Nested) Configuration parsing into dataclasses from TOML files (See [config.py](src/opensmi/core/config.py))
+- Lifecycle management via mixin and `@lifecycle` decorators, allowing explicit ordering 
+  (See [lifecycle_mixin.py](src/opensmi/core/lifecycle_mixin.py))
+- Simple callbacks via `Signal` (similar to [aiosignal](https://pypi.org/project/aiosignal/), but without freezing)
+  (See [signal.py](src/opensmi/core/signal.py))
+- [asyncua](https://pypi.org/project/asyncua/) (OPC UA) helpers 
+  - Node helper functions (See [ua_node_util.py](src/opensmi/core/ua_node_util.py))
+  - SubscriptionManager (See [subscription_manager.py](src/opensmi/core/subscription_manager.py))
+- Enums for OpenSMI machine, component and skill states
+- All [UN/CEFACT-Rec20](https://unece.org/trade/documents/2021/06/uncefact-rec20-0) units as a type-checkable enum. 
+  (See [unit_all.py](src/opensmi/core/unit_all.py))
+- [Structured Logging](https://pypi.org/project/structlog/) configuration (See [logging.py](src/opensmi/core/logging.py))
+
+> [!warning]
+> This library is currently pre-1.0 — expect refactoring outside above-mentioned functionality.
+
+## Installation
+
+Requires Python 3.11+.
+
+```bash
+pip install opensmi-core
+```
+
+## Project Status
+
+OpenSMI began as a closed-source project at [SmartFactory-KL](https://smartfactory.de/), in active use in our model
+factory since 2020. Its OPC UA information model has been refined across many iterations of research and
+demonstrator use. The framework was open-sourced in 2026 following substantial refactoring and cleanup.
+
+## License
+
+[MIT License](LICENSE)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: OpenSMI-Core
-Version: 0.2
+Version: 0.2.1
 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.1/src/OpenSMI_Core.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.2.1",
+  "distance": 0,
+  "node": "ga8edabe8cc0987a9434f135a0b149bc312ad6458",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-10-06"
+}

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

@@ -65,7 +65,7 @@ async def write_value(node: Node, value: Any, *, variant_type: ua.VariantType |
     try:
         if isinstance(value, ua.Variant):
             await _write_value(node, value, variant_type=value.VariantType)
-        if variant_type is not None:
+        elif variant_type is not None:
             await _write_value(node, value, variant_type=variant_type)
         else:
             # we need to figure out the correct variant type to use ourselves
@@ -178,16 +178,29 @@ def get_node_id(
     return ua.NodeId(Identifier=identifier, NamespaceIndex=ua.Int16(ns_idx))
 
 
-async def get_child_without_ns(parent: Node, *, display_name: str) -> Node:
-    """Return the first child node with given display name while ignoring the namespace index.
+async def get_child_without_ns(parent: Node, *, browse_name: str | None = None, display_name: str | None = None) -> Node:
+    """Return the first child node with given ``browse_name`` or ``display_name`` while ignoring namespaces.
 
-    :raises BadNoMatch: If no child with given display name exists.
+    For each child, ``BrowseName`` is matched first, ``DisplayName`` afterward. If both are given, a child matching
+    either one is returned.
+
+    :param parent: OPC UA parent node.
+    :param browse_name: OPC UA ``BrowseName.Name`` content to compare against. ``NamespaceIndex`` is ignored.
+    :param display_name: OPC UA ``DisplayName.Text`` content to compare against. ``Locale`` is ignored.
+
+    :raises ValueError: If neither ``browse_name`` nor ``display_name`` is given.
+    :raises BadNoMatch: If no child with given browse name or display name was found.
     """
-    for child in await parent.get_children():
-        child_display_name = (await child.read_display_name()).Text
-        # print(parent.nodeid.to_string(), display_name, child_display_name)
-        if child_display_name == display_name:
-            return child
+    if browse_name is None and display_name is None:
+        msg = "Either browse_name or display_name must be set"
+        raise ValueError(msg)
+
+    for ref in await parent.get_children_descriptions():
+        if browse_name is not None and ref.BrowseName.Name == browse_name:
+            return Node(session=parent.session, nodeid=ref.NodeId)
+        if display_name is not None and ref.DisplayName.Text == display_name:
+            return Node(session=parent.session, nodeid=ref.NodeId)
+
     raise ua.uaerrors.BadNoMatch
 
 

opensmi_core-0.2/README.md

@@ -1,2 +0,0 @@
-# OpenSMI Common
-

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

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