hspylib-clitt 0.9.41__py3-none-any.whl → 0.9.51__py3-none-any.whl

clitt/core/tui/tui_screen.py

@@ -1,222 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-
-"""
-   @project: HsPyLib-Clitt
-   @package: clitt.core.tui
-      @file: tui_screen.py
-   @created: Thu, 22 Jun 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 2023, HsPyLib team
-"""
-from clitt.core.tui.tui_preferences import TUIPreferences
-from hspylib.core.enums.enumeration import Enumeration
-from hspylib.core.metaclass.singleton import Singleton
-from hspylib.core.tools.commons import sysout
-from hspylib.core.tools.text_tools import last_index_of
-from hspylib.modules.cli.vt100.vt_code import VtCode
-from hspylib.modules.cli.vt100.vt_color import VtColor
-from hspylib.modules.cli.vt100.vt_utils import (clear_screen, get_cursor_position, restore_cursor, restore_terminal,
-                                                save_cursor, screen_size)
-from threading import Timer
-from typing import Any, Callable, List, Optional, Tuple, TypeVar, Union
-
-import atexit
-import os
-import threading
-
-DIMENSION = TypeVar("DIMENSION", bound=Tuple[int, ...])
-
-POSITION = TypeVar("POSITION", bound=Tuple[int, int])
-
-CB_RESIZE = TypeVar("CB_RESIZE", bound=Callable[[None], None])
-
-MOVE_DIRECTION = TypeVar("MOVE_DIRECTION", bound="TUIScreen.CursorDirection")
-
-ERASE_DIRECTION = TypeVar("ERASE_DIRECTION", bound=Union["TUIScreen.CursorDirection", "TUIScreen.ScreenPortion"])
-
-
-class TUIScreen(metaclass=Singleton):
-    """Provide a base class for terminal UI components."""
-
-    INSTANCE = None
-
-    RESIZE_WATCH_INTERVAL = 0.5
-
-    class CursorDirection(Enumeration):
-        """Provide a base class for the cursor direction."""
-
-        # fmt: off
-        UP          = '%ED1%', '%CUU({n})%'   # Cursor up (line)
-        RIGHT       = '%EL0%', '%CUF({n})%'   # Cursor right (forward)
-        DOWN        = '%ED0%', '%CUD({n})%'   # Cursor down (line)
-        LEFT        = '%EL1%', '%CUB({n})%'   # Cursor left (backward)
-        # fmt: on
-
-    class ScreenPortion(Enumeration):
-        """Provide a base class for the portions of the screen."""
-
-        # fmt: off
-        SCREEN      = '%ED2%', ''   # Entire screen (screen)
-        LINE        = '%EL2%', ''   # Entire line (line)
-        # fmt: on
-
-    class Cursor(metaclass=Singleton):
-        """Provide a base class for the screen cursor."""
-
-        CURSOR_HOME = 1, 1
-
-        def __init__(self):
-            self._position: POSITION = get_cursor_position() or self.CURSOR_HOME
-            self._bottom: POSITION = self.CURSOR_HOME
-            self._saved_attrs = self._position, self._bottom
-
-        def __str__(self):
-            return f"({', '.join(list(map(str, self._position)))})"
-
-        def __repr__(self):
-            return str(self)
-
-        @property
-        def position(self) -> POSITION:
-            return self._position
-
-        @position.setter
-        def position(self, new_position: POSITION) -> None:
-            self._bottom = (new_position[0], new_position[1]) if new_position >= self._bottom else self._bottom
-            self._position = new_position
-
-        @property
-        def bottom(self) -> POSITION:
-            return self._bottom
-
-        def home(self) -> None:
-            """Move the cursor to home position."""
-            self.move_to(self.CURSOR_HOME[0], self.CURSOR_HOME[1])
-
-        def end(self) -> None:
-            """Move the cursor to the bottom most position on the screen."""
-            self.move_to(self.bottom[0], self.bottom[1])
-
-        def move_to(self, row: int = None, column: int = None) -> POSITION:
-            """Move the cursor to the specified position."""
-            row_pos = max(self.CURSOR_HOME[0], row if row is not None else self.position[0])
-            col_pos = max(self.CURSOR_HOME[1], column if column is not None else self.position[1])
-            sysout(f"%CUP({row_pos};{col_pos})%", end="")
-            self.position = row_pos, col_pos
-            return self.position
-
-        def move(self, amount: int, direction: MOVE_DIRECTION) -> POSITION:
-            """Move the cursor towards the specified direction."""
-            sysout(direction.value[1].format(n=amount), end="")
-            row_pos, col_pos = self.position
-            match direction:
-                case TUIScreen.CursorDirection.UP:
-                    row_pos -= max(0, amount)
-                case TUIScreen.CursorDirection.DOWN:
-                    row_pos += max(0, amount)
-                case TUIScreen.CursorDirection.LEFT:
-                    col_pos -= max(0, amount)
-                case TUIScreen.CursorDirection.RIGHT:
-                    col_pos += max(0, amount)
-            self.position = row_pos, col_pos
-            return self.position
-
-        def erase(self, direction: ERASE_DIRECTION) -> POSITION:
-            """Erase the screen following the specified direction.
-            Note: It does not move the cursor along the way."""
-            sysout(direction.value[0], end="")
-            return self.position
-
-        def track(self) -> POSITION:
-            """Track the cursor position."""
-            self.position = get_cursor_position() or self.position
-            return self.position
-
-        def write(self, obj: Any, end: str = "") -> POSITION:
-            """Write the string representation of the object to the screen."""
-            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)) :])
-            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:
-            """Write the string representation of the object to the screen, appending a new line."""
-            return self.write(obj, end=os.linesep)
-
-        def save(self) -> POSITION:
-            """Save the current cursor position and attributes."""
-            save_cursor()
-            self._saved_attrs = self._position, self._bottom
-            return self.position
-
-        def restore(self) -> POSITION:
-            """Save the current cursor position and attributes."""
-            restore_cursor()
-            self._position = self._saved_attrs[0]
-            self._bottom = self._saved_attrs[1]
-            return self.position
-
-    def __init__(self):
-        self._preferences: TUIPreferences = TUIPreferences.INSTANCE or TUIPreferences()
-        self._dimension: DIMENSION = screen_size()
-        self._cursor: TUIScreen.Cursor = self.Cursor()
-        self._resize_timer: Optional[Timer] = None
-        self._cb_watchers: List[CB_RESIZE] = []
-
-        atexit.register(restore_terminal)
-        self._resize_watcher()
-
-    def __str__(self):
-        return f"TUIScreen(rows={self.rows}, columns={self.columns}, cursor={self.cursor})"
-
-    def __repr__(self):
-        return str(self)
-
-    @property
-    def preferences(self) -> TUIPreferences:
-        return self._preferences
-
-    @property
-    def dimension(self) -> DIMENSION:
-        return self._dimension
-
-    @property
-    def rows(self) -> int:
-        return self._dimension[0]
-
-    @property
-    def columns(self) -> int:
-        return self._dimension[1]
-
-    @property
-    def cursor(self) -> Cursor:
-        return self._cursor
-
-    def clear(self) -> None:
-        """Clear the entire screen and move the cursor home."""
-        clear_screen()
-        self._cursor.home()
-
-    def add_watcher(self, watcher: CB_RESIZE) -> None:
-        """Add a resize watcher."""
-        self._cb_watchers.append(watcher)
-        if not self._resize_timer:
-            self._resize_watcher()
-
-    def _resize_watcher(self) -> None:
-        """Add a watcher for screen resizes. If a resize is detected, the callback is called with the new dimension."""
-        if self._cb_watchers and threading.main_thread().is_alive():
-            dimension: DIMENSION = screen_size()
-            self._resize_timer = Timer(self.RESIZE_WATCH_INTERVAL, self._resize_watcher)
-            if dimension != self._dimension:
-                list(map(lambda cb_w: cb_w(), self._cb_watchers))
-                self._dimension = dimension
-            self._resize_timer.start()

