hspylib-clitt 0.9.118__py3-none-any.whl → 0.9.119__py3-none-any.whl

build/lib/clitt/core/tui/mchoose/menu_choose.py

@@ -0,0 +1,192 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib
+   @package: clitt.core.tui.mchoose
+      @file: menu_choose.py
+   @created: Wed, 17 May 2023
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.icons.font_awesome.nav_icons import NavIcons
+from clitt.core.term.commons import Direction, Portion
+from clitt.core.tui.tui_component import TUIComponent
+from hspylib.core.tools.commons import to_bool
+from hspylib.core.tools.dict_tools import get_or_default
+from hspylib.modules.cli.keyboard import Keyboard
+from typing import List, Optional, TypeAlias, TypeVar
+
+T = TypeVar("T")
+
+MChooseItems: TypeAlias = List[T]
+
+
+class MenuChoose(TUIComponent):
+    """Terminal UI menu choose input method."""
+
+    NAV_ICONS = NavIcons.compose(NavIcons.UP, NavIcons.DOWN)
+
+    ROW_OFFSET = 5
+
+    MIN_ROWS = 3
+
+    def __init__(self, title: str, items: MChooseItems, checked: bool | List[bool] = False):
+
+        super().__init__(title)
+        self.items = items
+        self.show_from = 0
+        self.show_to = self._max_rows()
+        self.diff_index = self.show_to - self.show_from
+        self.sel_index = 0
+        self.max_line_length = max(len(str(item)) for item in items)
+        # Initialize all options
+        if isinstance(checked, bool):
+            self.sel_options = [checked for _ in range(len(items))]
+        else:
+            # Check both sizes
+            self.sel_options = [get_or_default(checked, i, 0) for i in range(len(items))]
+
+    def execute(self) -> Optional[MChooseItems]:
+        if len(self.items) == 0:
+            return None
+
+        self._prepare_render()
+        keypress = self._loop()
+
+        return [op for idx, op in enumerate(self.items) if self.sel_options[idx]] if keypress.isEnter() else None
+
+    def render(self) -> None:
+        length = len(self.items)
+        self.cursor.restore()
+        self.writeln(f"{self.prefs.title_color.placeholder}{self.title}%EOL%%NC%")
+
+        for idx in range(self.show_from, self.show_to):
+            if idx >= length:
+                break  # When the index is greater than the number of items, stop rendering
+
+            option_line = str(self.items[idx])
+            self.cursor.erase(Portion.LINE)
+            # Print the selector if the index is currently selected
+            selector = self.draw_selector(idx == self.sel_index)
+            mark = self.prefs.checked_icon if to_bool(self.sel_options[idx]) else self.prefs.unchecked_icon
+            # fmt: off
+            line_fmt = (
+                "  {:>" + f"{len(str(length))}" + "}  "
+                + "{:>" + f"{len(selector)}" + "}  "
+                + "{:>" + f"{len(str(mark))}" + "}  "
+                + "{:<" + f"{self.max_line_length}" + "}  "
+            )
+            # fmt: on
+            self.draw_line(line_fmt, idx + 1, selector, mark, option_line)
+
+        self.draw_navbar(self.navbar(to=length))
+        self._re_render = False
+
+    def navbar(self, **kwargs) -> str:
+        return (
+            f"%EOL%{self.prefs.navbar_color.placeholder}"
+            f"[Enter] Accept  [{self.NAV_ICONS}] "
+            f"Navigate  [Space] Mark  [I] Invert  [Esc] Quit  [1..{kwargs['to']}] Goto: %NC%"
+        )
+
+    def handle_keypress(self) -> Keyboard:
+        if keypress := Keyboard.wait_keystroke():
+            match keypress:
+                case _ as key if key in Keyboard.break_keys():
+                    self._done = True
+                case Keyboard.VK_UP:
+                    self._handle_key_up()
+                case Keyboard.VK_DOWN:
+                    self._handle_key_down()
+                case Keyboard.VK_TAB:
+                    self._handle_tab()
+                case Keyboard.VK_SHIFT_TAB:
+                    self._handle_shift_tab()
+                case Keyboard.VK_SPACE:
+                    self._handle_space()
+                case _ as key if key in [Keyboard.VK_i, Keyboard.VK_I]:
+                    self._handle_key_i()
+                case _ as key if key in Keyboard.digits():
+                    self._handle_digit(keypress)
+
+        return keypress
+
+    def _handle_digit(self, digit: Keyboard) -> None:
+        """TODO"""
+        length = len(self.items)
+        typed_index = digit.value
+        self.write(f"{digit.value}")  # echo the digit typed
+        index_len = 1
+        while len(typed_index) < len(str(length)):
+            keystroke = Keyboard.wait_keystroke()
+            if not keystroke or not keystroke.isdigit():
+                typed_index = None if keystroke != Keyboard.VK_ENTER else typed_index
+                break
+            typed_index = f"{typed_index}{keystroke.value if keystroke else ''}"
+            self.write(f"{keystroke.value if keystroke else ''}")
+            index_len += 1
+        # Erase the index typed by the user
+        self.cursor.move(index_len, Direction.LEFT)
+        self.cursor.erase(Direction.RIGHT)
+        if typed_index and 1 <= int(typed_index) <= length:
+            self.show_to = max(int(typed_index), self.diff_index)
+            self.show_from = self.show_to - self.diff_index
+            self.sel_index = int(typed_index) - 1
+            self._re_render = True
+
+    def _handle_key_up(self) -> None:
+        """TODO"""
+        if self.sel_index == self.show_from and self.show_from > 0:
+            self.show_from -= 1
+            self.show_to -= 1
+        if self.sel_index - 1 >= 0:
+            self.sel_index -= 1
+            self._re_render = True
+
+    def _handle_key_down(self) -> None:
+        """TODO"""
+        length = len(self.items)
+        if self.sel_index + 1 == self.show_to and self.show_to < length:
+            self.show_from += 1
+            self.show_to += 1
+        if self.sel_index + 1 < length:
+            self.sel_index += 1
+            self._re_render = True
+
+    def _handle_tab(self) -> None:
+        """TODO"""
+        length = len(self.items)
+        page_index = min(self.show_to + self.diff_index, length)
+        self.show_to = max(page_index, self.diff_index)
+        self.show_from = self.show_to - self.diff_index
+        self.sel_index = self.show_from
+        self._re_render = True
+
+    def _handle_shift_tab(self) -> None:
+        """TODO"""
+        page_index = max(self.show_from - self.diff_index, 0)
+        self.show_from = min(page_index, self.diff_index)
+        self.show_to = self.show_from + self.diff_index
+        self.sel_index = self.show_from
+        self._re_render = True
+
+    def _handle_space(self) -> None:
+        """TODO"""
+        if self.sel_options[self.sel_index] == 0:
+            self.sel_options[self.sel_index] = 1
+        else:
+            self.sel_options[self.sel_index] = 0
+        self._re_render = True
+
+    def _handle_key_i(self) -> None:
+        """TODO"""
+        self.sel_options = [(0 if op == 1 else 1) for op in self.sel_options]
+        self._re_render = True
+
+    def _max_rows(self) -> int:
+        screen_lines = self.screen.lines - self.ROW_OFFSET
+        return min(self.prefs.max_rows, screen_lines)

