plantstar-shared 2.0.3.0.2.12__py3-none-any.whl → 2.0.3.0.2.14__py3-none-any.whl

plantstar_shared/api_types.py

@@ -97,6 +97,8 @@ class DataCollectionModuleApiTypes(SysconType):
 class ApuApiTypes(SysconType):
     SET_IS_INITIALIZING_STATUS = ("data_collection_module_manager/set_is_initializing_status", "data_collection_module_manager/set_is_initializing_status", True)
     SET_IS_COLDBOOTING_STATUS = ("data_collection_module_manager/set_is_coldbooting_status", "data_collection_module_manager/set_is_coldbooting_status", True)
+    REGISTER_HMI = ("data_collection_module_manager/register_hmi", "data_collection_module_manager/register_hmi", True)
+    REGISTER_DCM = ("data_collection_module_manager/register_dcm", "data_collection_module_manager/register_dcm", True)
 
 
 class CosmosApiTypes(SysconType):

plantstar_shared/convert_bytes_to_object.py

@@ -2,9 +2,9 @@ import msgpack
 
 from plantstar_shared.errors import SocketConnectionError
 
-
 # Converts bytes into an object using msgpack, with a parameter for strict_map_key
 def convert_bytes_to_object(object_as_bytes, strict_map_key=False):
+    
     if not object_as_bytes:
         raise SocketConnectionError
     

plantstar_shared/tcp_socket_utils.py

@@ -2,86 +2,47 @@ import struct
 
 from plantstar_shared.convert_bytes_to_object import convert_bytes_to_object
 from plantstar_shared.convert_object_to_bytes import convert_object_to_bytes
-from plantstar_shared.errors import SocketConnectionError, SysconProgrammingError
+from plantstar_shared.errors import SocketConnectionError
 
-SIZE_OF_UNSIGNED_INT_FOR_HUSKY = 2  # size of the integer value that precedes data coming from Husky OIs
-SIZE_OF_UNSIGNED_INT_STRUCT = 4  # size of the integer value that precedes data coming from most sockets (DeviceController, DCM, etc)
+SIZE_OF_UNSIGNED_INT_STRUCT = 4
 
 
-def read_size_value_from_socket(*, remote_socket, is_big_endian, number_of_bytes_for_size_prefix):
-    size_bytes = remote_socket.recv(number_of_bytes_for_size_prefix)
+def read_size_value_from_socket(*, remote_socket):
+    size_struct = remote_socket.recv(SIZE_OF_UNSIGNED_INT_STRUCT)
 
-    if not size_bytes:
-        return None, None
-
-    if number_of_bytes_for_size_prefix == SIZE_OF_UNSIGNED_INT_FOR_HUSKY:
-        size_for_message = int.from_bytes(size_bytes, 'big') if is_big_endian else int.from_bytes(size_bytes, 'little')
-    elif number_of_bytes_for_size_prefix == SIZE_OF_UNSIGNED_INT_STRUCT:
-        number_format = ">I" if is_big_endian else "<I"
-
-        try:
-            size_for_message = struct.unpack(number_format, size_bytes)[0]
-        except struct.error as error:
-            raise SocketConnectionError
-    else:
-        raise SysconProgrammingError("A size prefix was set to something other than 2 or 4")
-
-    return size_for_message, size_bytes
-
-
-def get_bytes_from_socket(*, remote_socket, number_of_bytes_to_read=None, is_big_endian=True, number_of_bytes_for_size_prefix=0):
-    """Obtains a number of bytes from a provided socket, with options for different configurations and situations.
-    Returns byte sequence, and the size value that was obtained from the prefix bytes.
-
-    Keywords / Example Configurations:
-        remote_socket -- the connection that bytes will be read from
-
-        number_of_bytes_to_read -- the number of bytes to read on the socket, if this is known, this is the only optional parameter needed (default: 0)
-
-        is_big_endian -- bool that determines what format string should be used for unpacking the size value (default: True)
-
-        number_of_bytes_for_size_prefix -- the number of bytes to read to determine the total size of the message to pass (default: 0)
-
-        should_remove_prefix_size_from_read -- bool that determines if the size should be removed from the calculated number of bytes to read (default: False)
-
-        -----
-
-        get_bytes_from_socket(remote_socket=conn, number_of_bytes_to_read=100) - likely would not be called directly, in most cases
+    if not size_struct:
+        return None
 
-        get_bytes_from_socket(remote_socket=conn, is_big_endian=True, number_of_bytes_for_size_prefix=4) - reads 4 bytes to get the size, then reads that amount (DCM socket, etc)
+    try:
+        message_length = struct.unpack('>I', size_struct)[0]
+    except struct.error as error:
+        raise SocketConnectionError
 
-        get_bytes_from_socket(remote_socket=conn, is_big_endian=False, number_of_bytes_for_size_prefix=2, should_remove_prefix_size_from_read=True) - reads 2 bytes to get the size,
-        then reads that calculated amount minus 2 (Husky socket, etc)
+    return message_length
 
-    """
 
