MTPPy2.0 0.2.0__tar.gz → 0.3.0__tar.gz

{mtppy2_0-0.2.0/src/MTPPy2.0.egg-info → mtppy2_0-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MTPPy2.0
-Version: 0.2.0
+Version: 0.3.0
 Summary: Open-source modular automation with MTP 2.0
 Author: Dresden University of Technology, Process-to-Order Group
 Author-email: Julius Lorenz <julius.lorenz@tu-dresden.de>, Leon Urbas <leon.urbas@tu-dresden.de>
@@ -18,13 +18,16 @@ Classifier: Topic :: Scientific/Engineering
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: opcua~=0.98.13
 Requires-Dist: jsonschema>=4.26.0
 Requires-Dist: chardet>=7.6.0
 Requires-Dist: aiohttp>=3.12.0
 Requires-Dist: pymodbus>=3.15.0
 Requires-Dist: simple-pid>=2.0.1
-Requires-Dist: pymodbus>=3.15.0
+Requires-Dist: rich>=14.0.0
+Requires-Dist: pyserial>=3.5
+Requires-Dist: windows-curses>=2.4.2; sys_platform == "win32"
+Requires-Dist: lark>=1.3.1
+Requires-Dist: opcua>=0.98.13
 Dynamic: license-file
 
 # MTPPy2.0
@@ -38,7 +41,7 @@ Towards that end MTPPy2.0 implements several parts of the PNO MTP 2.0 specificat
 
 ## Status
 [![Latest Release](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/badges/release.svg)](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/releases)
-[![coverage report](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/badges/main/coverage.svg)](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/commits/main)
+[![coverage report](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/badges/main/coverage.svg)](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/commits/develop)
 
 ## License
 MTPPy2.0 is licensed under the [MIT license](./LICENSE). 

{mtppy2_0-0.2.0 → mtppy2_0-0.3.0}/README.md

@@ -9,7 +9,7 @@ Towards that end MTPPy2.0 implements several parts of the PNO MTP 2.0 specificat
 
 ## Status
 [![Latest Release](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/badges/release.svg)](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/releases)
-[![coverage report](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/badges/main/coverage.svg)](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/commits/main)
+[![coverage report](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/badges/main/coverage.svg)](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/commits/develop)
 
 ## License
 MTPPy2.0 is licensed under the [MIT license](./LICENSE). 

mtppy2_0-0.3.0/pyproject.toml

@@ -0,0 +1,179 @@
+[project]
+name = "MTPPy2.0"
+version = "0.3.0"
+description = "Open-source modular automation with MTP 2.0"
+readme="README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.13" 
+authors = [
+    { name = "Dresden University of Technology, Process-to-Order Group" },
+    { name = "Julius Lorenz", email="julius.lorenz@tu-dresden.de" },
+    { name = "Leon Urbas", email="leon.urbas@tu-dresden.de" },
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Education",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Manufacturing",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+]
+dependencies = [
+    "jsonschema>=4.26.0",
+    "chardet>=7.6.0",
+    "aiohttp>=3.12.0",
+    "pymodbus>=3.15.0",
+    "simple-pid>=2.0.1",
+    "rich>=14.0.0",
+    "pyserial>=3.5",
+    "windows-curses>=2.4.2; sys_platform == 'win32'",
+    "lark>=1.3.1",
+    "opcua>=0.98.13",
+]
+
+[project.urls]
+Homepage = "https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0"
+Issues= "https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/boards"
+
+
+[build-system]
+requires = ["setuptools~=82.0.1"]
+build-backend = "setuptools.build_meta"
+
+[project.scripts]
+mtp_inspector = "tools.mtp_inspector:main"
+minimal_recipe = "tools.minimal_recipe:main"
+pea_inspector = "tools.pea_inspector:main"
+fea_inspector = "tools.fea_inspector:main"
+modbus_cli = "tools.modbus_cli:main"
+inspector_tc = "tools.inspector_tc:main"
+rmtp_pea = "mtppy.pea.rmtp_pea:main"
+
+[dependency-groups]
+dev = [
+    "black>=26.5.1",
+    "circular-import-detector>=1.0.18",
+    "hypothesis>=6.168.0",
+    "ipykernel>=7.3.0",
+    "linkchecker>=10.6.0",
+    "mkdocstrings[python]>=1.0.6",
+    "opcua-client>=0.8.4",
+    "py-spy>=0.4.2",
+    "pytest~=9.1.1",
+    "pytest-console-scripts>=1.4.1",
+    "pytest-cov>=7.1.0",
+    "pytest-coverage>=0.0",
+    "pytest-mock>=3.15.1",
+    "pytest-timeout>=2.4.0",
+    "ruff>=0.16.0",
+    "setuptools~=82.0.1",
+    "streamlit>=1.63.0",
+    "streamlit-autorefresh>=1.0.1",
+    "zensical>=0.0.51",
+]
+
+[tool.setuptools.dynamic]
+version = { attr = "mtppy.__version__" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.coverage.run]
+include = [ 
+    "*/src/mtppy/*"
+]
+omit = [
+    "*/venv/*",
+    "*/.venv/*",
+    "*/__pycache__/*",
+    "*/setup.py",
+    "*/distutils/*",
+    "*/build/*",
+    "*/*_test.py",
+    "*/test_*.py",
+]
+
+[tool.uv]
+
+[tool.pytest]
+pythonpath = ["src"]
+testpaths = ["src", "tests"]
+filterwarnings = [
+    "ignore::UserWarning",
+    'ignore:datetime.datetime.utcnow\(\) is deprecated:DeprecationWarning',
+]
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "ANN002", "ANN003",  # missing-type-args / missing-type-kwargs (noisy for *args/**kwargs)
+    "D203",  # incompatible with D211
+    "D212", "D213",  # incompatible with each other
+    "D205",  # missing blank line after summary
+    "D413",  # missing blank line after last section
+    "PLR0913",  # too many arguments (common in dataclass-heavy code)
+    "PLR0917",  # too many positional arguments (DataItem / DataAssembly constructors)
+    # Boolean-typed params are pervasive: PNO MTP 2.0 DataItems are boolean and
+    # their write callbacks are invoked positionally as ``cb(value)``, so the
+    # boolean-trap rules cannot be satisfied without breaking the API.
+    "FBT001",  # boolean-typed positional argument
+    "FBT002",  # boolean default positional argument
+    "FBT003",  # boolean positional value in call
+]
+
+[tool.ruff.lint.per-file-ignores]
+# The tests/ directory uses rootdir-based imports (no __init__.py by design).
+"tests/**/*.py" = [
+    "INP001",  # implicit namespace package
+]
+# CLI tools print to stdout by design.
+"src/tools/**/*.py" = [
+    "T201",  # print() is the intended CLI output mechanism
+]
+# Test files: docstrings, magic values, type annotations, and boolean params
+# are not expected at the same strictness as production code.
+"*_test.py" = [
+    "ANN001", "ANN201", "ANN202",  # missing type annotations
+    "D101", "D102", "D103", "D104", "D107",  # missing docstrings
+    "PLR2004",  # magic value in comparison (test assertions)
+    "ERA001",  # commented-out code
+    "ARG002",  # unused method argument (fixtures)
+    "FBT001", "FBT002", "FBT003",  # boolean positional args
+    "EM101", "EM102", "TRY003",  # exception message style
+    "PLC0415",  # import inside function
+    "F841",  # unused variable
+    "N802",  # function naming
+    "PT006",  # pytest parametrize names type
+    "S101",  # assert
+    "C901",  # complex structure
+    "PLR0917",  # too many positional arguments
+]
+"test_*.py" = [
+    "ANN001", "ANN201", "ANN202",
+    "D101", "D102", "D103", "D104", "D107",
+    "PLR2004",
+    "ERA001",
+    "ARG002",
+    "FBT001", "FBT002", "FBT003",
+    "EM101", "EM102", "TRY003",
+    "PLC0415",
+    "F841",
+    "N802",
+    "PT006",
+    "S101",
+    "C901",
+    "PLR0917",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"

{mtppy2_0-0.2.0 → mtppy2_0-0.3.0/src/MTPPy2.0.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MTPPy2.0
-Version: 0.2.0
+Version: 0.3.0
 Summary: Open-source modular automation with MTP 2.0
 Author: Dresden University of Technology, Process-to-Order Group
 Author-email: Julius Lorenz <julius.lorenz@tu-dresden.de>, Leon Urbas <leon.urbas@tu-dresden.de>
@@ -18,13 +18,16 @@ Classifier: Topic :: Scientific/Engineering
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: opcua~=0.98.13
 Requires-Dist: jsonschema>=4.26.0
 Requires-Dist: chardet>=7.6.0
 Requires-Dist: aiohttp>=3.12.0
 Requires-Dist: pymodbus>=3.15.0
 Requires-Dist: simple-pid>=2.0.1
-Requires-Dist: pymodbus>=3.15.0
+Requires-Dist: rich>=14.0.0
+Requires-Dist: pyserial>=3.5
+Requires-Dist: windows-curses>=2.4.2; sys_platform == "win32"
+Requires-Dist: lark>=1.3.1
+Requires-Dist: opcua>=0.98.13
 Dynamic: license-file
 
 # MTPPy2.0
@@ -38,7 +41,7 @@ Towards that end MTPPy2.0 implements several parts of the PNO MTP 2.0 specificat
 
 ## Status
 [![Latest Release](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/badges/release.svg)](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/releases)
-[![coverage report](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/badges/main/coverage.svg)](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/commits/main)
+[![coverage report](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/badges/main/coverage.svg)](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/commits/develop)
 
 ## License
 MTPPy2.0 is licensed under the [MIT license](./LICENSE). 

{mtppy2_0-0.2.0 → mtppy2_0-0.3.0}/src/MTPPy2.0.egg-info/SOURCES.txt

@@ -21,6 +21,7 @@ src/examples/scratch/__init__.py
 src/examples/scratch/pea_minimal.py
 src/mtppy/__init__.py
 src/mtppy/feas/__init__.py
+src/mtppy/feas/common/__init__.py
 src/mtppy/feas/modbus/__init__.py
 src/mtppy/feas/modbus/config_loader.py
 src/mtppy/feas/modbus/config_loader_test.py
@@ -32,6 +33,7 @@ src/mtppy/feas/modbus/io_procedure.py
 src/mtppy/feas/modbus/io_procedure_test.py
 src/mtppy/feas/modbus/io_service.py
 src/mtppy/feas/modbus/io_service_test.py
+src/mtppy/feas/pea/__init__.py
 src/mtppy/part1/__init__.py
 src/mtppy/part1/empty_folder_test.py
 src/mtppy/part3/__init__.py
@@ -161,23 +163,24 @@ src/mtppy/pea/rmtp_pea.py
 src/mtppy/pea/rmtp_pea_test.py
 src/mtppy/pea/service_factory.py
 src/mtppy/pea/service_factory_test.py
+src/mtppy/pea/application_logic/__init__.py
+src/mtppy/pea/application_logic/application_logic_pea.py
+src/mtppy/pea/application_logic/application_logic_registry.py
+src/mtppy/pea/application_logic/application_logic_registry_test.py
+src/mtppy/pea/application_logic/uml_state_machine_service.py
+src/mtppy/pea/application_logic/uml_state_machine_service_scenario_test.py
+src/mtppy/pea/application_logic/uml_state_machine_service_test.py
 src/mtppy/pea/mtp_generator/__init__.py
 src/mtppy/pea/mtp_generator/mtp_generator.py
 src/mtppy/pea/mtp_generator/mtp_generator_test.py
 src/mtppy/pea/pea_opcua_server/__init__.py
 src/mtppy/pea/pea_opcua_server/marshalling.py
 src/mtppy/pea/pea_opcua_server/pea_opcua_server.py
+src/mtppy/pea/pea_opcua_server/pea_opcua_server_test.py
 src/mtppy/pea/pea_opcua_server/subscription_list.py
 src/mtppy/pea/pea_opcua_server/opcua_options_provider/__init__.py
 src/mtppy/pea/pea_opcua_server/opcua_options_provider/opcua_options_provider.py
 src/mtppy/pea/pea_opcua_server/opcua_options_provider/instances/basic_opcua_options_provider.py
-src/mtppy/pea/user_logic/__init__.py
-src/mtppy/pea/user_logic/user_logic_pea.py
-src/mtppy/pea/user_logic/user_logic_registry.py
-src/mtppy/pea/user_logic/user_logic_registry_test.py
-src/mtppy/pea/user_logic/user_logic_service.py
-src/mtppy/pea/user_logic/user_logic_service_scenario_test.py
-src/mtppy/pea/user_logic/user_logic_service_test.py
 src/mtppy/utils/__init__.py
 src/mtppy/utils/data_assembly_dict.py
 src/mtppy/utils/data_assembly_dict_test.py
@@ -211,15 +214,30 @@ src/mtppy/utils/mtp_file_handling/mtp_writer/ressources/get_content_types.py
 src/mtppy/utils/mtp_file_handling/mtp_writer/ressources/get_rels.py
 src/tools/__init__.py
 src/tools/create_bugreport.py
-src/tools/inspect_mtp.py
+src/tools/fea_inspector.py
+src/tools/inspector_tc.py
+src/tools/list_ports.py
 src/tools/minimal_recipe.py
-src/tools/scan_pea.py
+src/tools/modbus_cli.py
+src/tools/mtp_inspector.py
+src/tools/pea_cli.py
+src/tools/pea_inspector.py
+src/tools/sync_memories.py
+src/tools/share/client_grammar_base.py
+src/tools/share/modbus_client_function.py
+src/tools/share/modbus_client_function_test.py
+src/tools/share/modbus_client_grammar.py
+src/tools/share/modbus_client_grammar_test.py
+src/tools/share/pea_client_function.py
+src/tools/share/pea_client_grammar.py
+src/tools/share/pea_client_grammar_test.py
 src/utils/__init__.py
 src/utils/get_uuid.py
 src/utils/get_uuid_test.py
 src/utils/logging.py
 src/utils/logging_test.py
 src/utils/type_conversion.py
+src/utils/type_conversion_hypothesis_test.py
 src/utils/type_conversion_test.py
 src/utils/file_handling/__init__.py
 src/utils/file_handling/cleanup_folder.py
@@ -237,4 +255,6 @@ src/utils/resolve_unit/resolve_unit.py
 src/utils/resolve_unit/unit_lib.py
 src/utils/resolve_unit/unit_lib_test.py
 tests/test_data_item_handshake.py
-tests/test_examples.py
+tests/test_examples.py
+tests/test_pol_write_wo_timestamp.py
+tests/test_reveal_direct_write.py

mtppy2_0-0.3.0/src/MTPPy2.0.egg-info/entry_points.txt

@@ -0,0 +1,8 @@
+[console_scripts]
+fea_inspector = tools.fea_inspector:main
+inspector_tc = tools.inspector_tc:main
+minimal_recipe = tools.minimal_recipe:main
+modbus_cli = tools.modbus_cli:main
+mtp_inspector = tools.mtp_inspector:main
+pea_inspector = tools.pea_inspector:main
+rmtp_pea = mtppy.pea.rmtp_pea:main

mtppy2_0-0.3.0/src/MTPPy2.0.egg-info/requires.txt

@@ -0,0 +1,12 @@
+jsonschema>=4.26.0
+chardet>=7.6.0
+aiohttp>=3.12.0
+pymodbus>=3.15.0
+simple-pid>=2.0.1
+rich>=14.0.0
+pyserial>=3.5
+lark>=1.3.1
+opcua>=0.98.13
+
+[:sys_platform == "win32"]
+windows-curses>=2.4.2

{mtppy2_0-0.2.0 → mtppy2_0-0.3.0}/src/examples/modbus/m15_logic.py

@@ -5,10 +5,13 @@ __copyright__ = (
 )
 __license__ = "MIT"
 
-from mtppy.part3.data_assembly_set.active_elements.pid.pid_ctrl import PIDCtrl
-from mtppy.utils.logging import logger
+from typing import TYPE_CHECKING
+
 from mtppy.part4.automation_services.service import Service
-from mtppy.pea.user_logic.user_logic_registry import register
+from mtppy.pea.application_logic.application_logic_registry import register
+
+if TYPE_CHECKING:
+    from mtppy.part3.data_assembly_set.active_elements.pid.pid_ctrl import PIDCtrl
 
 __requirements_mtp__ = "M15.mtp"
 
@@ -28,6 +31,7 @@ Spezifikation für produce.auto.starting.entry:
 
 @register("produce.auto.starting.entry")
 def reset_units(context: Service) -> bool:
+    """Reset display units to zero and configure the PID controller."""
     context.get_param(DA_PRESSURE_UNITS).V = 0
     context.get_param(DA_TEMP_UNITS).V = 0
     context.get_param(DA_VOLUME_UNITS).V = 0
@@ -52,6 +56,7 @@ Spezifikation für produce.auto.starting.do:
 
 @register("produce.auto.starting.do")
 def start_generator(context: Service) -> bool:
+    """Start the generator and open the outlet valve."""
     start_stop = context.get_param(DA_START_STOP)
     valve = context.get_param(DA_VALVE)
     p_out_sp = context.get_param("p_out_sp")
@@ -72,6 +77,7 @@ Spezifikation für produce.auto.holding.do:
 
 @register("produce.auto.holding.do")
 def hold_generator(context: Service) -> bool:
+    """Close the outlet valve."""
     context.get_param(DA_VALVE).CloseAut = 1
     return True
 
@@ -84,21 +90,25 @@ Spezifikation für produce.auto.unholding.do:
 
 @register("produce.auto.unholding.do")
 def unhold_generator(context: Service) -> bool:
+    """Open the outlet valve."""
     context.get_param(DA_VALVE).OpenAut = 1
     return True
 
 
 """
 Spezifikation für produce.auto.completing.do sowie stopping und aborting:
-    Stoppe den Generator (DA_START_STOP.V = 1) und schließe das 
+    Stoppe den Generator (DA_START_STOP.V = 1) und schließe das
     Auslassventil (DA_VALVE.V = 0).
 """
 
 
 @register(
-    "produce.auto.completing.do", "produce.auto.stopping.do", "produce.auto.aborting.do"
+    "produce.auto.completing.do",
+    "produce.auto.stopping.do",
+    "produce.auto.aborting.do",
 )
 def stop_generator(context: Service) -> bool:
+    """Stop the generator and close the outlet valve."""
     start_stop = context.get_param(DA_START_STOP)
     valve = context.get_param(DA_VALVE)
 

{mtppy2_0-0.2.0 → mtppy2_0-0.3.0}/src/examples/modbus/m15_pea.py

@@ -17,7 +17,8 @@ from mtppy.feas.modbus import (
     load_register_mappings,
 )
 from mtppy.part3.data_assembly_set.data_assembly import DataAssembly
-from mtppy.pea.user_logic.user_logic_pea import UserLogicPEA
+from mtppy.part4.automation_services.procedure import Procedure
+from mtppy.pea.application_logic.application_logic_pea import ApplicationLogicPEA
 from mtppy.utils.logging import CHOICES, logger, setLogLevel
 
 DEFAULT_HOST = "localhost"
@@ -27,7 +28,7 @@ DEFAULT_CYCLE_TIME = 0.5
 CONFIG_PATH = Path(__file__).with_name("m15_modbus.json")
 
 
-class M15Pea(UserLogicPEA):
+class M15Pea(ApplicationLogicPEA):
     """PEA that exposes M15 registers as internal DataAssemblies."""
 
     def __init__(
@@ -41,19 +42,21 @@ class M15Pea(UserLogicPEA):
         ssd: str = "",
         code: str = "",
     ) -> None:
+        """Create the PEA, Modbus client, I/O service, and data-assembly wiring."""
         super().__init__(endpoint=endpoint, mtp=mtp, ssd=ssd, code=code)
         self.modbus_client = ModbusTcpClient(host, port=modbus_port)
 
         internal_data_assemblies, mappings, assignments = load_register_mappings(
-            config_path, dict(self.data_assemblies)
+            config_path,
+            dict(self.data_assemblies),
         )
         if mtp:
             matching_data_assemblies = self._matching_requirement_data_assemblies(
-                internal_data_assemblies
+                internal_data_assemblies,
             )
             for mapping in mappings:
                 matching_data_assembly = matching_data_assemblies.get(
-                    mapping.data_assembly.tag_name
+                    mapping.data_assembly.tag_name,
                 )
                 if matching_data_assembly is not None:
                     mapping.data_assembly = matching_data_assembly
@@ -71,7 +74,8 @@ class M15Pea(UserLogicPEA):
         self._assign_data_assemblies(assignments, internal_data_assemblies)
 
     def _matching_requirement_data_assemblies(
-        self, modbus_data_assemblies: dict[str, DataAssembly]
+        self,
+        modbus_data_assemblies: dict[str, DataAssembly],
     ) -> dict[str, DataAssembly]:
         """Validate and return rMTP assemblies matching Modbus configuration.
 
@@ -89,14 +93,15 @@ class M15Pea(UserLogicPEA):
             requirement_data_assembly = self.data_assemblies.get(tag_name)
             if requirement_data_assembly is None:
                 logger.warning(
-                    f"Modbus DataAssembly {tag_name!r} is missing from requirements MTP"
+                    f"Modbus DataAssembly {tag_name!r} is missing from "
+                    "requirements MTP",
                 )
                 continue
             if type(requirement_data_assembly) is not type(modbus_data_assembly):
                 logger.warning(
                     f"Modbus DataAssembly {tag_name!r} has class "
                     f"{type(modbus_data_assembly).__name__}, but requirements MTP "
-                    f"defines {type(requirement_data_assembly).__name__}"
+                    f"defines {type(requirement_data_assembly).__name__}",
                 )
                 continue
             matching_data_assemblies[tag_name] = requirement_data_assembly
@@ -117,19 +122,19 @@ class M15Pea(UserLogicPEA):
             procedure = self._find_procedure(procedure_name)
             if procedure is None:
                 logger.critical(
-                    f"procedure {procedure_name!r} not found for assignment"
+                    f"procedure {procedure_name!r} not found for assignment",
                 )
                 continue
             for tag_name in tag_names:
                 if tag_name not in data_assemblies:
                     logger.critical(
                         f"DataAssembly {tag_name!r} not found for assignment "
-                        f"to procedure {procedure_name!r}"
+                        f"to procedure {procedure_name!r}",
                     )
                     continue
                 procedure.add_required_equipment(data_assemblies[tag_name])
 
-    def _find_procedure(self, name: str):
+    def _find_procedure(self, name: str) -> Procedure | None:
         """Find a procedure by name among all registered services.
 
         Args:
@@ -147,7 +152,8 @@ class M15Pea(UserLogicPEA):
     def start(self) -> None:
         """Start the OPC UA server and the cyclic Modbus I/O service."""
         if not self.modbus_client.connect():
-            raise ConnectionError("unable to connect to the M15 Modbus server")
+            msg = "unable to connect to the M15 Modbus server"
+            raise ConnectionError(msg)
         super().start()
         self.io_service.activate_and_run()
 
@@ -175,7 +181,7 @@ def parse_args(args: list[str] | None = None) -> argparse.Namespace:
         "--user-logic",
         dest="user_logic",
         default="",
-        help="Python module containing the user logic",
+        help="Python module containing the application logic",
     )
     parser.add_argument(
         "-m",