build/lib/clitt/core/tui/mdashboard/__init__.py

@@ -0,0 +1,14 @@
+# _*_ coding: utf-8 _*_
+#
+# hspylib-clitt v0.9.119
+#
+# Package: main.build.lib.build.lib.clitt.core.tui.mdashboard
+"""Package initialization."""
+
+__all__ = [
+    'dashboard_builder', 
+    'dashboard_item', 
+    'mdashboard', 
+    'menu_dashboard'
+]
+__version__ = '0.9.119'

build/lib/clitt/core/tui/mdashboard/dashboard_builder.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib
+   @package: clitt.core.tui.mdashboard
+      @file: dashboard_builder.py
+   @created: Thu, 20 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.icons.font_awesome.awesome import Awesome
+from clitt.core.tui.mdashboard.dashboard_item import DashboardItem
+from typing import Callable, List, Optional
+
+
+class DashboardBuilder:
+    """Dashboard builder."""
+
+    @staticmethod
+    class DashboardItemBuilder:
+        """Dashboard item builder."""
+
+        def __init__(self, parent: "DashboardBuilder"):
+            self._parent = parent
+            self._item = DashboardItem()
+
+        def icon(self, icon: Awesome) -> "DashboardBuilder.DashboardItemBuilder":
+            self._item.icon = icon
+            return self
+
+        def tooltip(self, tooltip: str) -> "DashboardBuilder.DashboardItemBuilder":
+            self._item.tooltip = tooltip
+            return self
+
+        def on_trigger(self, on_trigger: Callable) -> Optional["DashboardBuilder.DashboardItemBuilder"]:
+            self._item.on_trigger = on_trigger
+            return self
+
+        def build(self) -> "DashboardBuilder":
+            self._parent.items.append(self._item)
+            return self._parent
+
+    def __init__(self):
+        self.items = []
+
+    def item(self) -> DashboardItemBuilder:
+        return DashboardBuilder.DashboardItemBuilder(self)
+
+    def build(self) -> List[DashboardItem]:
+        return self.items

