Implement TagVal parsers

Author: vzahradnik

tcmenu/__init__.py

@@ -6,4 +6,4 @@
     "__version__",
 ]
 
-__version__ = "4.1.1"
+__version__ = "4.1.2"

tcmenu/domain/edit_item_type.py

@@ -39,3 +39,7 @@ class EditItemType(Enum):
     @property
     def message_id(self):
         return self._value_
+
+    @staticmethod
+    def from_id(item_id: int):
+        return EditItemType(item_id) if item_id in (item.value for item in EditItemType) else EditItemType.PLAIN_TEXT

tcmenu/domain/menu_items.py

@@ -96,10 +96,18 @@ class BooleanMenuItem(MenuItem):
 
     # noinspection PyArgumentList
     class BooleanNaming(Enum):
-        ON_OFF = auto()
-        YES_NO = auto()
-        TRUE_FALSE = auto()
-        CHECKBOX = auto()
+        TRUE_FALSE = 0
+        ON_OFF = 1
+        YES_NO = 2
+        CHECKBOX = 3
+
+        @staticmethod
+        def from_id(item_id: int):
+            return (
+                BooleanMenuItem.BooleanNaming(item_id)
+                if item_id in (item.value for item in BooleanMenuItem.BooleanNaming)
+                else BooleanMenuItem.BooleanNaming.TRUE_FALSE
+            )
 
     """the naming for this boolean, that describes how to render the true/false choice."""
     naming: BooleanNaming = BooleanNaming.ON_OFF

tcmenu/domain/state/list_response.py

@@ -47,3 +47,6 @@ def from_string(value) -> Optional[ListResponse]:
             return ListResponse(row, response_type)
 
         return None
+
+
+ListResponse.EMPTY = ListResponse(0, ListResponse.ResponseType.SELECT_ITEM)

tcmenu/remote/commands/ack_status.py

@@ -40,3 +40,11 @@ def status_code(self) -> int:
     def is_error(self) -> bool:
         """:return: True if the status code is an error, otherwise False."""
         return self._value_.status_code > 0
+
+    @classmethod
+    def from_status_code(cls, status_code: int):
+        """Retrieve status based on numeric code."""
+        for status in cls:
+            if status.status_code == status_code:
+                return status
+        return AckStatus.UNKNOWN_ERROR

tcmenu/remote/commands/command_factory.py

@@ -226,7 +226,7 @@ def new_menu_text_boot_command(
 
     @staticmethod
     def new_menu_large_item_boot_command(
-        parent_id: int, item: EditableLargeNumberMenuItem, current_value: int
+        parent_id: int, item: EditableLargeNumberMenuItem, current_value: float
     ) -> MenuLargeNumBootCommand:
         """
         Create a new large number bootstrap command.

tcmenu/remote/commands/dialog_mode.py

@@ -15,3 +15,12 @@ class DialogMode(Enum):
 
     """ Perform the following action on the dialog. """
     ACTION = auto()
+
+    @staticmethod
+    def from_string(mode: str) -> "DialogMode":
+        if mode == "S":
+            return DialogMode.SHOW
+        elif mode == "H":
+            return DialogMode.HIDE
+        else:
+            return DialogMode.ACTION

tcmenu/remote/commands/menu_boot_commands.py

@@ -1,18 +1,21 @@
 from abc import ABC
 from dataclasses import dataclass
-from typing import Any, Optional
+from typing import Any, Optional, TypeVar, Generic
 
-from tcmenu.domain.menu_items import MenuItem
+from tcmenu.domain.menu_items import MenuItem, AnalogMenuItem
 from tcmenu.domain.state.menu_state import MenuState
 from tcmenu.domain.util.menu_item_helper import MenuItemHelper
 from tcmenu.remote.commands.menu_command import MenuCommand
 from tcmenu.remote.commands.menu_command_type import MenuCommandType
 from tcmenu.remote.protocol.message_field import MessageField
 
 
+T = TypeVar("T", bound=MenuItem)
+
+
 @dataclass(frozen=True)
-class BootItemMenuCommand(MenuCommand, ABC):
-    menu_item: MenuItem
+class BootItemMenuCommand(MenuCommand, ABC, Generic[T]):
+    menu_item: T
 
     current_value: Any
 

tcmenu/remote/commands/menu_button_type.py

@@ -32,3 +32,10 @@ def button_name(self) -> str:
     @property
     def type_value(self) -> int:
         return self._value_.type_value
+
+    @staticmethod
+    def from_id(button_id: int):
+        for button_type in MenuButtonType:
+            if button_type.type_value == button_id:
+                return button_type
+        return MenuButtonType.NONE

tcmenu/remote/commands/menu_change_command.py

@@ -16,6 +16,11 @@ class ChangeType(Enum):
         ABSOLUTE_LIST = 2
         LIST_STATE_CHANGE = 3
 
+        @classmethod
+        def from_id(cls, id_: int):
+            """Retrieve ChangeType based on numeric ID with a fallback to DELTA."""
+            return cls(id_) if id_ in cls._value2member_map_ else cls.DELTA
+
     menu_item_id: int
 
     correlation_id: CorrelationId