hspylib_clitt-0.9.41.dist-info/RECORD

@@ -1,94 +0,0 @@
-clitt/.version,sha256=bMVFlT_4Puym0BzsglaZmuYxW-b7mDddvOpIPNcZ9v8,7
-clitt/__classpath__.py,sha256=j7k_kckSu-7r0RB630enzF3JH_1z2J7RByxp2ZZNdmg,717
-clitt/__init__.py,sha256=amd0_NegCohwezpaD1PhgIwYLAQCU-gByFz7bZB99BY,164
-clitt/__main__.py,sha256=oRU7vQuKIWyArdoXrseaVlUGkkK0n8Z0iFOwXDYOA48,6968
-clitt/welcome.txt,sha256=x4oQU6m_9g75x4d7tLriPkFR6I_4MLhlHRzqwBIC-lA,452
-clitt/addons/__init__.py,sha256=44MYVnSnVH3Ft-dCTumsfAOLBI9V4nYCd4PYv61Z9yM,186
-clitt/addons/appman/__init__.py,sha256=yUgDmYQbLwEZ51o5KOXdYYDpFpf4HmRYRppWQct4Mb8,202
-clitt/addons/appman/appman.py,sha256=-fwijYySTWoyoAwzWFycIdScBkStH7VLFr-4bFuGXw8,13150
-clitt/addons/appman/appman_enums.py,sha256=vBCmCSGYfVY1VwyEAw9UzbcvNkZSGvHtlUhBBMgcDz0,872
-clitt/addons/appman/templates/__init__.py,sha256=7vaTOVdeIu9mg0tADgD7vOpakZOT2XlSAXt9Lvgf2q0,169
-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
-clitt/addons/appman/templates/gitignore.tpl,sha256=OLb8eoac2nnG1lvZL2l7J_3mc94i6xTuIfCV-J8aFSM,903
-clitt/addons/appman/templates/main.py.tpl,sha256=bHvc8yrqn-8Ksm0vaBxufGaWwvsEd27DX8YPYULLDro,1506
-clitt/addons/appman/templates/main_qt.py.tpl,sha256=1nlBCVjZZmIackSpBQwgWm6ygYQGpjodI9oHuLucw58,1043
-clitt/addons/appman/templates/main_qt_view.py.tpl,sha256=mGGsuXY88MPugt9fvZdCK_yiAxedTeikrcSIWeHh8Jc,626
-clitt/addons/appman/templates/main_qt_view.ui.tpl,sha256=JbEz9xU_50_Fd8FCKC33WPCz4De0egg1eW2xvP8wzJI,2780
-clitt/addons/appman/templates/run.sh.tpl,sha256=2xpuHjZP9-7j14dAA2CqPm4G2xtnuenf-RBe3LdC2rI,150
-clitt/addons/appman/templates/test_main.py.tpl,sha256=x_xuKy2O2b1bs6tuzOUqF5shnx-2-EfFRc7sBV4Fndc,1239
-clitt/addons/appman/templates/usage.txt.tpl,sha256=R0e48HCeD7PDbWnX6HGIjz6gr_hBdp-zK6V42U1Aexw,217
-clitt/addons/appman/templates/widget.py.tpl,sha256=JmlO5rh2ETCF5ldiB9MStfjB4oB4JLI8UUnNP5SAAcM,1668
-clitt/addons/setman/__init__.py,sha256=0g55Z7qdRcSRLDx-5_wKBHcCS8IT5Xc0a2me_A97udE,206
-clitt/addons/setman/setman.py,sha256=ASkaSPCUnV6D_l9Uwmuc_A_ueMZnXKv1rpEpV3Gb60o,5606
-clitt/addons/setman/setman_config.py,sha256=jTREC8x4cYleA9B3GbkeyuQkGNfYk6gncH4qJ3VgJck,827
-clitt/addons/setman/setman_enums.py,sha256=2RIZRyLbfUmbuaJR_x7gKC9nuofBbTP18sxFMRaJwLw,1280
-clitt/addons/widman/__init__.py,sha256=WPQ89aL4WmVP0-Jbp2xCg4O1lJjjGgKWz11RS3pq6g0,213
-clitt/addons/widman/widget.py,sha256=mIEB3Fs4ypaUMhh85meg2vMhKJVjW8Tyxkp_XqHIHtA,1920
-clitt/addons/widman/widget_entry.py,sha256=8Shj4_esh6KN69usTrCcUsfGVas81Xz0QabsY_zV9o0,1350
-clitt/addons/widman/widman.py,sha256=kfv3CcDSjUZglurPXa4Bv1jYELtEkbixOjpVL8yRf3M,5260
-clitt/addons/widman/widgets/__init__.py,sha256=EqWldlczNf3OZctZon2YO4jBlTigQ3nhzgNg0lswWfA,244
-clitt/addons/widman/widgets/widget_free.py,sha256=5imXWD4F984KqwcWuI-ZuBaF1gtNha0TAmmaiIZ-MVg,3997
-clitt/addons/widman/widgets/widget_punch.py,sha256=YQ27qC15gyt1jn-R4oNumVLVbMzbs3s7I0yLPqpR8xY,10535
-clitt/addons/widman/widgets/widget_send_msg.py,sha256=MMBOGTBc6c3jgLgZBzbQIiQsSs5jl-8ohqy7evMSNQU,11056
-clitt/addons/widman/widgets/widget_time_calc.py,sha256=JQOHRf5OFDL73Y-GJEWtdN5_s2vKR-9mX0yoisxNQRg,5100
-clitt/core/__init__.py,sha256=V5kSvNXhj66NE8XPh9kJ8_NdwBvEk6ljPKE08caW4C0,182
-clitt/core/icons/__init__.py,sha256=9x0_25QYPUDTi3tZgrGntBiAo_OUukBCB9fTIg4uyLs,183
-clitt/core/icons/emojis/__init__.py,sha256=V8lfW4y7PaMlyLzAP_eesjQfyij-c6dRjBiMYoy0sdU,190
-clitt/core/icons/emojis/emojis.py,sha256=LbwpjJonRlNVPa6eMEDTreQz1fmFfFK4dOk6X-4XHrI,1109
-clitt/core/icons/emojis/face_smiling.py,sha256=qho6t7W3za6-H9bW51_0RoYKah_f0_DCJ0EiCiwvQwI,1269
-clitt/core/icons/font_awesome/__init__.py,sha256=MPUx1veXCxxU52RZVqzw7c8gA400IDm-ZswYfkPADYg,288
-clitt/core/icons/font_awesome/app_icons.py,sha256=cMPlXVWOn5YnLmlk20nwhFgA16Ug2jFiHZPYlwwH724,1662
-clitt/core/icons/font_awesome/awesome.py,sha256=oEOi0DWj0yvJbmg18fXE5hgSrMmCckTYC0cbgw1cyQQ,1831
-clitt/core/icons/font_awesome/control_icons.py,sha256=OuAnvXRIusxDRVnPHxltTn4V6tF_uc2gfoqoQWB7Bks,1075
-clitt/core/icons/font_awesome/dashboard_icons.py,sha256=MGXLJ-I_xXalOaLeWHkaZe5ZIqdycNLg4S-L7abBHEU,3085
-clitt/core/icons/font_awesome/form_icons.py,sha256=mDF_0nFJ9VYO2ZoXWSTETm7qEd03dcIgeCUpFnH0sLI,2314
-clitt/core/icons/font_awesome/nav_icons.py,sha256=A3GqJuwD-RKybY67THimI1oqcNlDSEaA_Hdy8LSzfqo,1105
-clitt/core/icons/font_awesome/widget_icons.py,sha256=Oho4jPezyMSw-tKWSjpdK3dv-FK2GC_62liNeThhhAs,1024
-clitt/core/settings/__init__.py,sha256=cAmkcHWr9sYLwt4qBqT_8eln04Lkv7EICTveJFw0VkQ,261
-clitt/core/settings/settings.py,sha256=StADql3wxNnjjJ4be-i1UlRjmMVidvbHSuyTO4Zi7xg,6940
-clitt/core/settings/settings_config.py,sha256=iSNvXrlZLV9a3rveese1dnJJ3G2D3XqLFPjUqasblaE,1404
-clitt/core/settings/settings_entry.py,sha256=zrN34_Q5eDMfsP_zor04CWlrmFpPsyS97ODKSAckxd4,3453
-clitt/core/settings/settings_repository.py,sha256=hWAxIbJe_5Bldmm0OtlSDS1i-H4AbNW1Vzq3nhXG_k4,3598
-clitt/core/settings/settings_service.py,sha256=JvRCtxM9iYV495bkFk3GUt0O2nLbEsSauC-OGK7H8wE,1759
-clitt/core/tui/__init__.py,sha256=8HPdzPJ7HQ6H36QZDdn5RHbiPBMU6zmtpBwlUkUNYpM,311
-clitt/core/tui/tui_application.py,sha256=kBYc_IUrVrZ6v7MZ6A8QJ9hONDpXwqO9TqJa_XBsM8E,1611
-clitt/core/tui/tui_component.py,sha256=TXHmSQYowmeuUcj_V4y-W94BlTNfsZaA_RsYr_mlA_w,4670
-clitt/core/tui/tui_preferences.py,sha256=Qh9TKtGT_XFSyoW3dUoKKoPrzwG7im6k_lFbRZRKojo,4712
-clitt/core/tui/tui_screen.py,sha256=oLT-3YRbZR24yd0tzboB4gLr45mECUsyxtlEocbn4hs,8372
-clitt/core/tui/mchoose/__init__.py,sha256=2g0N07krOljHfM9rKJtqKK4emfiKMqPTmplqCntzoTc,189
-clitt/core/tui/mchoose/mchoose.py,sha256=ZW7mr7WCP2Lc545PBy2-QRaUt6BNYP5cAwczooU86eU,1180
-clitt/core/tui/mchoose/menu_choose.py,sha256=ghPyNzkBz8YPtQGp91kFrLwHgyW0-nf0YFEmeDO2b6E,7012
-clitt/core/tui/mdashboard/__init__.py,sha256=YzEIT5TMjw3FdJDW62vjqu1yauQSzj0GxI5ChAdsXkE,243
-clitt/core/tui/mdashboard/dashboard_builder.py,sha256=wWcT1UyQnOrvalV920XtmBUg5lRVbhA8hMrmxRcLrtY,1658
-clitt/core/tui/mdashboard/dashboard_item.py,sha256=4MK6bxROWo1ZK9FlMoSm38z0qe5HoxqH0W5tt3iUT5M,886
-clitt/core/tui/mdashboard/mdashboard.py,sha256=juNPFzmoKQRJa2CZFxVZAFr2QXFna3cvsoYlFNaQjis,890
-clitt/core/tui/mdashboard/menu_dashboard.py,sha256=PwZ4YwcF_CODvWlGH6ekDgRUuSV6pHEnj3ehwv2mIVY,5524
-clitt/core/tui/menu/__init__.py,sha256=Xx_uSJCLYxm9pZfm2tPgrIvw7mkrau0buUXUNLNcEJE,272
-clitt/core/tui/menu/tui_menu.py,sha256=nAux3qJ6_kyvV6Z2IbIG6dS62zFfTo5qA4rB8cXAIYk,3593
-clitt/core/tui/menu/tui_menu_action.py,sha256=KqhG_YkEMWF37uoI7Q_bCr3jHLIeTbDr_-uROuhAvB0,1590
-clitt/core/tui/menu/tui_menu_factory.py,sha256=rL33KX5yD2ppvVRAEFIAme5ka7GrBQecVr63aUf2hf0,4459
-clitt/core/tui/menu/tui_menu_item.py,sha256=ZZA4maFlzVERlHkKygIuCuOS5ljOIg2wpL_e2M6MMpo,7480
-clitt/core/tui/menu/tui_menu_ui.py,sha256=mwXvTDHKctMVUOPMZiN0fFxgx0ASHOTYuk-R7UVoxYg,3424
-clitt/core/tui/menu/tui_menu_view.py,sha256=WWcMqWsPgFX7XoyU9Z5q_zCP_wboc69SPWM0bnQWKFQ,1942
-clitt/core/tui/minput/__init__.py,sha256=PVqosPDOpKBujVlYGqb8mZluWB3S6pXBOsVr_UwCbns,318
-clitt/core/tui/minput/access_type.py,sha256=Dss6okfXHCoUI3_OOu2nKsgpy2NeStIwhdDvTR2z-2w,636
-clitt/core/tui/minput/field_builder.py,sha256=5te6nDYHCa9VmzGK0b1lXRCc7n4GbMIVIR2InLdLzXg,4414
-clitt/core/tui/minput/form_builder.py,sha256=CwUpswLD9rTCs3PXaOpu0bFKavHsbUkgs4OnQgbS-RQ,2865
-clitt/core/tui/minput/form_field.py,sha256=5p-IT_2RgzkU4RfyXihrNdD9_yV4X5FqNgIckDE9zEQ,5766
-clitt/core/tui/minput/input_type.py,sha256=O6-jk_QSjjRGeHsGVzIDZSCLg739f2xtnVV_ElcHYpA,722
-clitt/core/tui/minput/input_validator.py,sha256=XjK9O435OIvuyAHAY7XJt_ELvJ-sJsWIO-jv6hVt2-c,3360
-clitt/core/tui/minput/menu_input.py,sha256=rL_lgcCC0Q6FbDECmUGlfHwKOHjYjBpUhpiFFzGZCM8,12749
-clitt/core/tui/minput/minput.py,sha256=20Vz-SRVaNuqYJrG6kdkdE4bVy_YNjXEcYaFEnRCqNQ,1532
-clitt/core/tui/minput/minput_utils.py,sha256=KAWUBPORhbv-s2ycHAHoSLeLWoRRgzUST7lm2FPskXQ,5277
-clitt/core/tui/mselect/__init__.py,sha256=mSwPMcSbU2hBGofaC2y1ZGcf6tw0ZKe02ZyVN13F2DA,189
-clitt/core/tui/mselect/menu_select.py,sha256=k6Gpqkrbrkstp84KKhvxrmrpwNYp99jmR_EOl4SP5Ow,6174
-clitt/core/tui/mselect/mselect.py,sha256=3Q4X2XMqhXCicO5XhDXsldn9m-1bWOQ9ez1MLMj8fps,1040
-clitt/core/tui/table/__init__.py,sha256=nKtKp_w_a3mwuvrwAsYHS7_Vt8CsKWbAS3uBT0o_rC0,194
-clitt/core/tui/table/table_enums.py,sha256=gbA2e7kgpjLjL8oxbIGalcX-cyaXPfdXy01wzivqpWc,1183
-clitt/core/tui/table/table_renderer.py,sha256=2vn0-3OuSA5tMdsfQJMtgSVXMFMuy-EAmrUIH2AiH2g,9646
-hspylib_clitt-0.9.41.dist-info/METADATA,sha256=Tvztfk_3VYqGz4l5jrPA0AhJokvThPEaxOfpS3bU1Zs,1728
-hspylib_clitt-0.9.41.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
-hspylib_clitt-0.9.41.dist-info/top_level.txt,sha256=vrnpkFU7dZ-vH7x5xdcY1vJSuboTqPBUcc3jD6SJkAo,6
-hspylib_clitt-0.9.41.dist-info/RECORD,,