build/lib/clitt/core/tui/mdashboard/dashboard_item.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib
+   @package: clitt.core.tui.mdashboard
+      @file: dashboard_item.py
+   @created: Thu, 20 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.icons.font_awesome.awesome import Awesome
+from typing import Callable, Optional
+
+
+class DashboardItem:
+    """Represent a dashboard item."""
+
+    def __init__(self, icon: Awesome = None, tooltip: str = None, on_trigger: Optional[Callable] = None):
+        self.icon = icon
+        self.tooltip = tooltip
+        self.on_trigger = on_trigger
+
+    def __str__(self):
+        return f'{self.icon} "{self.tooltip}" -> {self.on_trigger}'
+
+    def __repr__(self):
+        return str(self)

build/lib/clitt/core/tui/mdashboard/mdashboard.py

@@ -0,0 +1,26 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib
+   @package: clitt.core.tui.mdashboard
+      @file: mdashboard.py
+   @created: Tue, 4 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.tui.mdashboard.dashboard_item import DashboardItem
+from clitt.core.tui.mdashboard.menu_dashboard import MenuDashBoard
+from typing import List, Optional
+
+
+def mdashboard(items: List[DashboardItem], title: str = "Please select one item") -> Optional[DashboardItem]:
+    """
+    Wrapper for the Menu Dashboard.
+    :param items: the provided dashboard items to select from.
+    :param title: the title to be displayed before the options.
+    """
+    return MenuDashBoard(title, items).execute()

