Update to the Selector to allow initial selection list and support setting the initial selection in the app.

Author: James Boulton

Documents/Documentation.md

@@ -497,6 +497,7 @@ Feedback to the user of the dashboard is achieved when the IoT device responds t
 * *control_position : ControlPosition, optional.* The position of the control on a DeviceView, by default None.
 * *title_position : TitlePosition, optional.* Position of the title when displayed on the **Dash** app, by default None.
 * *column_no : int.* Optional default is 1. Must be 1..3. The Dash App reports its screen size in columns. column_no allows you to specify which column no to load into. Each control can store three configs that define how the device looks for Dash apps installed on single column phones or 2 column fold out phones or 3 column tablets.
+* *selection : list, optional.* Optional. This selection list.
 
 #### Selector Message Attributes
 

dashio/iotcontrol/selector.py

@@ -26,6 +26,44 @@
 from .enums import TitlePosition
 
 
+class SelectorConfig(ControlConfig):
+    """SelectorConfig"""
+
+    def __init__(
+        self,
+        control_id: str,
+        title: str,
+        title_position: TitlePosition,
+        control_position: ControlPosition | None,
+        selection: list[str] | None = None
+    ) -> None:
+        super().__init__(control_id, title, control_position, title_position)
+        self.cfg["selection"] = selection
+
+    @classmethod
+    def from_dict(cls, cfg_dict: dict):
+        """Instantiates SelectorConfig from cfg dictionary
+
+        Parameters
+        ----------
+        cfg_dict : dict
+            A dictionary usually loaded from a config json from IoTDashboard App
+
+        Returns
+        -------
+        SelectorConfig
+        """
+        tmp_cls = cls(
+            cfg_dict["controlID"],
+            cfg_dict["title"],
+            _get_title_position(cfg_dict["titlePosition"]),
+            ControlPosition(cfg_dict["xPositionRatio"], cfg_dict["yPositionRatio"], cfg_dict["widthRatio"], cfg_dict["heightRatio"]),
+            cfg_dict.get("selection", None)
+        )
+        tmp_cls.parent_id = cfg_dict["parentID"]
+        return tmp_cls
+
+
 class Selector(Control):
     """A Selector control
     """
@@ -35,8 +73,9 @@ def __init__(
         control_id: str,
         title="A Selector",
         title_position=TitlePosition.BOTTOM,
+        selection: list[str] | None = None,
         control_position=None,
-        column_no=1
+        column_no=1,
     ):
         """A Selector control
 
@@ -54,18 +93,23 @@ def __init__(
             The Dash App reports its screen size in columns. column_no allows you to specify which column no to load into.
             Each control can store three configs that define how the device looks for Dash apps installed on single column
             phones or 2 column fold out phones or 3 column tablets.
+        selection : list[str], optional default is None
+            The selection list
         """
         super().__init__("SLCTR", control_id)
+        self.selection_list = []
+        if selection is not None:
+            self.selection_list = list(map(lambda s: s.translate(BAD_CHARS), selection))
         self._app_columns_cfg[str(column_no)].append(
-            ControlConfig(
+            SelectorConfig(
                 control_id,
                 title,
+                title_position,
                 control_position,
-                title_position
+                self.selection_list
             )
         )
         self._position = 0
-        self.selection_list = []
 
     @classmethod
     def from_cfg_dict(cls, cfg_dict: dict, column_no=1):
@@ -84,6 +128,7 @@ def from_cfg_dict(cls, cfg_dict: dict, column_no=1):
             cfg_dict["controlID"],
             cfg_dict["title"],
             _get_title_position(cfg_dict["titlePosition"]),
+            cfg_dict.get("selection", None),
             ControlPosition(cfg_dict["xPositionRatio"], cfg_dict["yPositionRatio"], cfg_dict["widthRatio"], cfg_dict["heightRatio"]),
             column_no
         )

dashio/iotcontrol/slider.py

@@ -44,7 +44,7 @@ def __init__(
         bar_color: Color | str,
         knob_color: Color | str,
         bar_style: SliderBarStyle,
-        control_position: ControlPosition | None,
+        control_position: ControlPosition | None
     ) -> None:
         super().__init__(control_id, title, control_position, title_position)
         self.cfg["redValue"] = red_value

dashio/iotcontrol/time_graph.py

@@ -103,6 +103,8 @@ def __init__(
             The data is stored in a ring buffer this sets the ring buffer size, by default 60
         break_data : bool, optional
             If true draws the line with breaks between missing data, by default False
+        right_axis: bool, optional
+            Defaults to left, right if true.
         """
         self.name = name.translate(BAD_CHARS)
         self.line_type = line_type