TUI Utilities
Personal-use console utilities library providing styled terminal interaction, structured menus, robust input validation, formatting helpers, and Spanish-oriented user experience.
Purpose
This library is designed for console-based applications that need:
- Clean TUI
- Structured Spanish-language user interaction
- Robust validation
- Consistent formatting
Requirements
Dependencies
Standard library modules are used where possible; only external dependencies are listed:
- rich (9.13.0 or higher)
- readchar (3.0.5 or higher)
- requests (2.25.0 or higher)
Python version
Python (3.9 or higher)
Operating System
Any of the following:
- Windows (8.1 or higher)
- Linux (any modern distribution capable of running Python 3.9 in an interactive terminal environment)
- MacOS (10.9 or higher)
Google Colaboratory support
This library is fully compatible with Google Colaboratory.
Features
Console Utilities (console)
Styled terminal interaction built on rich:
- print(): styled print function built on rich, supporting text styles, alignment, padding, and per-segment styling.
- input(): styled input function built on rich, supporting text styles and automatically trimming whitespaces.
- clear_console(): clears the terminal screen.
- wait_for_key(): pauses execution until the user presses a key.
Structure Utilities (structure)
Tools for building structures in console applications:
- header(): prints a styled header, consisting of a title and a separator.
- menu(): creates interactive selection menus with header and automatic selection validation.
- confirmation_menu(): creates a confirmation dialog with custom message and options.
- confirm_exit(): creates a confirmation dialog that exits the program safely (uses confirmation_menu()).
- table(): creates personalized tables with easy introduction of fully-styled columns and rows.
- separator(): prints a fully-personalized visual separator line.
- error_message(): displays formatted error information including:
- Custom message
- Exception details
- Full traceback
Input Validation (validation)
Interactive validation utilities for user input:
- check_if_list_is_empty(): checks if a list is empty and displays an error screen if it is.
- validate_option(): validates user selection from a dictionary of options.
- validate_string(): ensures non-empty string input.
- validate_integer(): validates integers (uses Continental European numeric format) with optional range validation through an advanced syntax (syntax example: "(-infinity; 0] | 5 | [10; infinity)").
- validate_double(): validates decimal numbers (uses Continental European numeric format) with support for fractions and mathematical constants ("pi", "e", "tau", "phi") and optional range validation through an advanced syntax (syntax example: "(-infinity; 0,1] | 1/3 | [pi; infinity)").
- validate_date_time(): validates date and time input (uses Day–Month–Year date format with 24-hour time) with selectable year, time and second inclusion.
- validate_id(): validates Argentinian national ID numbers.
- validate_cellphone_number(): validates cellphone numbers (uses Argentinian format).
- validate_email(): validates e-mail addresses using an official TLDs list (from IANA's website) or syntax fallback (in case of not having an internet connection or a locally imported list of TLDs).
Formatting Helpers (format)
Utilities for applying consistent formatting:
- decimal_format(): applies Continental European numeric formatting and optional monetary value formatting.
- date_time_format(): formats datetime objects (uses Day–Month–Year date format with 24-hour time) with automatic or custom year, time and second inclusion.
- id_format(): formats Argentinian national ID numbers.
- cellphone_number_format(): formats cellphone numbers (uses Argentinian format).
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.
- get_resources_path(): returns the absolute path to the resources directory, regardless of whether the program is running as a script in an IDE or as an executable.
- in_google_colaboratory(): returns True if the program is running in Google Colaboratory, False otherwise.
Installation
pip install tui_utilities
Update
pip install -U tui_utilities
1 maintainer
Release files for tui-utilities 1.9.17
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tui_utilities-1.9.17.tar.gz | 20.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tui_utilities-1.9.17-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 39.7 kB
Release files / tui_utilities-1.9.17.tar.gz
| Download URL | tui_utilities-1.9.17.tar.gz |
|---|---|
| Size | 20.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2b2491c9b5d09480a27d3904dc28d6fd3cb3588d128853a1854963bc7e261845
|
|
BLAKE2b-256 checksum How to use checksums |
25329fb2b256a15ccb1404305ccff757ede7314a3bba37d5306502dd163847cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / tui_utilities-1.9.17-py3-none-any.whl
| Download URL | tui_utilities-1.9.17-py3-none-any.whl |
|---|---|
| Size | 19.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
31680c0a3fb15682ddbec34b432c2a3b15904186462e48605ab1694c851299f7
|
|
BLAKE2b-256 checksum How to use checksums |
5bed6283853cd5a3418fdc2fde2d7cadae47749d6d7d8bfe6071277b6ea8f249
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
