tui-utilities 1.0.32__tar.gz → 1.1.0__tar.gz

{tui_utilities-1.0.32 → tui_utilities-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tui_utilities
-Version: 1.0.32
+Version: 1.1.0
 Summary: Personal-use console utilities library
 Author-email: Guido Iván Gross <grossguidoivan@gmail.com>
 License: MIT
@@ -58,7 +58,7 @@ Styled terminal interaction built on rich:
 
 - input(): styled input function built on rich, supporting text styles and automatically trimming whitespaces.
 
-- clear_console(): clears the terminal screen (Windows/Linux compatible).
+- clear_console(): clears the terminal screen.
 
 - wait_for_key(): pauses execution until the user presses a key.
 
@@ -68,6 +68,8 @@ Styled terminal interaction built on rich:
 
 Tools for building structures in console applications:
 
+- header(): prints a fully-personalized header, consisting of a title and a separator.
+
 - menu(): creates interactive selection menus with automatic numbering and special options like "Go back" and "Exit".
 
 - confirm_exit(): confirmation dialog that exits the program safely.
@@ -118,6 +120,18 @@ Utilities for applying consistent formatting:
 
 /----------------------------------------------------------------------------------------------------/
 
+### System Utilities (system)
+
+Helpers for interacting with the operating system console environment:
+
+- set_window_title(): sets the console window title.
+
+- maximize_window(): maximizes the console window.
+
+- set_locale(): configures the process locale for number, date, and cultural formatting.
+
+/----------------------------------------------------------------------------------------------------/
+
 ## Installation
 
 pip install tui_utilities

{tui_utilities-1.0.32 → tui_utilities-1.1.0}/README.md

@@ -42,7 +42,7 @@ Styled terminal interaction built on rich:
 
 - input(): styled input function built on rich, supporting text styles and automatically trimming whitespaces.
 
-- clear_console(): clears the terminal screen (Windows/Linux compatible).
+- clear_console(): clears the terminal screen.
 
 - wait_for_key(): pauses execution until the user presses a key.
 
@@ -52,6 +52,8 @@ Styled terminal interaction built on rich:
 
 Tools for building structures in console applications:
 
+- header(): prints a fully-personalized header, consisting of a title and a separator.
+
 - menu(): creates interactive selection menus with automatic numbering and special options like "Go back" and "Exit".
 
 - confirm_exit(): confirmation dialog that exits the program safely.
@@ -102,6 +104,18 @@ Utilities for applying consistent formatting:
 
 /----------------------------------------------------------------------------------------------------/
 
+### System Utilities (system)
+
+Helpers for interacting with the operating system console environment:
+
+- set_window_title(): sets the console window title.
+
+- maximize_window(): maximizes the console window.
+
+- set_locale(): configures the process locale for number, date, and cultural formatting.
+
+/----------------------------------------------------------------------------------------------------/
+
 ## Installation
 
 pip install tui_utilities

{tui_utilities-1.0.32 → tui_utilities-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tui_utilities"
-version = "1.0.32"
+version = "1.1.0"
 description = "Personal-use console utilities library"
 readme = "README.md"
 license = {text = "MIT"}

tui_utilities-1.1.0/tui_utilities/__init__.py

@@ -0,0 +1,14 @@
+from .console import *
+from .structure import *
+from .validation import *
+from .format import *
+from .system import *
+
+__all__ = [
+    "print", "input", "clear_console", "wait_for_key",
+    "header", "menu", "confirm_exit", "separator", "error_message",
+    "check_if_empty", "validate_string", "validate_integer", "validate_double",
+    "validate_date", "validate_id", "validate_cellphone_number", "validate_email",
+    "decimal_format", "id_format", "cellphone_number_format",
+    "set_window_title", "maximize_window", "set_locale"
+]

{tui_utilities-1.0.32 → tui_utilities-1.1.0}/tui_utilities/console.py

@@ -150,7 +150,7 @@ def input(
         plain_text = True
     )).strip()
 
-def clear_console(): os.system("cls" if os.name == "nt" else "clear")
+def clear_console(): os.system("cls")
 
 def wait_for_key(
     text = "Pulse cualquier tecla para continuar...",

{tui_utilities-1.0.32 → tui_utilities-1.1.0}/tui_utilities/structure.py

@@ -16,8 +16,7 @@ def _choose_option(
         selection = input(f"\n{selection_text}", bold = True).upper()
     return selection
 
-def menu(
-    options,
+def header(
     title,
     title_color = "#ffffff",
     title_bold = True,
@@ -31,17 +30,17 @@ def menu(
     title_right_padding = None,
     title_bottom_padding = None,
     title_left_padding = None,
-    separator_length = 100,
+    separator_first_character = "\\",
+    separator_separator_character = "-",
+    separator_last_character = "/",
+    separator_length = None,
     separator_color = "#ffffff",
     separator_aligment = "center",
     separator_padding = 0,
     separator_top_padding = None,
     separator_right_padding = None,
     separator_bottom_padding = 2,
-    separator_left_padding = None,
-    message = "Seleccione una opción:",
-    selection_text = "Su elección: ",
-    error = "La opción ingresada no es válida, intente nuevamente"
+    separator_left_padding = None
 ):
     clear_console()
     print(
@@ -60,7 +59,10 @@ def menu(
         left_padding = title_left_padding
     )
     separator(
-        length = separator_length,
+        first_character = separator_first_character,
+        separator_character = separator_separator_character,
+        last_character = separator_last_character,
+        length = separator_length if separator_length else len(title),
         color = separator_color,
         aligment = separator_aligment,
         padding = separator_padding,
@@ -69,6 +71,63 @@ def menu(
         bottom_padding = separator_bottom_padding,
         left_padding = separator_left_padding
     )
+
+def menu(
+    options,
+    title,
+    title_color = "#ffffff",
+    title_bold = True,
+    title_italic = True,
+    title_underline = False,
+    title_strike = False,
+    title_reverse = False,
+    title_alignment = "center",
+    title_padding = 0,
+    title_top_padding = None,
+    title_right_padding = None,
+    title_bottom_padding = None,
+    title_left_padding = None,
+    separator_first_character = "\\",
+    separator_separator_character = "-",
+    separator_last_character = "/",
+    separator_length = None,
+    separator_color = "#ffffff",
+    separator_aligment = "center",
+    separator_padding = 0,
+    separator_top_padding = None,
+    separator_right_padding = None,
+    separator_bottom_padding = 2,
+    separator_left_padding = None,
+    message = "Seleccione una opción:",
+    selection_text = "Su elección: ",
+    error = "La opción ingresada no es válida, intente nuevamente"
+):
+    header(
+        title = title,
+        title_color = title_color,
+        title_bold = title_bold,
+        title_italic = title_italic,
+        title_underline = title_underline,
+        title_strike = title_strike,
+        title_reverse = title_reverse,
+        title_alignment = title_alignment,
+        title_padding = title_padding,
+        title_top_padding = title_top_padding,
+        title_right_padding = title_right_padding,
+        title_bottom_padding = title_bottom_padding,
+        title_left_padding = title_left_padding,
+        separator_first_character = separator_first_character,
+        separator_separator_character = separator_separator_character,
+        separator_last_character = separator_last_character,
+        separator_length = separator_length,
+        separator_color = separator_color,
+        separator_aligment = separator_aligment,
+        separator_padding = separator_padding,
+        separator_top_padding = separator_top_padding,
+        separator_right_padding = separator_right_padding,
+        separator_bottom_padding = separator_bottom_padding,
+        separator_left_padding = separator_left_padding
+    )
     options_dictionary = {}
     key = 1
     for option in options:
@@ -94,6 +153,9 @@ def confirm_exit(
     if selection == "1": sys.exit()
 
 def separator(
+    first_character = "/",
+    separator_character = "-",
+    last_character = "/",
     length = 100,
     color = "#ffffff",
     aligment = "left",
@@ -103,7 +165,7 @@ def separator(
     bottom_padding = None,
     left_padding = None
 ):
-    print("/" + "-" * length + "/",
+    print(first_character + separator_character * length - 2 + last_character,
         color = color,
         bold = True,
         alignment = aligment,
@@ -117,6 +179,9 @@ def separator(
 def error_message(
     message,
     error,
+    separator_first_character = "/",
+    separator_separator_character = "-",
+    separator_last_character = "/",
     separator_length = 100,
     separator_color = "#ffffff",
     separator_aligment = "left",
@@ -128,6 +193,9 @@ def error_message(
 ):
     print(f"{message}\n", color = "#ff0000", bold = True)
     separator(
+        first_character = separator_first_character,
+        separator_character = separator_separator_character,
+        last_character = separator_last_character,
         length = separator_length,
         color = separator_color,
         aligment = separator_aligment,
@@ -139,6 +207,9 @@ def error_message(
     )
     print(f"Error: {error}", bold = True)
     separator(
+        first_character = separator_first_character,
+        separator_character = separator_separator_character,
+        last_character = separator_last_character,
         length = separator_length,
         color = separator_color,
         aligment = separator_aligment,
@@ -151,6 +222,9 @@ def error_message(
     print("Detalles:\n", bold = True)
     print(traceback.format_exc(), color = "#00bfff")
     separator(
+        first_character = separator_first_character,
+        separator_character = separator_separator_character,
+        last_character = separator_last_character,
         length = separator_length,
         color = separator_color,
         aligment = separator_aligment,

tui_utilities-1.1.0/tui_utilities/system.py

@@ -0,0 +1,9 @@
+import os
+import ctypes
+import locale
+
+def set_window_title(title): os.system(f"title {title}")
+
+def maximize_window(): ctypes.windll.user32.ShowWindow(ctypes.windll.kernel32.GetConsoleWindow(), 3)
+
+def set_locale(locale_identifier = "es_AR.UTF-8"): locale.setlocale(locale.LC_ALL, locale_identifier)

{tui_utilities-1.0.32 → tui_utilities-1.1.0}/tui_utilities.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tui_utilities
-Version: 1.0.32
+Version: 1.1.0
 Summary: Personal-use console utilities library
 Author-email: Guido Iván Gross <grossguidoivan@gmail.com>
 License: MIT
@@ -58,7 +58,7 @@ Styled terminal interaction built on rich:
 
 - input(): styled input function built on rich, supporting text styles and automatically trimming whitespaces.
 
-- clear_console(): clears the terminal screen (Windows/Linux compatible).
+- clear_console(): clears the terminal screen.
 
 - wait_for_key(): pauses execution until the user presses a key.
 
@@ -68,6 +68,8 @@ Styled terminal interaction built on rich:
 
 Tools for building structures in console applications:
 
+- header(): prints a fully-personalized header, consisting of a title and a separator.
+
 - menu(): creates interactive selection menus with automatic numbering and special options like "Go back" and "Exit".
 
 - confirm_exit(): confirmation dialog that exits the program safely.
@@ -118,6 +120,18 @@ Utilities for applying consistent formatting:
 
 /----------------------------------------------------------------------------------------------------/
 
+### System Utilities (system)
+
+Helpers for interacting with the operating system console environment:
+
+- set_window_title(): sets the console window title.
+
+- maximize_window(): maximizes the console window.
+
+- set_locale(): configures the process locale for number, date, and cultural formatting.
+
+/----------------------------------------------------------------------------------------------------/
+
 ## Installation
 
 pip install tui_utilities

{tui_utilities-1.0.32 → tui_utilities-1.1.0}/tui_utilities.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ tui_utilities/__init__.py
 tui_utilities/console.py
 tui_utilities/format.py
 tui_utilities/structure.py
+tui_utilities/system.py
 tui_utilities/validation.py
 tui_utilities.egg-info/PKG-INFO
 tui_utilities.egg-info/SOURCES.txt

tui_utilities-1.0.32/tui_utilities/__init__.py

@@ -1,21 +0,0 @@
-from .console import print, input, clear_console, wait_for_key
-from .structure import menu, confirm_exit, separator, error_message
-from .validation import (
-    check_if_empty,
-    validate_string,
-    validate_integer,
-    validate_double,
-    validate_date,
-    validate_id,
-    validate_cellphone_number,
-    validate_email,
-)
-from .format import decimal_format, id_format, cellphone_number_format
-
-__all__ = [
-    "print", "input", "clear_console", "wait_for_key",
-    "menu", "confirm_exit", "separator", "error_message",
-    "check_if_empty", "validate_string", "validate_integer", "validate_double",
-    "validate_date", "validate_id", "validate_cellphone_number", "validate_email",
-    "decimal_format", "id_format", "cellphone_number_format",
-]