-    if not number_of_bytes_to_read:
-        if number_of_bytes_for_size_prefix:
-            number_of_bytes_to_read, size_bytes = read_size_value_from_socket(
-                remote_socket=remote_socket, is_big_endian=is_big_endian, number_of_bytes_for_size_prefix=number_of_bytes_for_size_prefix
-            )
+def get_message_from_socket(*, remote_socket):
+    message_length = read_size_value_from_socket(remote_socket=remote_socket)
 
-            if not number_of_bytes_to_read:
-                return None, None
-        else:
-            raise SysconProgrammingError("get_bytes_from_socket was called with no parameters for number_of_bytes_to_read or number_of_bytes_for_size_prefix")
+    if not message_length:
+        return None
 
     packets = []
     bytes_received = 0
 
     # While loop that will stream in data if the full request is not available yet
-    while bytes_received < number_of_bytes_to_read:
-        buffer_size = number_of_bytes_to_read - bytes_received
+    while bytes_received < message_length:
+        buffer_size = message_length - bytes_received
         packet = remote_socket.recv(buffer_size)
 
         if not packet:
-            return None, number_of_bytes_to_read
+            return None
 
         packets.append(packet)
         bytes_received = bytes_received + len(packet)
 
     data = b''.join(packets)
-    return data, number_of_bytes_to_read
+    return data
 
 
 def send_message_on_socket(*, remote_socket, dumpsable_object):
@@ -101,16 +62,7 @@ def send_encoded_message_on_socket(*, remote_socket, encoded_message):
         bytes_sent += new_bytes_sent
 
 
-def get_object_from_socket(
-    *, remote_socket, number_of_bytes_to_read=None, is_big_endian=True, number_of_bytes_for_size_prefix=SIZE_OF_UNSIGNED_INT_STRUCT
-):
-    """Function that is used between the APU and DCM to send dictionaries. Returns a tuple of the object and its size in bytes."""
-    object_from_interface_as_bytes, size_of_object_in_bytes = get_bytes_from_socket(
-        remote_socket=remote_socket, number_of_bytes_to_read=number_of_bytes_to_read, is_big_endian=is_big_endian, number_of_bytes_for_size_prefix=number_of_bytes_for_size_prefix
-    )
-
-    if not object_from_interface_as_bytes:
-        return None
-
+def get_object_from_socket(*, remote_socket):
+    object_from_interface_as_bytes = get_message_from_socket(remote_socket=remote_socket)
     object_from_interface = convert_bytes_to_object(object_from_interface_as_bytes)
-    return object_from_interface, size_of_object_in_bytes
+    return object_from_interface

