hspylib-clitt 0.9.127__py3-none-any.whl → 0.9.128__py3-none-any.whl

clitt/.version

@@ -1 +1 @@
-0.9.127
+0.9.128

clitt/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt
 """Package initialization."""
@@ -10,4 +10,4 @@ __all__ = [
     'core', 
     'utils'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/addons/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.addons
 """Package initialization."""
@@ -9,4 +9,4 @@ __all__ = [
     'appman', 
     'widman'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/addons/appman/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.addons.appman
 """Package initialization."""
@@ -10,4 +10,4 @@ __all__ = [
     'appman_enums', 
     'templates'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/addons/appman/templates/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.addons.appman.templates
 """Package initialization."""
@@ -8,4 +8,4 @@
 __all__ = [
     
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/addons/widman/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.addons.widman
 """Package initialization."""
@@ -11,4 +11,4 @@ __all__ = [
     'widgets', 
     'widman'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/addons/widman/widgets/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.addons.widman.widgets
 """Package initialization."""
@@ -11,4 +11,4 @@ __all__ = [
     'widget_send_msg', 
     'widget_time_calc'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core
 """Package initialization."""
@@ -12,4 +12,4 @@ __all__ = [
     'term', 
     'tui'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/exception/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.exception
 """Package initialization."""
@@ -8,4 +8,4 @@
 __all__ = [
     'exceptions'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/icons/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.icons
 """Package initialization."""
@@ -9,4 +9,4 @@ __all__ = [
     'emojis', 
     'font_awesome'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/icons/emojis/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.icons.emojis
 """Package initialization."""
@@ -9,4 +9,4 @@ __all__ = [
     'emojis', 
     'face_smiling'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/icons/font_awesome/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.icons.font_awesome
 """Package initialization."""
@@ -15,4 +15,4 @@ __all__ = [
     'trickplay_icons', 
     'widget_icons'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/term/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.term
 """Package initialization."""
@@ -11,4 +11,4 @@ __all__ = [
     'screen', 
     'terminal'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/term/cursor.py

@@ -126,27 +126,28 @@ class Cursor(metaclass=Singleton):
         self.position = get_cursor_position() or self.position
         return self.position
 
-    def write(self, obj: Any, end: str = "") -> Position:
+    def write(self, obj: Any = "", end: str = "", markdown: bool = False) -> Position:
         """Write the string representation of the object to the screen.
         :param obj the object to be written.
         :param end string appended after the last value, default a newline.
+        :param markdown: whether to print a markdown render.
         :return the cursor position after writing.
         """
-        sysout(obj, end=end)
-        text = (str(obj) + end).replace("%EOL%", os.linesep)
-        text = VtColor.strip_colors(VtCode.strip_codes(text))
-        text_offset = len(text[max(0, last_index_of(text, os.linesep)) :])
+        sysout(obj, end=end, markdown=markdown)
+        text: str = self.cleanup_text(str(obj) + end)
+        text_offset: int = self.offset_text(text)
         self.position = self.position[0] + text.count(os.linesep), text_offset + (
             self.position[1] if text.count(os.linesep) == 0 else 0
         )
         return self.position
 
-    def writeln(self, obj: Any) -> Position:
+    def writeln(self, obj: Any = "", markdown: bool = False) -> Position:
         """Write the string representation of the object to the screen, appending a new line.
         :param obj the object to be written.
+        :param markdown: whether to print a markdown render.
         :return the cursor position after writing.
         """
-        return self.write(obj, end=os.linesep)
+        return self.write(obj, end=os.linesep, markdown=markdown)
 
     def save(self) -> Position:
         """Save the current cursor position and attributes.
@@ -170,5 +171,14 @@ class Cursor(metaclass=Singleton):
         sysout(Vt100.mode(0), end=end)
         return self.position
 
+    def cleanup_text(self, text: str) -> str:
+        """TODO"""
+        return VtColor.strip_colors(VtCode.strip_codes(text.replace("%EOL%", os.linesep)))
+
+    def offset_text(self, text: str) -> int:
+        """TODO"""
+        text: str = self.cleanup_text(text)
+        return len(text[max(0, last_index_of(text, os.linesep)):])
+
 
 assert (cursor := Cursor().INSTANCE) is not None, "Failed to create Cursor instance"

clitt/core/term/terminal.py

@@ -177,9 +177,13 @@ class Terminal(metaclass=Singleton):
         cls.INSTANCE.screen.clear()
 
     @classmethod
-    def echo(cls, obj: Any, end: str = os.linesep) -> None:
-        """Write the string representation of the object to the screen."""
-        cls.INSTANCE.screen.cursor.write(obj, end=end)
+    def echo(cls, obj: Any = "", end: str = os.linesep, markdown: bool = False) -> None:
+        """Write the string representation of the object to the screen.
+        :param obj the object to be written.
+        :param end string appended after the last value, default a newline.
+        :param markdown: whether to print a markdown render.
+        """
+        cls.INSTANCE.screen.cursor.write(obj, end=end, markdown=markdown)
 
     @classmethod
     def alternate_screen(cls, enable: bool) -> None:

clitt/core/tui/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.tui
 """Package initialization."""
@@ -17,4 +17,4 @@ __all__ = [
     'tui_component', 
     'tui_preferences'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/tui/line_input/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.tui.line_input
 """Package initialization."""
@@ -9,4 +9,4 @@ __all__ = [
     'keyboard_input', 
     'line_input'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/tui/line_input/keyboard_input.py

@@ -12,10 +12,11 @@
 
    Copyright·(c)·2024,·HSPyLib
 """
-
+import os
+from collections import defaultdict
 from typing import Optional, Callable, TypeAlias
 
-from clitt.core.term.commons import Direction
+from clitt.core.term.commons import Direction, Position
 from clitt.core.term.terminal import Terminal
 from clitt.core.tui.tui_component import TUIComponent
 from hspylib.core.tools.dict_tools import get_or_default
@@ -28,6 +29,9 @@ KeyBinding: TypeAlias = dict[Keyboard, Callable[[], None]]
 class KeyboardInput(TUIComponent):
     """Provides a keyboard input for terminal UIs with undo and history."""
 
+    # minimum length to be considered as history store.
+    _MIN_HIST_STORE_LEN: int = 3
+
     # Current history index.
     _HIST_INDEX: int = 0
 
@@ -40,9 +44,6 @@ class KeyboardInput(TUIComponent):
     # Stack containing current input reverts.
     _REDO_HISTORY: list[str] = []
 
-    # Map containing the custom keybindings.
-    _BINDINGS: KeyBinding = {}
-
     @classmethod
     def preload_history(cls, history: list[str]) -> None:
         """Preload the input with the provided dictionary.
@@ -69,6 +70,8 @@ class KeyboardInput(TUIComponent):
         """Add the following input to the history set.
         :param input_text: The input text to add to the history.
         """
+        if not len(input_text) > cls._MIN_HIST_STORE_LEN:
+            return
         if cls._HISTORY[-1] != '':
             cls._HISTORY.append('')
         if input_text:
@@ -101,41 +104,64 @@ class KeyboardInput(TUIComponent):
         text_color: VtColor = VtColor.NC,
         navbar_enable: bool = False,
     ):
+        self._HISTORY[-1] = ""
+        self._HIST_INDEX = max(0, len(self._HISTORY) - 1)
         super().__init__(prompt)
         self._placeholder: str = placeholder
         self._prompt_color: VtColor = prompt_color
         self._text_color: VtColor = text_color
         self._navbar_enable: bool = navbar_enable
+        self._offset: Position = 0, 0
         self._input_index: int = 0
         self._input_text: str = ""
         self._suggestion: str = ""
-        self._HISTORY[-1] = ""
-        self._HIST_INDEX = max(0, len(self._HISTORY) - 1)
-        self._bindings()
+        self._bindings: KeyBinding = defaultdict()
+        self._bind_keys()
+
+    @property
+    def prompt(self) -> str:
+        return f"{self.prompt_color}{self.title}{self.text_color}"
+
+    @property
+    def text(self) -> str:
+        return self._input_text
+
+    @text.setter
+    def text(self, value: str) -> None:
+        self._input_text = value
 
     @property
     def length(self) -> int:
-        return len(self._input_text) if self._input_text else 0
+        return len(self.text) if self.text else 0
 
-    def execute(self) -> Optional[str | Keyboard]:
-        self._prepare_render()
-        keypress = self._loop() or Keyboard.VK_ESC
+    @property
+    def prompt_color(self) -> str:
+        return self._prompt_color.placeholder
+
+    @property
+    def text_color(self) -> str:
+        return self._text_color.placeholder
+
+    @property
+    def placeholder(self) -> str:
+        return self._placeholder
+
+    @property
+    def bindings(self) -> KeyBinding:
+        return self._bindings
 
+    def execute(self) -> Optional[str | Keyboard]:
+        keypress = self._loop(cleanup=False) or Keyboard.VK_ESC
         if keypress.isEnter():
-            self._add_history(self._input_text)
+            self._add_history(self.text)
             self._UNDO_HISTORY.clear()
             self._REDO_HISTORY.clear()
-            Terminal.set_show_cursor(False)
-            self.cursor.restore()
-            self.write(f"{self._prompt_color.placeholder}{self.title}{self._text_color.placeholder}")
-            self.write(self._input_text)
-            self._terminal.cursor.erase(Direction.DOWN)
-            Terminal.set_show_cursor(True)
+            self.cursor.erase(Direction.DOWN)
         elif keypress == Keyboard.VK_ESC:
-            self._input_text = None
+            self.text = None
         self.writeln("%NC%")
 
-        return self._input_text
+        return self.text
 
     def reset(self) -> None:
         """Reset the contents of the input."""
@@ -152,27 +178,30 @@ class KeyboardInput(TUIComponent):
 
     def complete(self) -> None:
         """Complete the input text with the suggested text."""
-        self._update_input(self._input_text + self._suggestion)
-        self._input_index = self.length
+        text: str = self.text + self._suggestion
+        self._update_input(text)
+        self._input_index = len(text)
 
     def render(self) -> None:
         Terminal.set_show_cursor(False)
-        self.cursor.restore()
-        self._terminal.cursor.erase(Direction.DOWN)
-        self.write(f"{self._prompt_color.placeholder}{self.title}{self._text_color.placeholder}")
-        if self._input_text:
-            self.write(self._input_text)
+        self.cursor.move(self._offset[0], Direction.UP)
+        self.cursor.move(self._offset[1], Direction.LEFT)
+        self.cursor.erase(Direction.DOWN)
+        self.write(self.prompt)
+        if self.text:
+            self.write(self.text)
             self._render_suggestions()
         else:
-            self.write(f"%GRAY%{self._placeholder}%NC%")
-            self._terminal.cursor.erase(Direction.DOWN)
-            self.cursor.move(len(self._placeholder), Direction.LEFT)
+            self.write(f"%GRAY%{self.placeholder}%NC%")
+            self.cursor.erase(Direction.DOWN)
+            self.cursor.move(len(self.placeholder), Direction.LEFT)
         self._re_render = False
         self._set_cursor_pos()
+        self._offset = self.prompt.count(os.linesep), self.cursor.position[1]
         Terminal.set_show_cursor()
 
     def navbar(self, **kwargs) -> str:
-        pass
+        ...
 
     def handle_keypress(self) -> Keyboard:
         if keypress := Keyboard.wait_keystroke():
@@ -182,26 +211,25 @@ class KeyboardInput(TUIComponent):
                     if self._input_index > 0:
                         self._input_index = max(0, self._input_index - 1)
                         self._update_input(
-                            self._input_text[: self._input_index] + self._input_text[1 + self._input_index:]
+                            self.text[: self._input_index] + self.text[1 + self._input_index:]
                         )
                 case Keyboard.VK_DELETE:
                     self._update_input(
-                        self._input_text[: self._input_index] + self._input_text[1 + self._input_index:]
+                        self.text[: self._input_index] + self.text[1 + self._input_index:]
                     )
                 case Keyboard.VK_LEFT:
                     self._input_index = max(0, self._input_index - 1)
                 case Keyboard.VK_RIGHT:
                     self._input_index = min(self.length, self._input_index + 1)
                 case Keyboard.VK_UP:
-                    self._input_text = self._prev_in_history()
+                    self.text = self._prev_in_history()
                     self._input_index = self.length
                 case Keyboard.VK_DOWN:
-                    self._input_text = self._next_in_history()
+                    self.text = self._next_in_history()
                     self._input_index = self.length
                 # Customizable key bindings.
-                case _ as key if key in self._BINDINGS:
-                    fn: Callable = self._BINDINGS[key]
-                    if fn and isinstance(fn, Callable):
+                case _ as key if key in self.bindings:
+                    if (fn := self.bindings[key]) and callable(fn):
                         fn()
                 # Printable characters
                 case _ as key if key.val.isprintable():
@@ -210,50 +238,29 @@ class KeyboardInput(TUIComponent):
                         if key.val and key.val.isprintable():
                             text += key.val
                     self._update_input(
-                        self._input_text[: self._input_index] + text + self._input_text[self._input_index:])
+                        self.text[: self._input_index] + text + self.text[self._input_index:])
                     self._input_index += len(text)
                 # Loop breaking characters
                 case _ as key if key in Keyboard.break_keys():
                     self._done = True
                 case _:
-                    self._input_text = keypress
+                    self.text = keypress
                     self._done = True
             self._re_render = True
 
         return keypress
 
-    def _bindings(self) -> None:
-        """TODO"""
-        if not KeyboardInput._BINDINGS:
-            KeyboardInput._BINDINGS.update({
-                Keyboard.VK_CTRL_A: self.home,
-                Keyboard.VK_CTRL_E: self.end,
-                Keyboard.VK_CTRL_R: self.reset,
-                Keyboard.VK_CTRL_F: self.forget_history,
-                Keyboard.VK_HOME: self.home,
-                Keyboard.VK_END: self.end,
-                Keyboard.VK_TAB: self.complete
-            })
-
-    def _prepare_render(self, auto_wrap: bool = True, show_cursor: bool = True) -> None:
-        self.screen.add_watcher(self.invalidate)
-        Terminal.set_auto_wrap(auto_wrap)
-        Terminal.set_show_cursor(show_cursor)
-        self.cursor.save()
-
-    def _loop(self, break_keys: list[Keyboard] = None) -> Keyboard:
-        break_keys = break_keys or Keyboard.break_keys()
-        keypress = Keyboard.VK_NONE
-
-        # Wait for user interaction
-        while not self._done and keypress and keypress not in break_keys:
-            # Menu Renderization
-            if self._re_render:
-                self.render()
-            # Navigation input
-            keypress = self.handle_keypress()
-
-        return keypress
+    def _bind_keys(self) -> None:
+        """Configure the default key bindings."""
+        self._bindings.update({
+            Keyboard.VK_CTRL_A: self.home,
+            Keyboard.VK_CTRL_E: self.end,
+            Keyboard.VK_CTRL_R: self.reset,
+            Keyboard.VK_CTRL_F: self.forget_history,
+            Keyboard.VK_HOME: self.home,
+            Keyboard.VK_END: self.end,
+            Keyboard.VK_TAB: self.complete
+        })
 
     def _set_cursor_pos(self):
         """Set the cursor position on the input."""
@@ -264,15 +271,15 @@ class KeyboardInput(TUIComponent):
         """Update the value of the input.
         :param text: The text to be set.
         """
-        self._UNDO_HISTORY.append(self._input_text)
-        self._HISTORY[-1] = text if text not in self._HISTORY else self._input_text
-        self._input_text = text
+        self._UNDO_HISTORY.append(self.text)
+        self._HISTORY[-1] = text if text not in self._HISTORY else self.text
+        self.text = text
         self._HIST_INDEX = max(0, len(self._HISTORY) - 1)
         return text
 
     def _render_suggestions(self) -> None:
         """Render the input suggestions."""
-        edt_text: str = self._input_text
+        edt_text: str = self.text
         filtered: list[str] = list(filter(lambda h: h.startswith(edt_text), self._HISTORY))
         hint: str = ''
 

clitt/core/tui/mchoose/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.tui.mchoose
 """Package initialization."""
@@ -9,4 +9,4 @@ __all__ = [
     'mchoose', 
     'menu_choose'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/tui/mdashboard/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.tui.mdashboard
 """Package initialization."""
@@ -11,4 +11,4 @@ __all__ = [
     'mdashboard', 
     'menu_dashboard'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/tui/menu/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.tui.menu
 """Package initialization."""
@@ -13,4 +13,4 @@ __all__ = [
     'tui_menu_ui', 
     'tui_menu_view'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/tui/minput/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.tui.minput
 """Package initialization."""
@@ -16,4 +16,4 @@ __all__ = [
     'minput', 
     'minput_utils'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/tui/mselect/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.tui.mselect
 """Package initialization."""
@@ -9,4 +9,4 @@ __all__ = [
     'menu_select', 
     'mselect'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/tui/table/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.core.tui.table
 """Package initialization."""
@@ -9,4 +9,4 @@ __all__ = [
     'table_enums', 
     'table_renderer'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

clitt/core/tui/tui_application.py

@@ -41,10 +41,10 @@ class TUIApplication(Application, metaclass=AbstractSingleton):
         self._app_name = os.path.basename(sys.argv[0]) if name is None else name
 
     def _setup_arguments(self) -> None:
-        pass
+        ...
 
     def _main(self, *params, **kwargs) -> ExitStatus:
-        pass
+        ...
 
     def _cleanup(self) -> None:
         if screen.alternate and self._exit_code == ExitStatus.SUCCESS:

clitt/core/tui/tui_component.py

@@ -12,7 +12,10 @@
 
    Copyright·(c)·2024,·HSPyLib
 """
-from abc import ABC, abstractmethod
+import os
+from abc import ABC
+from typing import Any, Optional, TypeVar
+
 from clitt.core.icons.font_awesome.awesome import Awesome
 from clitt.core.term.commons import Direction
 from clitt.core.term.cursor import Cursor
@@ -21,7 +24,6 @@ from clitt.core.term.terminal import Terminal
 from clitt.core.tui.tui_preferences import TUIPreferences
 from hspylib.core.tools.text_tools import elide_text
 from hspylib.modules.cli.keyboard import Keyboard
-from typing import Any, List, Optional, TypeVar
 
 T = TypeVar("T", bound=Any)
 
@@ -63,15 +65,21 @@ class TUIComponent(ABC):
     def columns(self) -> int:
         return self.screen.columns
 
-    def _prepare_render(self, auto_wrap: bool = False, show_cursor: bool = False) -> None:
+    def _prepare_render(
+        self,
+        auto_wrap: bool = False,
+        show_cursor: bool = False,
+        clear_screen: bool = True
+    ) -> None:
         """Prepare the screen for renderization."""
         self.screen.add_watcher(self.invalidate)
         Terminal.set_auto_wrap(auto_wrap)
         Terminal.set_show_cursor(show_cursor)
-        self.screen.clear()
+        if clear_screen:
+            self.screen.clear()
         self.cursor.save()
 
-    def _loop(self, break_keys: List[Keyboard] = None) -> Keyboard:
+    def _loop(self, break_keys: list[Keyboard] = None, cleanup: bool = True) -> Keyboard:
         """Loop and wait for a keypress. Render the component if required."""
 
         break_keys = break_keys or Keyboard.break_keys()
@@ -86,10 +94,11 @@ class TUIComponent(ABC):
             # Navigation input
             keypress = self.handle_keypress()
 
-        self.cursor.end()
-        self.cursor.erase(Direction.DOWN)
-        self.cursor.reset_mode()
-        self.cursor.writeln("\n")
+        if cleanup:
+            self.cursor.end()
+            self.cursor.erase(Direction.DOWN)
+            self.cursor.reset_mode()
+            self.cursor.writeln(os.linesep)
 
         return keypress
 
@@ -123,32 +132,33 @@ class TUIComponent(ABC):
 
         return selector
 
-    def write(self, obj: Any) -> None:
+    def write(self, obj: Any = "", end: str = "", markdown: bool = False) -> None:
         """Write the string representation of the object to the screen."""
-        self.terminal.echo(obj, end="")
+        self.terminal.echo(obj, end=end, markdown=markdown)
 
-    def writeln(self, obj: Any) -> None:
+    def writeln(self, obj: Any = "", markdown: bool = False) -> None:
         """Write the string representation of the object to the screen, appending a new line."""
-        self.terminal.echo(obj)
+        self.terminal.echo(obj, markdown=markdown)
 
     def invalidate(self) -> None:
         """Invalidate current TUI renderization."""
         self.screen.clear()
         self.cursor.save()
+        self.cursor.track()
         self.render()
 
-    @abstractmethod
-    def execute(self) -> Optional[T | List[T]]:
+    def execute(self) -> Optional[T | list[T]]:
         """Execute the main TUI component flow."""
+        ...
 
-    @abstractmethod
     def render(self) -> None:
         """Renders the TUI component."""
+        ...
 
-    @abstractmethod
     def navbar(self, **kwargs) -> str:
         """Get the TUI component's navigation bar (optional)."""
+        ...
 
-    @abstractmethod
     def handle_keypress(self) -> Keyboard:
         """Handle a keyboard press."""
+        ...

clitt/utils/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.127
+# hspylib-clitt v0.9.128
 #
 # Package: main.clitt.utils
 """Package initialization."""
@@ -8,4 +8,4 @@
 __all__ = [
     'git_utils'
 ]
-__version__ = '0.9.127'
+__version__ = '0.9.128'

{hspylib_clitt-0.9.127.dist-info → hspylib_clitt-0.9.128.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hspylib-clitt
-Version: 0.9.127
+Version: 0.9.128
 Summary: HsPyLib - CLI Terminal Tools
 Home-page: https://github.com/yorevs/hspylib
 Author: Hugo Saporetti Junior
@@ -40,7 +40,7 @@ Requires-Dist: emoji >=2.12.1
 [![Gitter](https://badgen.net/badge/icon/gitter?icon=gitter&label)](https://gitter.im/hspylib/community)
 [![Donate](https://badgen.net/badge/paypal/donate/yellow)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=J5CDEFLF6M3H4)
 [![License](https://badgen.net/badge/license/MIT/gray)](LICENSE.md)
-[![Release](https://badgen.net/badge/release/v0.9.127/gray)](docs/CHANGELOG.md#unreleased)
+[![Release](https://badgen.net/badge/release/v0.9.128/gray)](docs/CHANGELOG.md#unreleased)
 [![build-and-test](https://github.com/yorevs/hspylib/actions/workflows/build-and-test.yml/badge.svg)](https://github.com/yorevs/hspylib/actions/workflows/build-and-test.yml)
 
 HsPyLib is not just a Python library; it's a gateway to elevating your programming experience to new heights. Built on

{hspylib_clitt-0.9.127.dist-info → hspylib_clitt-0.9.128.dist-info}/RECORD

@@ -1,13 +1,13 @@
-clitt/.version,sha256=onjTbJDJBs5Rg4zwXpWeDZcGeBzo5es8d5VjJpV5Uz8,8
+clitt/.version,sha256=zS8RbFHozJYPH22KqahZnGWGMPwyqvBv2UkxCUZ1WD8,8
 clitt/__classpath__.py,sha256=S94uRWOt4GdJlnpFoBBDlaA6imnDOglyIBgWY6e9cTU,881
-clitt/__init__.py,sha256=CmS_Q0SIJNEdfMr0U4BlPibxR9GgPlk9OxbribqcjuE,184
+clitt/__init__.py,sha256=9OJRINQIopriCmGP-_q2ZMvPpfe7ayiY6mLSdsVJJLk,184
 clitt/__main__.py,sha256=rmAQE7_25DwTCXEGIwaQ1fFEfaPSLmuWQAH4UTFh92U,5320
 clitt/welcome.txt,sha256=z72ySJw-1VQHvWmd8pZ95P6t4zEkIWGbqTRT83P2hJw,169
-clitt/addons/__init__.py,sha256=q6ZhtVh97Qxi7-vFERposFFQpKRHkKCQcclMBY5RO7A,179
-clitt/addons/appman/__init__.py,sha256=4tc5kypIH9Wm-Xm1gwEWkyxhNcMSo9Tcu5djbCXOq2A,210
+clitt/addons/__init__.py,sha256=ilZoLmfA3Fyb_5hv5P-D9M12aIp8IAt3UglRDwtsk28,179
+clitt/addons/appman/__init__.py,sha256=wXlayccAe1t42Um0b9AgemC_dYdcbeAV_S3dXoJHKLM,210
 clitt/addons/appman/appman.py,sha256=c4-VqUullq0ZyJtQJ3etZsC-2Pa9gVc_RExA5HfhZMs,13153
 clitt/addons/appman/appman_enums.py,sha256=p3ERhgc5iaJ_QmtRCwHHk9mzXQ_Ds1-s__vwYrwRVZY,871
-clitt/addons/appman/templates/__init__.py,sha256=Jn4xDIFyihqqNjZ9I5yvLjfZSA7Pvb6aoxplcdCAqNI,173
+clitt/addons/appman/templates/__init__.py,sha256=Ac-XdBiq7FCzRD3S1Wu52SV1gRZWidP2eptWYl7BTcc,173
 clitt/addons/appman/templates/build.gradle.tpl,sha256=VQKs4r41xPr7P14PtQPt3alYCmNuXaGraaXbKB_FKkM,1817
 clitt/addons/appman/templates/classpath.py.tpl,sha256=R60uLvVxeJ7nJCXCvav_9LAnDe5VOfJqWO-T1QAlwAc,397
 clitt/addons/appman/templates/dependencies.hspd.tpl,sha256=bbVNU6XBm5QT28lvH7Bp_4nlXvoD-LwX5kGQ-CPhOEA,764
@@ -20,24 +20,24 @@ clitt/addons/appman/templates/run.sh.tpl,sha256=2xpuHjZP9-7j14dAA2CqPm4G2xtnuenf
 clitt/addons/appman/templates/test_main.py.tpl,sha256=y5Bo0ku6FP67WjHfYUF4Kt9tdQ67MSlN6LgoF_NUm-U,1241
 clitt/addons/appman/templates/usage.txt.tpl,sha256=R0e48HCeD7PDbWnX6HGIjz6gr_hBdp-zK6V42U1Aexw,217
 clitt/addons/appman/templates/widget.py.tpl,sha256=-4q8hYP1Xdx8ttexeHuFnjMH_DoBANEoN9f59jzHDR4,1670
-clitt/addons/widman/__init__.py,sha256=Y89QGEUB1sac8ta6sEayznqkMPKSyMk4RzzSdrfckgo,223
+clitt/addons/widman/__init__.py,sha256=byfMGgH7aR6vnj0i_B0etH7944OjJkGN2MhGnvPqYOs,223
 clitt/addons/widman/widget.py,sha256=nQZCbUy-G0lpO4PMepSeTmJTECJgNY4bp2prQ5zzYlY,1919
 clitt/addons/widman/widget_entry.py,sha256=KHYX_pL7ZNg3rtlG_GvypqPIPBqVzDljO5PhpcQw1JU,1357
 clitt/addons/widman/widman.py,sha256=gxynZZiq9T2UPFp4x0V0i3Yk-XDDGQ3R-BbM02Z9O3E,5273
-clitt/addons/widman/widgets/__init__.py,sha256=lQUgG2GnYPUY1qsF6k-v_loBqDXoR7ZDwIOs_Bedyow,254
+clitt/addons/widman/widgets/__init__.py,sha256=b-Ysp0qUu6XpGm_F3_BgNKQAc5CqebmNKs2n1piW-fo,254
 clitt/addons/widman/widgets/widget_free.py,sha256=s43aIRc_mlIvz4M2pGJOHE2qt3MDD_KXKGJht-7WMPY,3994
 clitt/addons/widman/widgets/widget_punch.py,sha256=GQRJadedh_zxyhacH65FmKeIOQV2nMEBmahdEzhfB7c,10606
 clitt/addons/widman/widgets/widget_send_msg.py,sha256=RqqD6ss7wJqw6vJzS5C9uqs3OhyOCXYb8d329_8O8hc,11057
 clitt/addons/widman/widgets/widget_time_calc.py,sha256=fusZRgPqgSDhxNeiPK1vhul9Fz8PzIaj2cuxP-aFb5k,5036
-clitt/core/__init__.py,sha256=L5elwrhAoCdHNpsGLqr3ggulcIf7jScp_Lc_NhKEjmI,224
+clitt/core/__init__.py,sha256=Tdbes9UmZhUGtIQh0gnUa0KwvTtRocM-wUQR2TJ302s,224
 clitt/core/preferences.py,sha256=cbWjL2yfE59-T1vzTsXCrrRRsBJ4LHLqqESTI-ujsDc,3141
-clitt/core/exception/__init__.py,sha256=hEBRa9wRiZAbYIP9ACF1R0G7y0R4xjnGD6d3r_KiND0,176
+clitt/core/exception/__init__.py,sha256=B0VJVotxCIyab-tLuQsfIrvrh5PdF4NBL7KPBh181Rw,176
 clitt/core/exception/exceptions.py,sha256=vfKRGmGX32qQksrcrej4ncPCqCt9smmtJa0vc8FLkn4,477
-clitt/core/icons/__init__.py,sha256=X4ACxJqWYLmCqQSWQ7lZoB_60Rd7V12DuMue1c5WBKw,189
-clitt/core/icons/emojis/__init__.py,sha256=8iec7C4IAKsiA3AFruLJvEEg0AI0szoZWQP7sr-IC-o,196
+clitt/core/icons/__init__.py,sha256=zCerLw7qp4FGURlnwIoWZt3xBqfzGpt1pm3JWVT9R1Y,189
+clitt/core/icons/emojis/__init__.py,sha256=NrAaWHK-rzxLwn9eHEke9FWA3_g934busx32l2esk0w,196
 clitt/core/icons/emojis/emojis.py,sha256=fBxVIPfGRwzbmx6yGsX7oIpngiVwuQkxrmd-oAkK64Y,1110
 clitt/core/icons/emojis/face_smiling.py,sha256=2NvJoMQ2q2VFBv2J2JrVw5UjWz7b6Eqh8VgORhbAfcM,1270
-clitt/core/icons/font_awesome/__init__.py,sha256=PbIrrUJHVDFLvrK0ZVyleyBZjRPajdLAfr85HtznETY,325
+clitt/core/icons/font_awesome/__init__.py,sha256=UyhktRd48eIgpyUyCo3EeC-dbB4liDjPhxr8b7P9QjQ,325
 clitt/core/icons/font_awesome/app_icons.py,sha256=zlD_AnwmrD0LKkd2Ej9jGmQPEa2TYGguvPbgfBUxuzM,1701
 clitt/core/icons/font_awesome/awesome.py,sha256=JyyobxTZ9VVa8y_S07iLvJZWbWA671esav1-p5PKZ9Y,2242
 clitt/core/icons/font_awesome/dashboard_icons.py,sha256=hdUQD55819mrV7z0Y_rJI4WiqgrWExjl3ULFabIf8Kc,3121
@@ -46,34 +46,34 @@ clitt/core/icons/font_awesome/game_icons.py,sha256=IMb1kxsbZKGIVmw0-XR904kDHaqPJ
 clitt/core/icons/font_awesome/nav_icons.py,sha256=egiNnVot_diKYL5VFUI3sPTrBSt41F5iO-mpfPZKe20,1182
 clitt/core/icons/font_awesome/trickplay_icons.py,sha256=mb_wXF3j3OhG_6CZyFbOltwwg-l_dyzmNg8OqAkOub8,1080
 clitt/core/icons/font_awesome/widget_icons.py,sha256=y160guCrnRLHxUfKlMq6FS0zsTsJ-gcW1Vs-wnjIjKk,1025
-clitt/core/term/__init__.py,sha256=WzVVID1QWKf3FIXYVX3XK9RtGCARrmpJZIjQox3gIEI,215
+clitt/core/term/__init__.py,sha256=tRAaRvRDHhoYJ6_qvjf534pf9oWo2f3SOmGnWuxb_X0,215
 clitt/core/term/commons.py,sha256=1qRiSDRmaIuT6ivVFUiXd4CU35QJbrVzJvBI-FLwAbo,3122
-clitt/core/term/cursor.py,sha256=3CJDU67SYlsYVbpfv5PI-8y13ece4PGBseJfCxkYfw8,6323
+clitt/core/term/cursor.py,sha256=99NbsU4qWSe29hc_QPLzxGE9JzfTyiDnVUm0GdzfQwk,6780
 clitt/core/term/screen.py,sha256=V24gFKKgTj-aywpkeD1c5zc8cNb5EA4crvfW_bQAIlI,3328
-clitt/core/term/terminal.py,sha256=jQ1NO3jUIxCRhYjw9VxpJYkCK1V0Pv38a9kmiUh8pQs,7723
-clitt/core/tui/__init__.py,sha256=KoqsMhetID08CbORZO6t_lkplFN-JB8RC9CsSrPK3fQ,333
-clitt/core/tui/tui_application.py,sha256=_U9QPWWiKV86n_P864rLZ362MF6DrVU6_H95BXwaBQk,1652
-clitt/core/tui/tui_component.py,sha256=xAubJH8v6iX0iVe8u5HGAgKnPNefMV4lG2Ik5XcMqYM,4879
+clitt/core/term/terminal.py,sha256=mZwkXNzjqHSMXHVx2R5V-56EPE4U0W7YZwMLHLr-mjw,7962
+clitt/core/tui/__init__.py,sha256=ljsXx4BW1CM3TSiBo6SMr2_u4SbbhOH9pi3hBMQVugg,333
+clitt/core/tui/tui_application.py,sha256=V2HvUYzSRSDquoPnj21uIIcXMiz58sWiYA_s7XL2OXk,1650
+clitt/core/tui/tui_component.py,sha256=f4G4Pya9Foc1mlE8sUYHKZ5caqL-R7hyGXu8SHAY8SE,5134
 clitt/core/tui/tui_preferences.py,sha256=QnPLgSg51tQZVKN4p7EpYvzXA3DadOfTmhEKZ6-iWUA,3109
-clitt/core/tui/line_input/__init__.py,sha256=yS373wAJVONCOp3FbBxoj-lbwaNuqPGpC8jXqXkh4Ok,204
-clitt/core/tui/line_input/keyboard_input.py,sha256=fEWZt51Bkq4q8HR1chSE56gMm3tUHTjGjCGrbRceUb4,11987
+clitt/core/tui/line_input/__init__.py,sha256=g8Nx76IvhLqu3MRoCKCDPbZBGDuznav3ILI2yUnNABY,204
+clitt/core/tui/line_input/keyboard_input.py,sha256=P5OHmhU-HReIDYllhHhlNGfkJEO0gXh16WPMtBMs4d8,11686
 clitt/core/tui/line_input/line_input.py,sha256=eFGWTabP27WRakOmpdqrDhJ3DrX9n05EHKWyhtzp37g,1242
-clitt/core/tui/mchoose/__init__.py,sha256=NudoksizAL7MN5mzrlcamwS0v7LQjrwPOCsIEKI8-68,195
+clitt/core/tui/mchoose/__init__.py,sha256=Xb1kxQqLTo_sOMy_RNibr3cDmMhg_raDMX-9T_icRF0,195
 clitt/core/tui/mchoose/mchoose.py,sha256=oyl6esUPgC3j0DrM31Pceb3TDcvprt-D2v8ncd02Asc,1283
 clitt/core/tui/mchoose/menu_choose.py,sha256=IJJQKcfvHRSRI59txSDILHDHLgj3IPo18EJ1_LikAg4,7135
-clitt/core/tui/mdashboard/__init__.py,sha256=AQbLK1Ym599Jeo0c3EWkGHl-Bg8rTHZgLhjjG4hRmj0,253
+clitt/core/tui/mdashboard/__init__.py,sha256=MjNyFIXhSaZ2M7-hOsENWEBcEQDWgXF0RawdjSWTZkw,253
 clitt/core/tui/mdashboard/dashboard_builder.py,sha256=IU2GtrKUbtqkEZSfvCnxdRyodcEmTu5M02LFYOEv0sc,1659
 clitt/core/tui/mdashboard/dashboard_item.py,sha256=KgVxz1oU2iBF5Fi-_ST4ySjBO42fj-DHZ0gO2CA7L8k,887
 clitt/core/tui/mdashboard/mdashboard.py,sha256=UjPPXqTIuO245POzAKprhGo90T5YpvlAJ_lKkAFjWnc,891
 clitt/core/tui/mdashboard/menu_dashboard.py,sha256=Npf-bXOQa_tTQ33RlfZ6TBse0gLfEzT2Yo8zKZ9YcQo,5611
-clitt/core/tui/menu/__init__.py,sha256=SmRzBj85I1aaH757RgA2uvesZQOq5lyF08t5VMmBFxU,286
+clitt/core/tui/menu/__init__.py,sha256=78nKek_1_B1mfN-2JoVCAUlEoQ5wgHazgbwhNGPAiPw,286
 clitt/core/tui/menu/tui_menu.py,sha256=I7uqGD3-028xnNq-rigA3SmS9TDynbF9BQf7qL_r_xk,3573
 clitt/core/tui/menu/tui_menu_action.py,sha256=LC7ljC-d2g7LN6GeHEdZrGyuQUj8FApkeEW3JoRfxEk,1536
 clitt/core/tui/menu/tui_menu_factory.py,sha256=b26JkaBnAAUN_3xQ6GjgRVvljnDBLNouhk9zwyAXpEY,4589
 clitt/core/tui/menu/tui_menu_item.py,sha256=fNU7XC8-fPD7ggOncs5kMnHThiiK9nN_M_1FuvXoKq0,7441
 clitt/core/tui/menu/tui_menu_ui.py,sha256=jND2IWumKooCDuRPzz37YcVOeU9ViL9ZlHoWRptTv4Y,3254
 clitt/core/tui/menu/tui_menu_view.py,sha256=jX1p50dgKLU7JvJL5FJPzI_bLxWzZxjPXem3m9wf2MU,1921
-clitt/core/tui/minput/__init__.py,sha256=wH-chItmZT9xkdloVg75RSSpEGYyBCwVw_5CfTuGz7k,338
+clitt/core/tui/minput/__init__.py,sha256=gJK23gKlhDTkIzEXUafAD-Sco8KGcrUl4vJL4ioZ6yE,338
 clitt/core/tui/minput/access_type.py,sha256=91d_Wxj41pLrv2xs6LDGrSvtYoVHPx5MreXGthN2BFo,637
 clitt/core/tui/minput/field_builder.py,sha256=Zn-JzTHasHtftF_s6N-ljdhxlyLJwqSSeTtj0KPqLRU,4372
 clitt/core/tui/minput/form_builder.py,sha256=xNU62G_g29CpOU5naghvfqaPfb6MlalPxTzJwGD6bXw,2866
@@ -83,15 +83,15 @@ clitt/core/tui/minput/input_validator.py,sha256=7Cof7ZDIjcl8ixrFALZIy6SCe3MZH4Sd
 clitt/core/tui/minput/menu_input.py,sha256=IujdjQaM0QGFziXU5U63bnaZL8JXJw9atckaG3a9wfw,12724
 clitt/core/tui/minput/minput.py,sha256=y_QdSrx0yGH34Iowx_qlqprbWydGmEuh6qDyGIDnqzY,1608
 clitt/core/tui/minput/minput_utils.py,sha256=DgcJyo_NDBp3J5fuWfNzX8JOdSFaekBL-zZqCCPldWA,5266
-clitt/core/tui/mselect/__init__.py,sha256=VXsZgaDWgUdkSBaBD-3OOVN4obKff_LPbpX5VkhM9FY,195
+clitt/core/tui/mselect/__init__.py,sha256=fDiPllenssuSQ3yNu21QZX2PhihNhSDVw53HP70atNY,195
 clitt/core/tui/mselect/menu_select.py,sha256=ltoyB3pEOBPRXrNKMxW6KbaAgcQNIb9y1ZnqyTNMeAc,6176
 clitt/core/tui/mselect/mselect.py,sha256=_UagPoWdDxde5MZvcxoCwi4twpK_nMFxtwmLVG20Yxo,1115
-clitt/core/tui/table/__init__.py,sha256=IorldKgn4EdklkjzyGY5YDqEYsXvlHGu6NfOwFpIe5g,200
+clitt/core/tui/table/__init__.py,sha256=djzG7Kpr4wPuKk0u5ZPv6HfZbOc1GNSu28s5Hdsn2HQ,200
 clitt/core/tui/table/table_enums.py,sha256=9SoecnDrd_X9UmG9wA8mJsfyxtVdZm8LgmTZ51j2yY4,1281
 clitt/core/tui/table/table_renderer.py,sha256=PR8HXYCHQdFs7JDQ-AInblV7HjwIEkRIGl28pdy8yeY,12799
-clitt/utils/__init__.py,sha256=lgGfpus3c0qpj2Sy2ZbtzDhlZ-z9sBH7kIrNFM3NNrw,166
+clitt/utils/__init__.py,sha256=Ma0-N9Y64WPHfbLA4PrZy_YgJXSZdrJQfr0yaEOVPhE,166
 clitt/utils/git_utils.py,sha256=B-QZtRpxAXa3Cw3im5qhJTla0LrlWQouMq_-GR8SOHU,2392
-hspylib_clitt-0.9.127.dist-info/METADATA,sha256=pzI1sdF3C3B08Go0QdoCKkVxiQW1S9Jx8iF1Lq6fkfE,13061
-hspylib_clitt-0.9.127.dist-info/WHEEL,sha256=Wyh-_nZ0DJYolHNn1_hMa4lM7uDedD_RGVwbmTjyItk,91
-hspylib_clitt-0.9.127.dist-info/top_level.txt,sha256=4aPEfxPvYp14dwV0l6cjCd90nbDutt1Yr27ZqCunZLI,11
-hspylib_clitt-0.9.127.dist-info/RECORD,,
+hspylib_clitt-0.9.128.dist-info/METADATA,sha256=KU9DLFaEhDsZET4YunWDcqiGXPi_dMxPuVovQ4fBz74,13061
+hspylib_clitt-0.9.128.dist-info/WHEEL,sha256=HiCZjzuy6Dw0hdX5R3LCFPDmFS4BWl8H-8W39XfmgX4,91
+hspylib_clitt-0.9.128.dist-info/top_level.txt,sha256=4aPEfxPvYp14dwV0l6cjCd90nbDutt1Yr27ZqCunZLI,11
+hspylib_clitt-0.9.128.dist-info/RECORD,,

{hspylib_clitt-0.9.127.dist-info → hspylib_clitt-0.9.128.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (71.1.0)
+Generator: setuptools (72.2.0)
 Root-Is-Purelib: true
 Tag: py3-none-any