build/lib/clitt/core/tui/mdashboard/menu_dashboard.py

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib
+   @package: clitt.core.tui.mdashboard
+      @file: menu_dashboard.py
+   @created: Tue, 4 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.icons.font_awesome.nav_icons import NavIcons
+from clitt.core.term.commons import Direction, Portion
+from clitt.core.tui.mdashboard.dashboard_builder import DashboardBuilder
+from clitt.core.tui.mdashboard.dashboard_item import DashboardItem
+from clitt.core.tui.tui_component import TUIComponent
+from hspylib.core.preconditions import check_state
+from hspylib.modules.cli.keyboard import Keyboard
+from typing import List, Optional, TypeAlias
+
+DashboardMatrix: TypeAlias = List[List[str]]
+
+
+class MenuDashBoard(TUIComponent):
+    """A dashboard is a type of graphical user interface which provides at-a-glance views."""
+
+    # fmt: off
+    ICN = "x"  # x mars the spot if the icon.
+
+    # Selected cell template.
+    CELL_TPL = [
+        [" ", " ", " ", " ", " ", " ", " "],
+        [" ", " ", " ", ICN, " ", " ", " "],
+        [" ", " ", " ", " ", " ", " ", " "],
+    ]
+
+    # Unselected cell template.
+    SEL_CELL_TPL = [
+        [" ", "╭", " ", " ", " ", "╮", " "],
+        [" ", " ", " ", ICN, " ", " ", " "],
+        [" ", "╰", " ", " ", " ", "╯", " "],
+    ]
+    # fmt: on
+
+    NAV_ICONS = NavIcons.compose(NavIcons.LEFT, NavIcons.DOWN, NavIcons.UP, NavIcons.RIGHT)
+
+    COLUMN_OFFSET = 10
+
+    MIN_COLUMNS = 2
+
+    @classmethod
+    def builder(cls) -> DashboardBuilder:
+        return DashboardBuilder()
+
+    def __init__(self, title: str, items: List[DashboardItem]):
+        super().__init__(title)
+        self._items = items
+        self._tab_index = 0
+        check_state(
+            len(self.CELL_TPL) == len(self.SEL_CELL_TPL) and len(self.CELL_TPL[0]) == len(self.SEL_CELL_TPL[0]),
+            "Invalid CELL definitions. Selected and Unselected matrices should have the same lengths.",
+        )
+
+    def execute(self) -> Optional[DashboardItem]:
+        if (len(self._items)) == 0:
+            return None
+
+        self._prepare_render()
+        keypress = self._loop()
+        selected = self._items[self._tab_index] if keypress == Keyboard.VK_ENTER else None
+
+        if selected and selected.on_trigger:
+            selected.on_trigger()
+
+        return selected
+
+    def render(self) -> None:
+        self.cursor.restore()
+        self.writeln(f"{self.prefs.title_color.placeholder}{self.title}%EOL%%NC%")
+
+        for idx, item in enumerate(self._items):
+            self._draw_item(idx, item, MenuDashBoard.CELL_TPL if self._tab_index != idx else MenuDashBoard.SEL_CELL_TPL)
+
+        self.cursor.erase(Portion.LINE)
+        self.cursor.move_to(column=1)
+        self.draw_navbar(self.navbar())
+        self._re_render = False
+
+    def navbar(self, **kwargs) -> str:
+        return (
+            f"{NavIcons.POINTER} %GREEN%{self._items[self._tab_index].tooltip}%NC%"
+            f"%EOL%{self.prefs.navbar_color.placeholder}%EOL%"
+            f"[Enter] Select  Navigate  {self.NAV_ICONS}  Next  [Tab]  [Esc] Quit %NC%"
+        )
+
+    def handle_keypress(self) -> Keyboard:
+        length = len(self._items)
+        if keypress := Keyboard.wait_keystroke():
+            match keypress:
+                case _ as key if key in [Keyboard.VK_ESC, Keyboard.VK_ENTER]:
+                    self._done = True
+                case Keyboard.VK_UP:
+                    self._tab_index = max(0, self._tab_index - self._items_per_line())
+                case Keyboard.VK_DOWN:
+                    self._tab_index = min(length - 1, self._tab_index + self._items_per_line())
+                case _ as key if key in [Keyboard.VK_LEFT, Keyboard.VK_SHIFT_TAB]:
+                    self._tab_index = max(0, self._tab_index - 1)
+                case _ as key if key in [Keyboard.VK_RIGHT, Keyboard.VK_TAB]:
+                    self._tab_index = min(length - 1, self._tab_index + 1)
+
+        self._re_render = True
+
+        return keypress
+
+    def _draw_item(self, item_idx: int, item: DashboardItem, cell_template: DashboardMatrix) -> None:
+        """Print the specified dashboard item at the given index.
+        :param item_idx: the item index.
+        :param item: the dashboard item.
+        :param cell_template: the template of the dashboard cell (selected or unselected).
+        """
+
+        num_cols, num_rows = len(cell_template[0]), len(cell_template)
+
+        for row in range(0, num_rows):
+            for col in range(0, num_cols):
+                cur_cell = cell_template[row][col]
+                # Print current cell
+                self.write(f"{item.icon if cur_cell == self.ICN else cur_cell}")
+            # Move to the next the next row
+            self.cursor.move(1, Direction.DOWN)
+            self.cursor.move(num_cols, Direction.LEFT)
+
+        if item_idx > 0 and (item_idx + 1) % self._items_per_line() == 0:
+            # Break the line
+            self.cursor.move(1, Direction.DOWN)
+            self.cursor.move(num_cols * self._items_per_line(), Direction.LEFT)
+        elif item_idx + 1 < len(self._items):
+            # Continue on the same line
+            self.cursor.move(num_rows, Direction.UP)
+            self.cursor.move(num_cols, Direction.RIGHT)
+
+    def _items_per_line(self) -> int:
+        """TODO"""
+        screen_columns = self.screen.columns - self.COLUMN_OFFSET
+        return max(self.MIN_COLUMNS, min(self.prefs.items_per_line, screen_columns))

build/lib/clitt/core/tui/menu/__init__.py

@@ -0,0 +1,16 @@
+# _*_ coding: utf-8 _*_
+#
+# hspylib-clitt v0.9.119
+#
+# Package: main.build.lib.build.lib.clitt.core.tui.menu
+"""Package initialization."""
+
+__all__ = [
+    'tui_menu', 
+    'tui_menu_action', 
+    'tui_menu_factory', 
+    'tui_menu_item', 
+    'tui_menu_ui', 
+    'tui_menu_view'
+]
+__version__ = '0.9.119'

build/lib/clitt/core/tui/menu/tui_menu.py