{plantstar_shared-2.0.3.0.2.12.dist-info → plantstar_shared-2.0.3.0.2.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: plantstar-shared
-Version: 2.0.3.0.2.12
+Version: 2.0.3.0.2.14
 Summary: Shared code used in plantstar_apu and plantstar_dcm
 Home-page: https://github.com/SYSCON-International/plantstar_shared
 Author: SYSCON International

{plantstar_shared-2.0.3.0.2.12.dist-info → plantstar_shared-2.0.3.0.2.14.dist-info}/RECORD

@@ -5,8 +5,8 @@ plantstar_shared/RawDataProcessorInterfaceActions.py,sha256=XnXuFW3BFSa89-VmhGAK
 plantstar_shared/SysconType.py,sha256=6Ae9F0fBr0vpXAmP8fYqoWyFUGTEECtS55zAYMkeKlY,1581
 plantstar_shared/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plantstar_shared/add_size_onto_string_and_return.py,sha256=j7XSs5ubKKo5LCMVljzZudK2nw8CZh-zMSLT_t30aGg,385
-plantstar_shared/api_types.py,sha256=gKN2LmUFBcpa7gJSNwCJ0eSv4IqkIP01pCLfy8-mT50,5001
-plantstar_shared/convert_bytes_to_object.py,sha256=YKf410EWUpeyyeBhJ3kl6PYIAcHJKKkhp8JkE-CuSv0,405
+plantstar_shared/api_types.py,sha256=uoVePGb-C0fRtKpWcjiRK_Cvvfoh1izITDjkZ37ssXQ,5241
+plantstar_shared/convert_bytes_to_object.py,sha256=MVOKqJJeUjvEKJL_ELNPkxZEgqwlk3zT8CwfVtpwOgU,409
 plantstar_shared/convert_object_to_bytes.py,sha256=vVS3dKkPynOJ2NV2LgLHdEOZflK_0hhdS-NuU_gcfHs,206
 plantstar_shared/errors.py,sha256=qEUHh2d7pqZHoag6YJjnVfRWzWAzjuyGZH7stT_-Nzk,341
 plantstar_shared/global_definitions.py,sha256=mj59nU21DYza4XgZQxLX2lTvJYooN_-ZFrh8SVXFBRs,1153
@@ -14,8 +14,8 @@ plantstar_shared/is_valid_signed_string.py,sha256=5ZiEsPRz30J8yxN4A1dHq-hlz7VI9r
 plantstar_shared/obtain_raw_data_processor_function_for_action_name.py,sha256=DYo307PraRRD8zGiSO6Fn03bZ4X9aDOYV9rwaRm8mXM,1134
 plantstar_shared/syscon_image_field.py,sha256=GlTTudqFT5EsWM5sPRO0p5SDascX7gI1BEOeF1OG7Tw,441
 plantstar_shared/syscon_json.py,sha256=8OG9_55d52V9e2fFNguDtQ_pnw1YwyYsg2pnUkhjW6g,4213
-plantstar_shared/tcp_socket_utils.py,sha256=bW4KSKSTZLWyivdVZ0cIH4CN5Kw92CNa2xMj3fIZ7_U,5586
-plantstar_shared-2.0.3.0.2.12.dist-info/METADATA,sha256=bjxjBORuN81GgyCFuQ7bxShD1Hbh7ot7TsxuZQnFuUo,659
-plantstar_shared-2.0.3.0.2.12.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-plantstar_shared-2.0.3.0.2.12.dist-info/top_level.txt,sha256=9ZTCr_aP1GqYGt7EVmlSIUF72bdMZErapyhbik-MWVQ,17
-plantstar_shared-2.0.3.0.2.12.dist-info/RECORD,,
+plantstar_shared/tcp_socket_utils.py,sha256=sI5IJXMTsQuTPzm8V5T1nsY5aMF-78zGL69aIDLCD_A,2250
+plantstar_shared-2.0.3.0.2.14.dist-info/METADATA,sha256=LncRbvpfkol2OpHWakTI_fFAmpBsgAJnrNrQAlWCpu4,659
+plantstar_shared-2.0.3.0.2.14.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+plantstar_shared-2.0.3.0.2.14.dist-info/top_level.txt,sha256=9ZTCr_aP1GqYGt7EVmlSIUF72bdMZErapyhbik-MWVQ,17
+plantstar_shared-2.0.3.0.2.14.dist-info/RECORD,,