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

opensmi_core-0.2.2/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: OpenSMI-Core
+Version: 0.2.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>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Manufacturing
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Communications
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
+Classifier: Topic :: Software Development :: Embedded Systems
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSES/MIT.txt
+Requires-Dist: asyncua<3,>=2.0.1
+Requires-Dist: structlog>=26
+Requires-Dist: typing-extensions>=4.16.0
+Provides-Extra: rich
+Requires-Dist: rich>=15.0.0; extra == "rich"
+Requires-Dist: colorama>=0.4; sys_platform == "win32" and extra == "rich"
+Provides-Extra: json
+Requires-Dist: orjson<4,>=3; extra == "json"
+Dynamic: license-file
+
+![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.2/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.2}/pyproject.toml

@@ -5,12 +5,14 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "OpenSMI-Core"
 dynamic = ["version"]
-
+readme = "README.md"
 description = "Smart Machine Interface core functionality for server and client applications."
 authors = [
     { name = "Carsten Harms", email = "Carsten.Harms@dfki.de" },
     { name = "Simon Jungbluth", email = "Simon.Jungbluth@smartfactory.de" },
 ]
+license = "MIT"
+license-files = ["LICENSES/MIT.txt"]
 
 # see https://pypi.org/classifiers/
 classifiers = [

opensmi_core-0.2.2/src/OpenSMI_Core.egg-info/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: OpenSMI-Core
+Version: 0.2.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>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Manufacturing
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Communications
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
+Classifier: Topic :: Software Development :: Embedded Systems
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSES/MIT.txt
+Requires-Dist: asyncua<3,>=2.0.1
+Requires-Dist: structlog>=26
+Requires-Dist: typing-extensions>=4.16.0
+Provides-Extra: rich
+Requires-Dist: rich>=15.0.0; extra == "rich"
+Requires-Dist: colorama>=0.4; sys_platform == "win32" and extra == "rich"
+Provides-Extra: json
+Requires-Dist: orjson<4,>=3; extra == "json"
+Dynamic: license-file
+
+![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.2/src/OpenSMI_Core.egg-info/scm_version.json

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

{opensmi_core-0.2 → opensmi_core-0.2.2}/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/PKG-INFO

@@ -1,32 +0,0 @@
-Metadata-Version: 2.4
-Name: OpenSMI-Core
-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
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Information Technology
-Classifier: Intended Audience :: Manufacturing
-Classifier: Intended Audience :: Science/Research
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Communications
-Classifier: Topic :: Scientific/Engineering
-Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
-Classifier: Topic :: Software Development :: Embedded Systems
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Typing :: Typed
-Requires-Python: >=3.11
-License-File: LICENSE
-Requires-Dist: asyncua<3,>=2.0.1
-Requires-Dist: structlog>=26
-Requires-Dist: typing-extensions>=4.16.0
-Provides-Extra: rich
-Requires-Dist: rich>=15.0.0; extra == "rich"
-Requires-Dist: colorama>=0.4; sys_platform == "win32" and extra == "rich"
-Provides-Extra: json
-Requires-Dist: orjson<4,>=3; extra == "json"
-Dynamic: license-file

opensmi_core-0.2/README.md

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

opensmi_core-0.2/src/OpenSMI_Core.egg-info/PKG-INFO

@@ -1,32 +0,0 @@
-Metadata-Version: 2.4
-Name: OpenSMI-Core
-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
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Information Technology
-Classifier: Intended Audience :: Manufacturing
-Classifier: Intended Audience :: Science/Research
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Communications
-Classifier: Topic :: Scientific/Engineering
-Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
-Classifier: Topic :: Software Development :: Embedded Systems
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Typing :: Typed
-Requires-Python: >=3.11
-License-File: LICENSE
-Requires-Dist: asyncua<3,>=2.0.1
-Requires-Dist: structlog>=26
-Requires-Dist: typing-extensions>=4.16.0
-Provides-Extra: rich
-Requires-Dist: rich>=15.0.0; extra == "rich"
-Requires-Dist: colorama>=0.4; sys_platform == "win32" and extra == "rich"
-Provides-Extra: json
-Requires-Dist: orjson<4,>=3; extra == "json"
-Dynamic: license-file

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"
-}