motorcortex-python 1.0.0rc2__py3-none-any.whl → 1.0.2__py3-none-any.whl

motorcortex/__init__.py

@@ -181,6 +181,56 @@ def makeUrl(address: str, port: int | None) -> str:
     return address
 
 
+def _reconnect_state_update(
+        req: Any, sub: Any, state: "ConnectionState", *,
+        motorcortex_types: "MessageTypes",
+        login: Any,
+        password: Any,
+        token_interval_sec: float,
+        initial_connect_done: list,
+) -> None:
+    """Default ``state_update`` body for :func:`connect` in reconnect mode.
+
+    Fires on every state transition from the ``StateCallbackHandler``
+    worker thread. Only acts on the ``CONNECTION_OK`` edge *after* the
+    initial connect has completed — i.e. on a successful **reconnect**:
+
+    1. Try to restore the previous session via ``restoreSession(token)``.
+       Silent 5-second timeout + generic exception swallow — on any
+       failure we fall through to step 2 so a torn-down session never
+       leaves the reconnect half-authenticated.
+    2. Otherwise re-login with the originally supplied credentials.
+    3. Kick the token-refresh timer and resubscribe all existing groups
+       on the Subscribe side.
+
+    Extracted from a closure inside :func:`connect` so it can be
+    unit-tested without spinning up a real server. ``initial_connect_done``
+    is passed as a 1-element list so the caller (``connect``) can flip
+    the flag after the first successful connect without rebinding.
+    """
+    if state != ConnectionState.CONNECTION_OK or not initial_connect_done[0]:
+        return
+
+    restored = False
+    if req.token:
+        try:
+            restore_reply = req.restoreSession(req.token)
+            restore_msg = restore_reply.get(timeout_ms=5000)
+            motorcortex_msg = motorcortex_types.motorcortex()
+            if restore_msg and restore_msg.status == motorcortex_msg.OK:
+                restored = True
+                logger.debug("[SESSION] Session restored using token")
+        except Exception as e:
+            logger.debug(f"[SESSION] Token restore failed: {e}")
+
+    if not restored:
+        logger.debug("[SESSION] Falling back to login")
+        req.login(login, password).get()
+
+    req._startTokenRefresh(token_interval_sec)
+    sub.resubscribe()
+
+
 def connect(
         url: str,
         motorcortex_types: "MessageTypes",
@@ -233,26 +283,14 @@ def connect(
     if reconnect and not kwargs.get("state_update"):
 
         def stateUpdate(req, sub, state):
-            if state == ConnectionState.CONNECTION_OK and initial_connect_done[0]:
-                # Try to restore session using token, fall back to login
-                restored = False
-                if req.token:
-                    try:
-                        restore_reply = req.restoreSession(req.token)
-                        restore_msg = restore_reply.get(timeout_ms=5000)
-                        motorcortex_msg = motorcortex_types.motorcortex()
-                        if restore_msg and restore_msg.status == motorcortex_msg.OK:
-                            restored = True
-                            logger.debug("[SESSION] Session restored using token")
-                    except Exception as e:
-                        logger.debug(f"[SESSION] Token restore failed: {e}")
-
-                if not restored:
-                    logger.debug("[SESSION] Falling back to login")
-                    req.login(kwargs.get("login"), kwargs.get("password")).get()
-
-                req._startTokenRefresh(token_interval_sec)
-                sub.resubscribe()
+            _reconnect_state_update(
+                req, sub, state,
+                motorcortex_types=motorcortex_types,
+                login=kwargs.get("login"),
+                password=kwargs.get("password"),
+                token_interval_sec=token_interval_sec,
+                initial_connect_done=initial_connect_done,
+            )
 
         kwargs.update(state_update=stateUpdate)
 

motorcortex/_request_builders.py

@@ -21,7 +21,7 @@ from typing import Any, Optional, TYPE_CHECKING
 
 from motorcortex.setup_logger import logger
 
-if TYPE_CHECKING:
+if TYPE_CHECKING:  # pragma: no cover
     from motorcortex.message_types import MessageTypes
     from motorcortex.parameter_tree import ParameterTree
 

motorcortex/_request_utils.py

@@ -242,7 +242,7 @@ def _purge_stale_cache_files(path: str) -> None:
         try:
             os.unlink(match)
             logger.debug("[REQUEST] Evicted stale cache file: %s", entry)
-        except OSError:
+        except OSError:  # pragma: no cover
             pass
 
 
@@ -276,7 +276,7 @@ def save_parameter_tree_file(path: str, parameter_tree: Any) -> Any:
         with os.fdopen(fd, "w") as outfile:
             outfile.write(json.dumps(envelope))
         os.replace(tmp_path, path)
-    except Exception:
+    except Exception:  # pragma: no cover
         # Clean up the temp file if the rename never ran.
         if os.path.exists(tmp_path):
             try:

motorcortex/message_types.py

@@ -5,38 +5,23 @@
 #   All rights reserved. Copyright (c) 2016 VECTIONEER.
 #
 
-from __future__ import unicode_literals
 import motorcortex.motorcortex_pb2
 import logging
-import sys
 import os
+from importlib.machinery import SourceFileLoader
+from types import ModuleType
 
-if sys.version_info[0] >= 3:
-    from importlib.machinery import SourceFileLoader
 
-    if sys.version_info[1] < 4:
-        def importLibrary(name, path):
-            return SourceFileLoader(name, path).load_module()
-    else:
-        from types import ModuleType
+def importLibrary(name, path):
+    loader = SourceFileLoader(name, path)
+    mod = ModuleType(loader.name)
+    loader.exec_module(mod)
+    return mod
 
 
-        def importLibrary(name, path):
-            loader = SourceFileLoader(name, path)
-            mod = ModuleType(loader.name)
-            loader.exec_module(mod)
-            return mod
-else:
-    from builtins import bytes
-    from imp import load_source
-
-
-    def importLibrary(name, path):
-        return load_source(name, path)
-
 from json import load
 from inspect import ismodule
-from typing import Dict
+from typing import Any, Dict
 
 from collections import namedtuple
 import struct
@@ -270,7 +255,7 @@ class MessageTypes(object):
                     self._hashes_by_name[name] = hash
                     self._types_by_hash[hash] = PrimitiveTypes(name)
             logging.debug(f"Loaded types from {name}")
-        except Exception:
+        except Exception:  # pragma: no cover
             # Best-effort — not every namespace declares the enum we're
             # probing for. Swallowed by design, but scoped to Exception
             # so KeyboardInterrupt / SystemExit still propagate.
@@ -282,7 +267,7 @@ class MessageTypes(object):
             for key in enum.DESCRIPTOR.values:
                 setattr(module, key.name, key.number)
             logging.debug(f"Loaded enumerator {enum_name}")
-        except Exception:
+        except Exception:  # pragma: no cover
             # Same best-effort pattern as _loadPrimitives.
             pass
 
@@ -348,6 +333,27 @@ class MessageTypes(object):
 
         return None
 
+    def _safe_decode_value(self, info: Any, value_bytes: bytes) -> Any:
+        """Decode a parameter's value bytes, returning None on failure.
+
+        Failure modes we tolerate:
+        - Empty value bytes (server didn't provide value; e.g. some error paths).
+        - Unknown data_type hash (param info malformed or a type the SDK
+          doesn't have a decoder for).
+        - Decoder raises (corrupt bytes, length mismatch, etc.).
+
+        The caller checks status to decide whether to trust the returned value.
+        """
+        if not value_bytes:
+            return None
+        value_type = self._types_by_hash.get(info.data_type)
+        if value_type is None:
+            return None
+        try:
+            return value_type.decode(value_bytes, info.number_of_elements)
+        except Exception:
+            return None
+
     def decode(self, wire_data):
         """Decodes data received from the server"""
 
@@ -358,22 +364,23 @@ class MessageTypes(object):
         msg.ParseFromString(buf)
 
         if type_inst.decode_value == motorcortex_parameter_msg:
-            if msg.status == motorcortex.OK:
-                value_type = self._types_by_hash[msg.info.data_type]
-                return ParameterMsg(msg.header, msg.info, value_type.decode(msg.value, msg.info.number_of_elements),
-                                    motorcortex.OK)
-            else:
-                return ParameterMsg(msg.header, msg.info, None, msg.status)
+            # Always attempt to decode the value bytes. On non-OK status (e.g.
+            # TIMEOUT_WAITING_FOR_UPDATE) the server still provides the stale
+            # buffer contents for forensic use; preserve them and let the caller
+            # decide whether to use the value based on status + timestamp age.
+            return ParameterMsg(msg.header, msg.info,
+                                self._safe_decode_value(msg.info, msg.value),
+                                msg.status)
         elif type_inst.decode_value == motorcortex_parameter_list_msg:
             params = []
             for param in msg.params:
-                if msg.status == motorcortex.OK:
-                    value_type = self._types_by_hash[param.info.data_type]
-                    params.append(ParameterMsg(param.header, param.info,
-                                               value_type.decode(param.value, param.info.number_of_elements),
-                                               motorcortex.OK))
-                else:
-                    params.append(ParameterMsg(param.header, param.info, None, msg.status))
+                # Use the per-element status, not the outer ParameterListMsg status —
+                # individual elements can have their own status (e.g. one element
+                # times out while others succeed) and that distinction is the whole
+                # point of the typed status code.
+                params.append(ParameterMsg(param.header, param.info,
+                                           self._safe_decode_value(param.info, param.value),
+                                           param.status))
             return ParameterListMsg(msg.header, params)
 
         return msg

motorcortex/motorcortex_pb2.py

@@ -13,7 +13,7 @@ _sym_db = _symbol_database.Default()
 
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x11motorcortex.proto\x12\x0bmotorcortex\"i\n\x0fParameterOffset\x12\x36\n\x04type\x18\x01 \x02(\x0e\x32\x17.motorcortex.OffsetType:\x0fOFFSET_ELEMENTS\x12\x0e\n\x06offset\x18\x02 \x02(\r\x12\x0e\n\x06length\x18\x03 \x02(\r\"f\n\x05\x45rror\x12\x11\n\ttimestamp\x18\x01 \x02(\x06\x12\x14\n\x0c\x65rror_number\x18\x02 \x02(\x07\x12\x13\n\x0b\x65rror_level\x18\x03 \x02(\x07\x12\x11\n\tsubsystem\x18\x04 \x02(\x07\x12\x0c\n\x04info\x18\x05 \x02(\x07\"a\n\tErrorList\x12\"\n\x06\x65rrors\x18\x01 \x03(\x0b\x32\x12.motorcortex.Error\x12\x18\n\x10number_of_errors\x18\x02 \x02(\x07\x12\x16\n\x0eupdate_counter\x18\x03 \x02(\x07\"\x8a\x02\n\rParameterInfo\x12\n\n\x02id\x18\x01 \x02(\r\x12\x11\n\tdata_type\x18\x02 \x02(\r\x12\x11\n\tdata_size\x18\x03 \x02(\r\x12\x1a\n\x12number_of_elements\x18\x04 \x02(\r\x12\r\n\x05\x66lags\x18\x05 \x02(\r\x12\x13\n\x0bpermissions\x18\x06 \x02(\r\x12.\n\nparam_type\x18\x07 \x02(\x0e\x32\x1a.motorcortex.ParameterType\x12(\n\x08group_id\x18\x08 \x02(\x0e\x32\x16.motorcortex.UserGroup\x12\x1f\n\x04unit\x18\t \x02(\x0e\x32\x11.motorcortex.Unit\x12\x0c\n\x04path\x18\n \x02(\t\"\x94\x01\n\x12GroupParameterInfo\x12\r\n\x05index\x18\x01 \x02(\r\x12\x0e\n\x06offset\x18\x02 \x02(\r\x12\x0c\n\x04size\x18\x03 \x02(\r\x12(\n\x04info\x18\x04 \x02(\x0b\x32\x1a.motorcortex.ParameterInfo\x12\'\n\x06status\x18\x05 \x02(\x0e\x32\x17.motorcortex.StatusCode\"1\n\x06Header\x12\x14\n\x0c\x66rameCounter\x18\x01 \x02(\x07\x12\x11\n\ttimestamp\x18\x02 \x02(\x06\"Z\n\x08GroupMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12)\n\x06params\x18\x02 \x03(\x0b\x32\x19.motorcortex.ParameterMsg\"Y\n\tStatusMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\'\n\x06status\x18\x02 \x02(\x0e\x32\x17.motorcortex.StatusCode\"P\n\x08LoginMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05login\x18\x02 \x02(\t\x12\x10\n\x08password\x18\x03 \x02(\t\"9\n\x12GetSessionTokenMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\"n\n\x0fSessionTokenMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05token\x18\x02 \x02(\t\x12\'\n\x06status\x18\x03 \x02(\x0e\x32\x17.motorcortex.StatusCode\"G\n\x11RestoreSessionMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05token\x18\x02 \x02(\t\"0\n\tLogoutMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\":\n\x13GetParameterTreeMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\"\x9a\x01\n\x10ParameterTreeMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12*\n\x06params\x18\x02 \x03(\x0b\x32\x1a.motorcortex.ParameterInfo\x12\x0c\n\x04hash\x18\x03 \x02(\r\x12\'\n\x06status\x18\x04 \x02(\x0e\x32\x17.motorcortex.StatusCode\">\n\x17GetParameterTreeHashMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\"r\n\x14ParameterTreeHashMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04hash\x18\x02 \x02(\r\x12\'\n\x06status\x18\x03 \x02(\x0e\x32\x17.motorcortex.StatusCode\"h\n\x0e\x43reateGroupMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x13\n\x0b\x66rq_divider\x18\x02 \x02(\r\x12\r\n\x05\x61lias\x18\x03 \x02(\t\x12\r\n\x05paths\x18\x04 \x03(\t\"\xaa\x01\n\x0eGroupStatusMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\n\n\x02id\x18\x02 \x02(\r\x12\r\n\x05\x61lias\x18\x03 \x02(\t\x12/\n\x06params\x18\x04 \x03(\x0b\x32\x1f.motorcortex.GroupParameterInfo\x12\'\n\x06status\x18\x05 \x02(\x0e\x32\x17.motorcortex.StatusCode\"D\n\x0eRemoveGroupMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05\x61lias\x18\x02 \x02(\t\"D\n\x0fGetParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\"\x95\x01\n\x0cParameterMsg\x12\r\n\x05value\x18\x01 \x02(\x0c\x12#\n\x06header\x18\x02 \x01(\x0b\x32\x13.motorcortex.Header\x12(\n\x04info\x18\x03 \x01(\x0b\x32\x1a.motorcortex.ParameterInfo\x12\'\n\x06status\x18\x04 \x02(\x0e\x32\x17.motorcortex.StatusCode\"h\n\x13GetParameterListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06params\x18\x02 \x03(\x0b\x32\x1c.motorcortex.GetParameterMsg\"\x8b\x01\n\x10ParameterListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12)\n\x06params\x18\x02 \x03(\x0b\x32\x19.motorcortex.ParameterMsg\x12\'\n\x06status\x18\x03 \x02(\x0e\x32\x17.motorcortex.StatusCode\"\x81\x01\n\x0fSetParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06offset\x18\x02 \x01(\x0b\x32\x1c.motorcortex.ParameterOffset\x12\x0c\n\x04path\x18\x03 \x02(\t\x12\r\n\x05value\x18\x04 \x02(\x0c\"h\n\x13SetParameterListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06params\x18\x02 \x03(\x0b\x32\x1c.motorcortex.SetParameterMsg\"\x99\x01\n\x15OverwriteParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06offset\x18\x02 \x01(\x0b\x32\x1c.motorcortex.ParameterOffset\x12\x10\n\x08\x61\x63tivate\x18\x03 \x02(\x08\x12\x0c\n\x04path\x18\x04 \x02(\t\x12\r\n\x05value\x18\x05 \x02(\x0c\"H\n\x13ReleaseParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\"O\n\x07SaveMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\x12\x11\n\tfile_name\x18\x03 \x02(\t\"O\n\x07LoadMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\x12\x11\n\tfile_name\x18\x03 \x02(\t\"C\n\rConsoleCmdMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05value\x18\x02 \x02(\t\"b\n\x11\x43onsoleCmdListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12(\n\x04\x63mds\x18\x02 \x03(\x0b\x32\x1a.motorcortex.ConsoleCmdMsg*\xab\x02\n\x04Unit\x12\x12\n\x0eunit_undefined\x10\x00\x12\n\n\x06Length\x10\x0f\x12\x06\n\x02mm\x10\x01\x12\x05\n\x01m\x10\x02\x12\n\n\x05\x41ngle\x10\xf1\x01\x12\x07\n\x03rad\x10\x31\x12\x07\n\x03\x64\x65g\x10\x41\x12\t\n\x04Time\x10\xf2\x01\x12\x0b\n\x07nanosec\x10\x12\x12\x0c\n\x08microsec\x10\"\x12\x0c\n\x08millisec\x10\x32\x12\x07\n\x03sec\x10\x42\x12\x0b\n\x06Weight\x10\xf3\x01\x12\x08\n\x04gram\x10\x13\x12\x06\n\x02kg\x10#\x12\r\n\x08Velocity\x10\xf4\x01\x12\t\n\x05m_sec\x10\x14\x12\x0b\n\x07rad_sec\x10$\x12\x11\n\x0c\x41\x63\x63\x65leration\x10\xf5\x01\x12\n\n\x06m_sec2\x10\x15\x12\x0c\n\x08rad_sec2\x10%\x12\n\n\x05\x46orce\x10\xf6\x01\x12\x05\n\x01N\x10\x16\x12\x06\n\x02Nm\x10&\x12\x0b\n\x07percent\x10\x17*_\n\tUserGroup\x12\x18\n\x14user_group_undefined\x10\x00\x12\n\n\x06SYSTEM\x10\x01\x12\x11\n\rADMINISTRATOR\x10\x03\x12\x0c\n\x08OPERATOR\x10\x07\x12\x0b\n\x07MONITOR\x10\x0f*\xc4\x01\n\nPermission\x12\x18\n\x14permission_undefined\x10\x00\x12\x0e\n\tUSER_READ\x10\x80\x02\x12\x0f\n\nUSER_WRITE\x10\x80\x01\x12\x10\n\x0cUSER_EXECUTE\x10@\x12\x0e\n\nGROUP_READ\x10 \x12\x0f\n\x0bGROUP_WRITE\x10\x10\x12\x11\n\rGROUP_EXECUTE\x10\x08\x12\x0f\n\x0bOTHERS_READ\x10\x04\x12\x10\n\x0cOTHERS_WRITE\x10\x02\x12\x12\n\x0eOTHERS_EXECUTE\x10\x01*\xd4\x01\n\x08\x44\x61taType\x12\x17\n\x13\x64\x61ta_type_undefined\x10\x00\x12\x08\n\x04INT8\x10\x01\x12\t\n\x05UINT8\x10\x02\x12\t\n\x05INT16\x10\x03\x12\n\n\x06UINT16\x10\x04\x12\t\n\x05INT32\x10\x05\x12\n\n\x06UINT32\x10\x06\x12\t\n\x05INT64\x10\x07\x12\n\n\x06UINT64\x10\x08\x12\x08\n\x04\x42OOL\x10\t\x12\n\n\x05\x46LOAT\x10\x81\x02\x12\x0b\n\x06\x44OUBLE\x10\x82\x02\x12\t\n\x04\x43HAR\x10\x81\x04\x12\x0b\n\x06STRING\x10\x82\x04\x12\n\n\x05\x42YTES\x10\x99\t\x12\x0e\n\tUSER_TYPE\x10\x80\n*\x84\x01\n\rParameterType\x12\x18\n\x14param_type_undefined\x10\x00\x12\t\n\x05INPUT\x10\x01\x12\n\n\x06OUTPUT\x10\x10\x12\x0e\n\tPARAMETER\x10\x80\x02\x12\x17\n\x12PARAMETER_VOLATILE\x10\x81\x02\x12\x19\n\x14PARAMETER_PERSISTENT\x10\x82\x02*\x9a\x02\n\nStatusCode\x12\x06\n\x02OK\x10\x00\x12\x12\n\x0eREAD_ONLY_MODE\x10\x01\x12\x0c\n\x06\x46\x41ILED\x10\x80\xfe\x03\x12\x15\n\x10\x46\x41ILED_TO_DECODE\x10\x80 \x12\x15\n\x10SUB_LIST_IS_FULL\x10\x80\"\x12\x19\n\x14WRONG_PARAMETER_PATH\x10\x80$\x12 \n\x1b\x46\x41ILED_TO_SET_REQUESTED_FRQ\x10\x80&\x12\x18\n\x13\x46\x41ILED_TO_OPEN_FILE\x10\x80(\x12\x17\n\x12GROUP_LIST_IS_FULL\x10\x80*\x12\x13\n\x0eWRONG_PASSWORD\x10\x80\x42\x12\x17\n\x12USER_NOT_LOGGED_IN\x10\x80\x44\x12\x16\n\x11PERMISSION_DENIED\x10\x80\x46*v\n\nErrorLevel\x12\x19\n\x15\x65rror_level_undefined\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x0b\n\x07WARNING\x10\x02\x12\x14\n\x10\x46ORCED_DISENGAGE\x10\x03\x12\x0c\n\x08SHUTDOWN\x10\x04\x12\x12\n\x0e\x45MERGENCY_STOP\x10\x05*_\n\nOffsetType\x12\x19\n\x15offset_type_undefined\x10\x00\x12\x13\n\x0fOFFSET_ELEMENTS\x10\x01\x12\x10\n\x0cOFFSET_BYTES\x10\x02\x12\x0f\n\x0bOFFSET_BITS\x10\x03*<\n\rParameterFlag\x12\x12\n\x0eLINK_IS_ACTIVE\x10\x01\x12\x17\n\x13OVERWRITE_IS_ACTIVE\x10\x02')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x11motorcortex.proto\x12\x0bmotorcortex\"i\n\x0fParameterOffset\x12\x36\n\x04type\x18\x01 \x02(\x0e\x32\x17.motorcortex.OffsetType:\x0fOFFSET_ELEMENTS\x12\x0e\n\x06offset\x18\x02 \x02(\r\x12\x0e\n\x06length\x18\x03 \x02(\r\"f\n\x05\x45rror\x12\x11\n\ttimestamp\x18\x01 \x02(\x06\x12\x14\n\x0c\x65rror_number\x18\x02 \x02(\x07\x12\x13\n\x0b\x65rror_level\x18\x03 \x02(\x07\x12\x11\n\tsubsystem\x18\x04 \x02(\x07\x12\x0c\n\x04info\x18\x05 \x02(\x07\"a\n\tErrorList\x12\"\n\x06\x65rrors\x18\x01 \x03(\x0b\x32\x12.motorcortex.Error\x12\x18\n\x10number_of_errors\x18\x02 \x02(\x07\x12\x16\n\x0eupdate_counter\x18\x03 \x02(\x07\"\x8a\x02\n\rParameterInfo\x12\n\n\x02id\x18\x01 \x02(\r\x12\x11\n\tdata_type\x18\x02 \x02(\r\x12\x11\n\tdata_size\x18\x03 \x02(\r\x12\x1a\n\x12number_of_elements\x18\x04 \x02(\r\x12\r\n\x05\x66lags\x18\x05 \x02(\r\x12\x13\n\x0bpermissions\x18\x06 \x02(\r\x12.\n\nparam_type\x18\x07 \x02(\x0e\x32\x1a.motorcortex.ParameterType\x12(\n\x08group_id\x18\x08 \x02(\x0e\x32\x16.motorcortex.UserGroup\x12\x1f\n\x04unit\x18\t \x02(\x0e\x32\x11.motorcortex.Unit\x12\x0c\n\x04path\x18\n \x02(\t\"\x94\x01\n\x12GroupParameterInfo\x12\r\n\x05index\x18\x01 \x02(\r\x12\x0e\n\x06offset\x18\x02 \x02(\r\x12\x0c\n\x04size\x18\x03 \x02(\r\x12(\n\x04info\x18\x04 \x02(\x0b\x32\x1a.motorcortex.ParameterInfo\x12\'\n\x06status\x18\x05 \x02(\x0e\x32\x17.motorcortex.StatusCode\"1\n\x06Header\x12\x14\n\x0c\x66rameCounter\x18\x01 \x02(\x07\x12\x11\n\ttimestamp\x18\x02 \x02(\x06\"Z\n\x08GroupMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12)\n\x06params\x18\x02 \x03(\x0b\x32\x19.motorcortex.ParameterMsg\"Y\n\tStatusMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\'\n\x06status\x18\x02 \x02(\x0e\x32\x17.motorcortex.StatusCode\"P\n\x08LoginMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05login\x18\x02 \x02(\t\x12\x10\n\x08password\x18\x03 \x02(\t\"9\n\x12GetSessionTokenMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\"n\n\x0fSessionTokenMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05token\x18\x02 \x02(\t\x12\'\n\x06status\x18\x03 \x02(\x0e\x32\x17.motorcortex.StatusCode\"G\n\x11RestoreSessionMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05token\x18\x02 \x02(\t\"0\n\tLogoutMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\":\n\x13GetParameterTreeMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\"\x9a\x01\n\x10ParameterTreeMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12*\n\x06params\x18\x02 \x03(\x0b\x32\x1a.motorcortex.ParameterInfo\x12\x0c\n\x04hash\x18\x03 \x02(\r\x12\'\n\x06status\x18\x04 \x02(\x0e\x32\x17.motorcortex.StatusCode\">\n\x17GetParameterTreeHashMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\"r\n\x14ParameterTreeHashMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04hash\x18\x02 \x02(\r\x12\'\n\x06status\x18\x03 \x02(\x0e\x32\x17.motorcortex.StatusCode\"h\n\x0e\x43reateGroupMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x13\n\x0b\x66rq_divider\x18\x02 \x02(\r\x12\r\n\x05\x61lias\x18\x03 \x02(\t\x12\r\n\x05paths\x18\x04 \x03(\t\"\xaa\x01\n\x0eGroupStatusMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\n\n\x02id\x18\x02 \x02(\r\x12\r\n\x05\x61lias\x18\x03 \x02(\t\x12/\n\x06params\x18\x04 \x03(\x0b\x32\x1f.motorcortex.GroupParameterInfo\x12\'\n\x06status\x18\x05 \x02(\x0e\x32\x17.motorcortex.StatusCode\"D\n\x0eRemoveGroupMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05\x61lias\x18\x02 \x02(\t\"D\n\x0fGetParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\"\x95\x01\n\x0cParameterMsg\x12\r\n\x05value\x18\x01 \x02(\x0c\x12#\n\x06header\x18\x02 \x01(\x0b\x32\x13.motorcortex.Header\x12(\n\x04info\x18\x03 \x01(\x0b\x32\x1a.motorcortex.ParameterInfo\x12\'\n\x06status\x18\x04 \x02(\x0e\x32\x17.motorcortex.StatusCode\"h\n\x13GetParameterListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06params\x18\x02 \x03(\x0b\x32\x1c.motorcortex.GetParameterMsg\"\x8b\x01\n\x10ParameterListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12)\n\x06params\x18\x02 \x03(\x0b\x32\x19.motorcortex.ParameterMsg\x12\'\n\x06status\x18\x03 \x02(\x0e\x32\x17.motorcortex.StatusCode\"\x81\x01\n\x0fSetParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06offset\x18\x02 \x01(\x0b\x32\x1c.motorcortex.ParameterOffset\x12\x0c\n\x04path\x18\x03 \x02(\t\x12\r\n\x05value\x18\x04 \x02(\x0c\"h\n\x13SetParameterListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06params\x18\x02 \x03(\x0b\x32\x1c.motorcortex.SetParameterMsg\"\x99\x01\n\x15OverwriteParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06offset\x18\x02 \x01(\x0b\x32\x1c.motorcortex.ParameterOffset\x12\x10\n\x08\x61\x63tivate\x18\x03 \x02(\x08\x12\x0c\n\x04path\x18\x04 \x02(\t\x12\r\n\x05value\x18\x05 \x02(\x0c\"H\n\x13ReleaseParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\"O\n\x07SaveMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\x12\x11\n\tfile_name\x18\x03 \x02(\t\"O\n\x07LoadMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\x12\x11\n\tfile_name\x18\x03 \x02(\t\"C\n\rConsoleCmdMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05value\x18\x02 \x02(\t\"b\n\x11\x43onsoleCmdListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12(\n\x04\x63mds\x18\x02 \x03(\x0b\x32\x1a.motorcortex.ConsoleCmdMsg*\xab\x02\n\x04Unit\x12\x12\n\x0eunit_undefined\x10\x00\x12\n\n\x06Length\x10\x0f\x12\x06\n\x02mm\x10\x01\x12\x05\n\x01m\x10\x02\x12\n\n\x05\x41ngle\x10\xf1\x01\x12\x07\n\x03rad\x10\x31\x12\x07\n\x03\x64\x65g\x10\x41\x12\t\n\x04Time\x10\xf2\x01\x12\x0b\n\x07nanosec\x10\x12\x12\x0c\n\x08microsec\x10\"\x12\x0c\n\x08millisec\x10\x32\x12\x07\n\x03sec\x10\x42\x12\x0b\n\x06Weight\x10\xf3\x01\x12\x08\n\x04gram\x10\x13\x12\x06\n\x02kg\x10#\x12\r\n\x08Velocity\x10\xf4\x01\x12\t\n\x05m_sec\x10\x14\x12\x0b\n\x07rad_sec\x10$\x12\x11\n\x0c\x41\x63\x63\x65leration\x10\xf5\x01\x12\n\n\x06m_sec2\x10\x15\x12\x0c\n\x08rad_sec2\x10%\x12\n\n\x05\x46orce\x10\xf6\x01\x12\x05\n\x01N\x10\x16\x12\x06\n\x02Nm\x10&\x12\x0b\n\x07percent\x10\x17*_\n\tUserGroup\x12\x18\n\x14user_group_undefined\x10\x00\x12\n\n\x06SYSTEM\x10\x01\x12\x11\n\rADMINISTRATOR\x10\x03\x12\x0c\n\x08OPERATOR\x10\x07\x12\x0b\n\x07MONITOR\x10\x0f*\xc4\x01\n\nPermission\x12\x18\n\x14permission_undefined\x10\x00\x12\x0e\n\tUSER_READ\x10\x80\x02\x12\x0f\n\nUSER_WRITE\x10\x80\x01\x12\x10\n\x0cUSER_EXECUTE\x10@\x12\x0e\n\nGROUP_READ\x10 \x12\x0f\n\x0bGROUP_WRITE\x10\x10\x12\x11\n\rGROUP_EXECUTE\x10\x08\x12\x0f\n\x0bOTHERS_READ\x10\x04\x12\x10\n\x0cOTHERS_WRITE\x10\x02\x12\x12\n\x0eOTHERS_EXECUTE\x10\x01*\xd4\x01\n\x08\x44\x61taType\x12\x17\n\x13\x64\x61ta_type_undefined\x10\x00\x12\x08\n\x04INT8\x10\x01\x12\t\n\x05UINT8\x10\x02\x12\t\n\x05INT16\x10\x03\x12\n\n\x06UINT16\x10\x04\x12\t\n\x05INT32\x10\x05\x12\n\n\x06UINT32\x10\x06\x12\t\n\x05INT64\x10\x07\x12\n\n\x06UINT64\x10\x08\x12\x08\n\x04\x42OOL\x10\t\x12\n\n\x05\x46LOAT\x10\x81\x02\x12\x0b\n\x06\x44OUBLE\x10\x82\x02\x12\t\n\x04\x43HAR\x10\x81\x04\x12\x0b\n\x06STRING\x10\x82\x04\x12\n\n\x05\x42YTES\x10\x99\t\x12\x0e\n\tUSER_TYPE\x10\x80\n*\x84\x01\n\rParameterType\x12\x18\n\x14param_type_undefined\x10\x00\x12\t\n\x05INPUT\x10\x01\x12\n\n\x06OUTPUT\x10\x10\x12\x0e\n\tPARAMETER\x10\x80\x02\x12\x17\n\x12PARAMETER_VOLATILE\x10\x81\x02\x12\x19\n\x14PARAMETER_PERSISTENT\x10\x82\x02*\xbb\x02\n\nStatusCode\x12\x06\n\x02OK\x10\x00\x12\x12\n\x0eREAD_ONLY_MODE\x10\x01\x12\x0c\n\x06\x46\x41ILED\x10\x80\xfe\x03\x12\x15\n\x10\x46\x41ILED_TO_DECODE\x10\x80 \x12\x15\n\x10SUB_LIST_IS_FULL\x10\x80\"\x12\x19\n\x14WRONG_PARAMETER_PATH\x10\x80$\x12 \n\x1b\x46\x41ILED_TO_SET_REQUESTED_FRQ\x10\x80&\x12\x18\n\x13\x46\x41ILED_TO_OPEN_FILE\x10\x80(\x12\x17\n\x12GROUP_LIST_IS_FULL\x10\x80*\x12\x1f\n\x1aTIMEOUT_WAITING_FOR_UPDATE\x10\x80,\x12\x13\n\x0eWRONG_PASSWORD\x10\x80\x42\x12\x17\n\x12USER_NOT_LOGGED_IN\x10\x80\x44\x12\x16\n\x11PERMISSION_DENIED\x10\x80\x46*v\n\nErrorLevel\x12\x19\n\x15\x65rror_level_undefined\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x0b\n\x07WARNING\x10\x02\x12\x14\n\x10\x46ORCED_DISENGAGE\x10\x03\x12\x0c\n\x08SHUTDOWN\x10\x04\x12\x12\n\x0e\x45MERGENCY_STOP\x10\x05*_\n\nOffsetType\x12\x19\n\x15offset_type_undefined\x10\x00\x12\x13\n\x0fOFFSET_ELEMENTS\x10\x01\x12\x10\n\x0cOFFSET_BYTES\x10\x02\x12\x0f\n\x0bOFFSET_BITS\x10\x03*<\n\rParameterFlag\x12\x12\n\x0eLINK_IS_ACTIVE\x10\x01\x12\x17\n\x13OVERWRITE_IS_ACTIVE\x10\x02')
 
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, globals())
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'motorcortex_pb2', globals())
@@ -31,13 +31,13 @@ if _descriptor._USE_C_DESCRIPTORS == False:
   _PARAMETERTYPE._serialized_start=4203
   _PARAMETERTYPE._serialized_end=4335
   _STATUSCODE._serialized_start=4338
