###########################################################################
#
# Copyright (c) 2021-2024 Diality Inc. - All Rights Reserved.
#
# THIS CODE MAY NOT BE COPIED OR REPRODUCED IN ANY FORM, IN PART OR IN
# WHOLE, WITHOUT THE EXPLICIT PERMISSION OF THE COPYRIGHT OWNER.
#
# @file    generic_defs.py
#
# @author  (last)      Zoltan Miskolci
# @date    (last)      04-May-2026
# @author  (last)      Zoltan Miskolci
# @date    (last)      01-May-2026
#
############################################################################

from enum import unique

from ..utils.enums import DialinEnum


@unique
class DataTypes(DialinEnum):
    NONE    = (0, None, 0)                                      # No Data Type                          - None
    U32     = (1, '<I', 4)                                      # Unsigned 32bit Data Type (4 bytes)    - Unsigned Integer (4 bytes) in Little Endian  -> Integer
    S32     = (2, '<i', 4)                                      # Signed 32bit Data Type (4 bytes)      - Signed Integer (4 bytes) in Little Endian  -> Integer
    F32     = (3, '<f', 4)                                      # Float 32bit Data Type (4 bytes)       - Float (4 bytes) in Little Endian  -> Float
    # Could use '<?', but it only works if the bool is 1 byte
    BOOL    = (4, '<I', 4)                                      # Boolean Data Type (4 bytes)           - Unsigned Integer (4 bytes) in Little Endian  -> Integer
    U08     = (5, '<B', 1)                                      # Unsigned 8bit Data Type (1 byte)      - Unsigned single Character (1 byte) in Little Endian -> Integer
    U16     = (6, '<H', 2)                                      # Unsigned 16bit Data Type (2 bytes)    - Unsigned Short Integer (2 bytes) in Little Endian -> Integer
    NUM_OF_DATA_TYPES = (7, None, 0)                            # Number of Data Types                  - None

    def __new__(cls, value, unpack_fmt, unpack_size):
        obj = object.__new__(cls)
        obj._value_ = value                 # keeps .value as int
        obj.unpack_fmt = unpack_fmt         # attach extra attribute
        obj.unpack_size = unpack_size         # attach extra attribute
        return obj

    def unpack_attrib(self) -> str:
        return self.unpack_fmt

    def size(self) -> int:
        return self.unpack_size

DataTypes._str_list = {
    # Official Name :               Accepted strings
    'NONE': [],
    'U32': [],
    'S32': [],
    'F32': [],
    'BOOL': ['boolean'],
    'U08': ['u8'],
    'U16': [],
    'NUM_OF_DATA_TYPES': [],
}