@@ -0,0 +1,111 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib
+   @package: clitt.core.tui.menu
+      @file: tui_menu.py
+   @created: Tue, 4 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+
+from abc import ABC
+from clitt.core.icons.font_awesome.nav_icons import NavIcons
+from clitt.core.tui.minput.input_validator import InputValidator
+from clitt.core.tui.minput.menu_input import MenuInput
+from clitt.core.tui.minput.minput import minput
+from clitt.core.tui.tui_component import TUIComponent
+from hspylib.core.namespace import Namespace
+from hspylib.modules.cli.keyboard import Keyboard
+from typing import Callable, Optional, TypeAlias
+
+OnTrigger_Cb: TypeAlias = Callable[["TUIMenu"], Optional["TUIMenu"]]
+
+
+class TUIMenu(TUIComponent, ABC):
+    """Provide a base class for terminal UI menus."""
+
+    @staticmethod
+    def prompt(
+        label: str, dest: str = None, min_length: int = 1, max_length: int = 32, validator: InputValidator = None
+    ) -> Optional[Namespace]:
+        # fmt: off
+        form_fields = (
+            MenuInput.builder()
+                .field()
+                .label(label)
+                .dest(dest or label)
+                .validator(validator or InputValidator.words())
+                .min_max_length(min_length, max_length)
+                .build()
+            .build()
+        )
+        # fmt: on
+
+        return minput(form_fields)
+
+    def __init__(
+        self,
+        parent: Optional["TUIMenu"] = None,
+        title: str = "",
+        tooltip: str = "",
+        default_on_trigger_cb: OnTrigger_Cb = None,
+    ):
+        super().__init__(title)
+        self._tooltip = tooltip
+        self._parent = parent
+        self._on_trigger = default_on_trigger_cb or self._default_trigger_cb
+
+    def __str__(self) -> str:
+        return self._title
+
+    def __repr__(self) -> str:
+        return str(self)
+
+    @property
+    def parent(self) -> Optional["TUIMenu"]:
+        return self._parent
+
+    @property
+    def tooltip(self) -> str:
+        return self._tooltip
+
+    def handle_keypress(self) -> Keyboard:
+        if keypress := Keyboard.wait_keystroke():
+            match keypress:
+                case Keyboard.VK_ENTER | Keyboard.VK_ESC:
+                    self._done = True
+
+        return keypress
+
+    def navbar(self, **kwargs) -> str:
+        return (
+            f"%EOL%{self.breadcrumb()}%ED0%"
+            f"%EOL%{self.prefs.navbar_color.placeholder}%EOL%"
+            f"[Enter] Back  [Esc] Quit  %EL0%%EOL%%EOL%%NC%"
+        )
+
+    def breadcrumb(self) -> str:
+        """Provide a breadcrumb of menus for navigation purposes."""
+        return (
+            f"{self.prefs.breadcrumb_color.placeholder}"
+            f" {NavIcons.BREADCRUMB} {self.title} %NC%"
+            f"{self.prefs.tooltip_color.placeholder}"
+        )
+
+    def wait_keystroke(self, wait_message: str = "%YELLOW%%EOL%Press any key to continue%EOL%%NC%") -> None:
+        """Wait for a keypress (blocking).
+        :param wait_message: the message to present to the user.
+        """
+        self.writeln(wait_message)
+        Keyboard.wait_keystroke()
+
+    def _default_trigger_cb(self, source: Optional["TUIMenu"]) -> Optional["TUIMenu"]:
+        """Provide a default trigger callback when a menu is activated. Provided a source menu, returns it's parent.
+        :param source: the source which invoked this menu.
+        """
+        return self.parent

build/lib/clitt/core/tui/menu/tui_menu_action.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib
+   @package: clitt.core.tui.menu
+      @file: tui_menu_action.py
+   @created: Tue, 4 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.tui.menu.tui_menu import OnTrigger_Cb, TUIMenu
+from clitt.core.tui.menu.tui_menu_ui import TUIMenuUi
+from typing import Optional
+
+
+class TUIMenuAction(TUIMenu):
+    """Represent a menu item action. Each action trigger a callback function."""
+
+    def execute(self) -> Optional[TUIMenu]:
+        self.render()
+        ret_menu = self._on_trigger(self._parent)
+        if not ret_menu:
+            self.wait_keystroke()
+        return ret_menu if ret_menu else self._default_trigger_cb(self)
+
+    def render(self) -> None:
+        self.screen.cursor.restore()
+        TUIMenuUi.render_app_title()
+
+    def __init__(
+        self,
+        parent: TUIMenu,
+        title: Optional[str] = None,
+        tooltip: Optional[str] = None,
+        on_trigger: OnTrigger_Cb = None,
+    ):
+        super().__init__(parent, title, tooltip)
+        self._parent = parent
+        self._on_trigger: OnTrigger_Cb = on_trigger or super()._default_trigger_cb
+
+    def on_trigger(self, cb_on_trigger: OnTrigger_Cb) -> None:
+        """Setter for the on_trigger callback. It is called when a menu item is triggered."""
+        self._on_trigger = cb_on_trigger