-  _STATUSCODE._serialized_end=4620
-  _ERRORLEVEL._serialized_start=4622
-  _ERRORLEVEL._serialized_end=4740
-  _OFFSETTYPE._serialized_start=4742
-  _OFFSETTYPE._serialized_end=4837
-  _PARAMETERFLAG._serialized_start=4839
-  _PARAMETERFLAG._serialized_end=4899
+  _STATUSCODE._serialized_end=4653
+  _ERRORLEVEL._serialized_start=4655
+  _ERRORLEVEL._serialized_end=4773
+  _OFFSETTYPE._serialized_start=4775
+  _OFFSETTYPE._serialized_end=4870
+  _PARAMETERFLAG._serialized_start=4872
+  _PARAMETERFLAG._serialized_end=4932
   _PARAMETEROFFSET._serialized_start=34
   _PARAMETEROFFSET._serialized_end=139
   _ERROR._serialized_start=141

motorcortex/motorcortex_pb2.pyi

@@ -19,10 +19,10 @@ import builtins as _builtins
 import sys
 import typing as _typing
 
-if sys.version_info >= (3, 10):
-    from typing import TypeAlias as _TypeAlias
+if sys.version_info >= (3, 11):
+    from typing import TypeAlias as _TypeAlias, Never as _Never
 else:
-    from typing_extensions import TypeAlias as _TypeAlias
+    from typing_extensions import TypeAlias as _TypeAlias, Never as _Never
 
 DESCRIPTOR: _descriptor.FileDescriptor
 
@@ -399,6 +399,8 @@ class _StatusCodeEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_StatusCode
     """Failed to open/save/load a file."""
     GROUP_LIST_IS_FULL: _StatusCode.ValueType  # 5376
     """Failed to create new group, because the group list is full. Release at least one group."""
+    TIMEOUT_WAITING_FOR_UPDATE: _StatusCode.ValueType  # 5632
+    """GetParameter wait deadline expired before a fresh value was produced for the requested parameter."""
     WRONG_PASSWORD: _StatusCode.ValueType  # 8448
     """Login failed, wrong login or password."""
     USER_NOT_LOGGED_IN: _StatusCode.ValueType  # 8704
@@ -433,6 +435,8 @@ FAILED_TO_OPEN_FILE: StatusCode.ValueType  # 5120
 """Failed to open/save/load a file."""
 GROUP_LIST_IS_FULL: StatusCode.ValueType  # 5376
 """Failed to create new group, because the group list is full. Release at least one group."""
+TIMEOUT_WAITING_FOR_UPDATE: StatusCode.ValueType  # 5632
+"""GetParameter wait deadline expired before a fresh value was produced for the requested parameter."""
 WRONG_PASSWORD: StatusCode.ValueType  # 8448
 """Login failed, wrong login or password."""
 USER_NOT_LOGGED_IN: StatusCode.ValueType  # 8704
