gui-utilities 1.7.0

Personal-use graphical utilities library

GUI Utilities

Personal-use graphical utilities library providing styled PyQt6 interaction, structured menus, robust input validation, formatting helpers, and Spanish-oriented user experience.

/--------------------------------------------------------------------------------------------------------/

Purpose

This library is designed for graphical applications that need:

• Clean UI

• Structured Spanish-language user interaction

• Robust validation

• Consistent formatting

/--------------------------------------------------------------------------------------------------------/

Dependencies

Standard library modules are used where possible; only external dependencies are listed:

• PyQt6

• requests

/--------------------------------------------------------------------------------------------------------/

Features

/--------------------------------------------------------------------------------------------------------/

Core Utilities (core)

Foundational functions for window management and instance control:

• window(): creates a base window already configured with layout and initial styles.

• switch_instance(): dynamically switches the active window instance with a new one.

• clear_layout(): recursively clears and deletes all widgets within a layout.

• switch_content_widget(): dynamically switches the content of the main window's internal widget.

/--------------------------------------------------------------------------------------------------------/

Structure Utilities (structure)

Tools for building UI elements and structures in graphical applications:

• menu(): creates interactive selection menus with header, scrolling, and custom buttons.

• header(): creates a styled header layout, consisting of a title and a separator.

• title(): creates customized titles for windows or menus.

• label(): creates customized text labels with rich HTML formatting options.

• button(): creates customized interactive buttons with hover and pressed styles.

• text_box(): creates customized text inputs with placeholder text and password visibility toggles.

• combo_box(): creates customized drop-down lists with rich text formatting.

• check_box(): creates customized checkboxes with styled indicators.

• table(): creates personalized tables with easy introduction of fully-styled columns and rows (with responsive resizing).

/--------------------------------------------------------------------------------------------------------/

Dialogs Utilities (dialogs)

Pop-up and modal dialog management:

• information_message_box(): creates customized information dialog boxes.

• confirmation_message_box(): creates customized confirmation dialog boxes.

• confirm_exit(): creates a confirmation dialog that exits the program safely (uses confirmation_message_box()).

/--------------------------------------------------------------------------------------------------------/

Input Validation (validation)

Interactive validation utilities using UI dialogs for user input.

• check_if_list_is_empty(): checks if a list is empty and displays an error dialog if it is.

• validate_option(): validates user selection from a list of options.

• validate_string(): ensures non-empty string input.

• validate_integer(): validates integers (uses Continental European numeric format).

• validate_double(): validates decimal numbers (uses Continental European numeric format).

• validate_datetime(): validates date and time input (uses Continental European 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.

• datetime_format(): formats datetime objects (uses Continental European 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).

• html_expression_format(): formats plain-text mathematical expressions (like fractions or superscripts) into HTML code for rich text rendering.

• convert_to_double(): converts string numbers (with Continental European format) into Python floats.

• define_equality_symbol(): returns the equality (=) or approximation (≅) symbol depending on if the number has rounding precision constraints.

/--------------------------------------------------------------------------------------------------------/

System Utilities (system)

Helpers for interacting with the operating system graphical environment:

• get_responsive_width(): calculates a responsive width based on screen size to maintain an adaptive UI.

/--------------------------------------------------------------------------------------------------------/

Installation

pip install gui_utilities

/--------------------------------------------------------------------------------------------------------/

Update

pip install -U gui_utilities