@@ -568,6 +572,7 @@ class ParameterOffset(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["length", b"length", "offset", b"offset", "type", b"type"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___ParameterOffset: _TypeAlias = ParameterOffset  # noqa: Y015
 
@@ -610,6 +615,7 @@ class Error(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["error_level", b"error_level", "error_number", b"error_number", "info", b"info", "subsystem", b"subsystem", "timestamp", b"timestamp"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___Error: _TypeAlias = Error  # noqa: Y015
 
@@ -647,6 +653,7 @@ class ErrorList(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["errors", b"errors", "number_of_errors", b"number_of_errors", "update_counter", b"update_counter"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___ErrorList: _TypeAlias = ErrorList  # noqa: Y015
 
@@ -709,6 +716,7 @@ class ParameterInfo(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["data_size", b"data_size", "data_type", b"data_type", "flags", b"flags", "group_id", b"group_id", "id", b"id", "number_of_elements", b"number_of_elements", "param_type", b"param_type", "path", b"path", "permissions", b"permissions", "unit", b"unit"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___ParameterInfo: _TypeAlias = ParameterInfo  # noqa: Y015
 
@@ -753,6 +761,7 @@ class GroupParameterInfo(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["index", b"index", "info", b"info", "offset", b"offset", "size", b"size", "status", b"status"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___GroupParameterInfo: _TypeAlias = GroupParameterInfo  # noqa: Y015
 
@@ -781,6 +790,7 @@ class Header(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["frameCounter", b"frameCounter", "timestamp", b"timestamp"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___Header: _TypeAlias = Header  # noqa: Y015
 
@@ -813,6 +823,7 @@ class GroupMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "params", b"params"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___GroupMsg: _TypeAlias = GroupMsg  # noqa: Y015
 
@@ -847,6 +858,7 @@ class StatusMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "status", b"status"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___StatusMsg: _TypeAlias = StatusMsg  # noqa: Y015
 
@@ -893,6 +905,7 @@ class LoginMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "login", b"login", "password", b"password"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___LoginMsg: _TypeAlias = LoginMsg  # noqa: Y015
 
@@ -923,6 +936,7 @@ class GetSessionTokenMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___GetSessionTokenMsg: _TypeAlias = GetSessionTokenMsg  # noqa: Y015
 
@@ -971,6 +985,7 @@ class SessionTokenMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "status", b"status", "token", b"token"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___SessionTokenMsg: _TypeAlias = SessionTokenMsg  # noqa: Y015
 
@@ -1015,6 +1030,7 @@ class RestoreSessionMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "token", b"token"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___RestoreSessionMsg: _TypeAlias = RestoreSessionMsg  # noqa: Y015
 
@@ -1051,6 +1067,7 @@ class LogoutMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___LogoutMsg: _TypeAlias = LogoutMsg  # noqa: Y015
 
@@ -1085,6 +1102,7 @@ class GetParameterTreeMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___GetParameterTreeMsg: _TypeAlias = GetParameterTreeMsg  # noqa: Y015
 
@@ -1132,6 +1150,7 @@ class ParameterTreeMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["hash", b"hash", "header", b"header", "params", b"params", "status", b"status"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___ParameterTreeMsg: _TypeAlias = ParameterTreeMsg  # noqa: Y015
 
@@ -1171,6 +1190,7 @@ class GetParameterTreeHashMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___GetParameterTreeHashMsg: _TypeAlias = GetParameterTreeHashMsg  # noqa: Y015
 
@@ -1215,6 +1235,7 @@ class ParameterTreeHashMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["hash", b"hash", "header", b"header", "status", b"status"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___ParameterTreeHashMsg: _TypeAlias = ParameterTreeHashMsg  # noqa: Y015
 
@@ -1279,6 +1300,7 @@ class CreateGroupMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["alias", b"alias", "frq_divider", b"frq_divider", "header", b"header", "paths", b"paths"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___CreateGroupMsg: _TypeAlias = CreateGroupMsg  # noqa: Y015
 
@@ -1337,6 +1359,7 @@ class GroupStatusMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["alias", b"alias", "header", b"header", "id", b"id", "params", b"params", "status", b"status"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___GroupStatusMsg: _TypeAlias = GroupStatusMsg  # noqa: Y015
 
@@ -1379,6 +1402,7 @@ class RemoveGroupMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["alias", b"alias", "header", b"header"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___RemoveGroupMsg: _TypeAlias = RemoveGroupMsg  # noqa: Y015
 
@@ -1419,6 +1443,7 @@ class GetParameterMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "path", b"path"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___GetParameterMsg: _TypeAlias = GetParameterMsg  # noqa: Y015
 
@@ -1471,6 +1496,7 @@ class ParameterMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "info", b"info", "status", b"status", "value", b"value"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___ParameterMsg: _TypeAlias = ParameterMsg  # noqa: Y015
 
@@ -1513,6 +1539,7 @@ class GetParameterListMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "params", b"params"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___GetParameterListMsg: _TypeAlias = GetParameterListMsg  # noqa: Y015
 
@@ -1561,6 +1588,7 @@ class ParameterListMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "params", b"params", "status", b"status"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___ParameterListMsg: _TypeAlias = ParameterListMsg  # noqa: Y015
 
@@ -1617,6 +1645,7 @@ class SetParameterMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "offset", b"offset", "path", b"path", "value", b"value"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___SetParameterMsg: _TypeAlias = SetParameterMsg  # noqa: Y015
 
@@ -1665,6 +1694,7 @@ class SetParameterListMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "params", b"params"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___SetParameterListMsg: _TypeAlias = SetParameterListMsg  # noqa: Y015
 
@@ -1729,6 +1759,7 @@ class OverwriteParameterMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["activate", b"activate", "header", b"header", "offset", b"offset", "path", b"path", "value", b"value"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___OverwriteParameterMsg: _TypeAlias = OverwriteParameterMsg  # noqa: Y015
 
@@ -1775,6 +1806,7 @@ class ReleaseParameterMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "path", b"path"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___ReleaseParameterMsg: _TypeAlias = ReleaseParameterMsg  # noqa: Y015
 
@@ -1825,6 +1857,7 @@ class SaveMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["file_name", b"file_name", "header", b"header", "path", b"path"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___SaveMsg: _TypeAlias = SaveMsg  # noqa: Y015
 
@@ -1875,6 +1908,7 @@ class LoadMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["file_name", b"file_name", "header", b"header", "path", b"path"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___LoadMsg: _TypeAlias = LoadMsg  # noqa: Y015
 
@@ -1915,6 +1949,7 @@ class ConsoleCmdMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["header", b"header", "value", b"value"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___ConsoleCmdMsg: _TypeAlias = ConsoleCmdMsg  # noqa: Y015
 
@@ -1957,5 +1992,6 @@ class ConsoleCmdListMsg(_message.Message):
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
     _ClearFieldArgType: _TypeAlias = _typing.Literal["cmds", b"cmds", "header", b"header"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
 Global___ConsoleCmdListMsg: _TypeAlias = ConsoleCmdListMsg  # noqa: Y015

motorcortex/request.py

@@ -59,7 +59,7 @@ def _register_shutdown(inst: "Request") -> None:
     try:
         import threading
         threading._register_atexit(_close_at_exit, inst)  # type: ignore[attr-defined]
-    except (AttributeError, ImportError):
+    except (AttributeError, ImportError):  # pragma: no cover
         atexit.register(_close_at_exit, inst)
 
 

motorcortex/session.py

@@ -41,7 +41,7 @@ from typing import Any, Optional, Type, TYPE_CHECKING
 
 from motorcortex.exceptions import McxConnectionError
 
-if TYPE_CHECKING:
+if TYPE_CHECKING:  # pragma: no cover
     from motorcortex.request import Request, ConnectionState
     from motorcortex.subscribe import Subscribe
     from motorcortex.message_types import MessageTypes

motorcortex/subscribe.py

@@ -20,7 +20,7 @@ from motorcortex.setup_logger import logger
 from motorcortex.nng_url import NngUrl
 from motorcortex import _connection_state, _request_utils, _subscribe_dispatch
 
-if TYPE_CHECKING:
+if TYPE_CHECKING:  # pragma: no cover
     from motorcortex.message_types import MessageTypes
 
 
@@ -64,7 +64,7 @@ def _register_shutdown(inst: "Subscribe") -> None:
     try:
         import threading
         threading._register_atexit(_close_at_exit, inst)  # type: ignore[attr-defined]
-    except (AttributeError, ImportError):
+    except (AttributeError, ImportError):  # pragma: no cover
         atexit.register(_close_at_exit, inst)
 
 

motorcortex/subscription.py

@@ -272,8 +272,8 @@ class Subscription(object):
 
             Examples:
                   >>> def update(parameters):
-                  >>>   print(parameters) #list of Parameter tuples
-                  >>> ...
+                  >>>     # parameters is a list of Parameter tuples
+                  >>>     print(parameters)
                   >>> data_sub.notify(update)
 
         """

motorcortex/version.py

@@ -1 +1 @@
-__version__ = '1.0.0rc2'
+__version__ = '1.0.2'

{motorcortex_python-1.0.0rc2.dist-info → motorcortex_python-1.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: motorcortex-python
-Version: 1.0.0rc2
+Version: 1.0.2
 Summary: Python bindings for Motorcortex Engine
 Home-page: https://www.motorcortex.io
 Author: Alexey Zakharov

motorcortex_python-1.0.2.dist-info/RECORD

@@ -0,0 +1,28 @@
+motorcortex/__init__.py,sha256=eVuJIbn8gj549T1HZ7JKZ1i4gx0aibuOLJ-apB6CO3g,15204
+motorcortex/_connection_state.py,sha256=0jos75PAyMsN3ew6HRoRDbLY-lGCzDit-SiUR7ZvnlA,2203
+motorcortex/_request_builders.py,sha256=ZP-WKS56CkrpoKbpU6FEM5e5E_MAr_P2PEQPZYaS5ls,5265
+motorcortex/_request_utils.py,sha256=K8UCqgDx7DenZlY-l8zEqowIM0yiVPuLciTy9KX5wBY,12155
+motorcortex/_subscribe_dispatch.py,sha256=mPXSqo44RgGryLZabj5xmBd7riW154kA8fnCEQ3Mjho,2942
+motorcortex/exceptions.py,sha256=9xFscRC2yEO2AxesxJ15p6DimDVRIdOeCdj4gF0gahs,2239
+motorcortex/init_threads.py,sha256=rT0VRhdwQfI0ziTi_jeEaLxTzCtkgVo71gmQIeQyuv8,3343
+motorcortex/message_types.py,sha256=jUqAE1-jsZ4a3fL0FzEavBwyseklDF5GfQvxhQMOmH0,16261
+motorcortex/motorcortex_hash.json,sha256=727K4JXwdtqzkIPtlq7ROSVOKLEsy1za3D7IjlLqFpA,3572
+motorcortex/motorcortex_pb2.py,sha256=ySYY3aFY_t8DYPkNNmb8lMg4s3AOIc9zvO9d5bAfHvw,12839
+motorcortex/motorcortex_pb2.pyi,sha256=gaDUuFREaK0_Sp90fpNCsTjIirRjcI6cAco-El9Kmp4,72704
+motorcortex/nng_url.py,sha256=LXmeu_Z1Hn0_YkF4QqLN2SiEvG2_AvKlsYK1Cox_1RQ,1386
+motorcortex/parameter_tree.py,sha256=i9nyo40okT8Y8WfPF2M9FZmCo59oXWuu3PXxmfexFtU,2696
+motorcortex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+motorcortex/reply.py,sha256=GMTaDQ_jeu32H5Zl4LA2Smw_PzNuho2cLuzY-1vvJQ0,3889
+motorcortex/request.py,sha256=O0fnJDbUDS9y_SjJ8sPorU7nGQ3gr8RLDhBjGvnHpAY,26273
+motorcortex/session.py,sha256=yxn_qGXx4MTcFGYrrdl6QXWESv3anBlsioNMucvlHmI,7058
+motorcortex/setup_logger.py,sha256=ynWC2xMPC5lw_ubU1AL7lbuxm4VK2xqkLRNisAv_fZM,195
+motorcortex/state_callback_handler.py,sha256=Vr9XZ5vN7-CKJdvbJlFkenwH6JfhuInkM1RQvRnlhPY,3069
+motorcortex/subscribe.py,sha256=E4Hz03vF2Jgk1vXqhHf42Rd-y337Rt78zY70X2NrXeo,15755
+motorcortex/subscription.py,sha256=UTPmLOl41Tn3mRl3Hyam2R9bCg9D5y5EJsiChYERu5E,15425
+motorcortex/timespec.py,sha256=bZ-CD2EY0ALoWmJyluThxkiqfVCiGZqPPHRlKSvq7Fs,4573
+motorcortex/version.py,sha256=ZTipNH6wyC6qsq1H_lZsvJyVruUa1nu3y4EysMdkpuU,22
+motorcortex_python-1.0.2.dist-info/LICENSE,sha256=m5IaPTxipQwDCpY_YUD927y5QnUzqKGLVUY8E2KxDMk,1165
+motorcortex_python-1.0.2.dist-info/METADATA,sha256=ghM1WccanWR1oyGtsvnIW67hrU1QK2Y1fq5KjfaWjqA,6141
+motorcortex_python-1.0.2.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
+motorcortex_python-1.0.2.dist-info/top_level.txt,sha256=2Glsldo3S13fGB0ub_vogd7y-RQYYNXDjnm-qESmjBY,12
+motorcortex_python-1.0.2.dist-info/RECORD,,

{motorcortex_python-1.0.0rc2.dist-info → motorcortex_python-1.0.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.46.3)
+Generator: bdist_wheel (0.47.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

motorcortex_python-1.0.0rc2.dist-info/RECORD

@@ -1,28 +0,0 @@
-motorcortex/__init__.py,sha256=tB_kAiYoTroBlVUEyldv2EVYUX9uvNprGpeMW7lroE0,13874
-motorcortex/_connection_state.py,sha256=0jos75PAyMsN3ew6HRoRDbLY-lGCzDit-SiUR7ZvnlA,2203
-motorcortex/_request_builders.py,sha256=bMZAP1ko6jju1wXs5p6TCp4D93wbvSgpKRf3gvW9_Bg,5245
-motorcortex/_request_utils.py,sha256=npW68Mr8YJk6jGek3CDIAZoFGFULQwaIRhlnNW0aDeA,12115
-motorcortex/_subscribe_dispatch.py,sha256=mPXSqo44RgGryLZabj5xmBd7riW154kA8fnCEQ3Mjho,2942
-motorcortex/exceptions.py,sha256=9xFscRC2yEO2AxesxJ15p6DimDVRIdOeCdj4gF0gahs,2239
-motorcortex/init_threads.py,sha256=rT0VRhdwQfI0ziTi_jeEaLxTzCtkgVo71gmQIeQyuv8,3343
-motorcortex/message_types.py,sha256=FA9jcrHS8lf_KxMi4qF5-bTDvZoGRoZ4paPS8oCF35k,15643
-motorcortex/motorcortex_hash.json,sha256=727K4JXwdtqzkIPtlq7ROSVOKLEsy1za3D7IjlLqFpA,3572
-motorcortex/motorcortex_pb2.py,sha256=bMRS3TcCJMbBGYqGKnmTiQZaTmpbiJv0iYU3EF8s29Q,12790
-motorcortex/motorcortex_pb2.pyi,sha256=8mxofEtlFESwybu9eeo_i5iMw35eNqsmr2DjHU9pg1k,70451
-motorcortex/nng_url.py,sha256=LXmeu_Z1Hn0_YkF4QqLN2SiEvG2_AvKlsYK1Cox_1RQ,1386
-motorcortex/parameter_tree.py,sha256=i9nyo40okT8Y8WfPF2M9FZmCo59oXWuu3PXxmfexFtU,2696
-motorcortex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-motorcortex/reply.py,sha256=GMTaDQ_jeu32H5Zl4LA2Smw_PzNuho2cLuzY-1vvJQ0,3889
-motorcortex/request.py,sha256=r16i1CZOl8qVvSrVNqMocdsOQCjiKw21XfKtN6PqMc0,26253
-motorcortex/session.py,sha256=d5V3q5S5cATJ4Dm9W-lZo388o98ccX48B1fAjgQZ-5U,7038
-motorcortex/setup_logger.py,sha256=ynWC2xMPC5lw_ubU1AL7lbuxm4VK2xqkLRNisAv_fZM,195
-motorcortex/state_callback_handler.py,sha256=Vr9XZ5vN7-CKJdvbJlFkenwH6JfhuInkM1RQvRnlhPY,3069
-motorcortex/subscribe.py,sha256=A0lFkkFTqEh8vSdGvr1JBq25gjo-xh4Ai_kcoW4aPIA,15715
-motorcortex/subscription.py,sha256=n_7OKE_u-Sz0T49S54RuYXlJ2uzXPFzxeXIGg91lfLM,15406
-motorcortex/timespec.py,sha256=bZ-CD2EY0ALoWmJyluThxkiqfVCiGZqPPHRlKSvq7Fs,4573
-motorcortex/version.py,sha256=HSDW64W4Mh5MIMnoVrIKrC33CHH7K3FbyThUjjRUJgE,25
-motorcortex_python-1.0.0rc2.dist-info/LICENSE,sha256=m5IaPTxipQwDCpY_YUD927y5QnUzqKGLVUY8E2KxDMk,1165
-motorcortex_python-1.0.0rc2.dist-info/METADATA,sha256=oKj46hEnPen9bc0IiWBcu_pcQ82AM0R9TYZW0Y_VPUs,6144
-motorcortex_python-1.0.0rc2.dist-info/WHEEL,sha256=hPN0AlP2dZM_3ZJZWP4WooepkmU9wzjGgCLCeFjkHLA,92
-motorcortex_python-1.0.0rc2.dist-info/top_level.txt,sha256=2Glsldo3S13fGB0ub_vogd7y-RQYYNXDjnm-qESmjBY,12
-motorcortex_python-1.0.0rc2.dist-info/RECORD,,