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
Requirements
Dependencies
Standard library modules are used where possible; only external dependencies are listed:
- PyQt6 (6.2.0 or higher)
- matplotlib (3.5.0 or higher)
- numpy (1.21.3 or higher)
- pandas (1.3.4 or higher)
- requests (2.25.0 or higher)
Python version
Python (3.10 or higher)
Operating System
Any of the following:
- Windows (10, version 1809 or higher)
- Linux (any modern distribution with glibc 2.28 or higher)
- MacOS (10.14 or higher)
Google Colaboratory support
Most of this library is not compatible with Google Colaboratory, since PyQt6 graphical windows cannot run in a headless environment. However, the following modules are fully compatible:
- Graphs Utilities (graphs): the entire module.
- Formatting Helpers (format): the entire module.
- Input Validation (validation): the entire module except "validate_email()".
- System Utilities (system): the entire module except "get_responsive_width()".
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()).
Graphs Utilities (graphs)
Helpers for creating customizable statistical and analytical charts:
- bar_chart(): creates customizable bar charts for categorical or indexed frequency data.
- pie_chart(): creates customizable pie charts with color palettes generation.
- histogram(): creates customizable histograms with optional frequency polygon overlays and interval-based labels.
- line_chart(): creates customizable line charts with optional filled area display.
- scatter_plot(): creates customizable scatter plots, including bubble charts through variable marker sizes.
- heat_map(): creates customizable heat maps with color palettes generation and optional color bars.
- radar_chart(): creates customizable radar charts for comparing values across multiple categories.
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) 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 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.
- date_time_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:
- in_google_colaboratory(): checks if the runtime environment is Google Colaboratory.
- get_responsive_width(): calculates a responsive width based on screen size to maintain an adaptive UI.
- get_resources_path(): returns the absolute path to a resource file, regardless of whether the program is running as a script in an IDE or as an executable.
Installation
pip install gui_utilities
Update
pip install -U gui_utilities
Metadata
Release files for gui-utilities 1.8.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| gui_utilities-1.8.4.tar.gz | 62.5 kB | Without provenance | Details for gui_utilities-1.8.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| gui_utilities-1.8.4-py3-none-any.whl | Python 3 | none | any | Details for gui_utilities-1.8.4-py3-none-any.whl |
Total release size: 121.8 kB
Release files / gui_utilities-1.8.4.tar.gz
| Download URL | gui_utilities-1.8.4.tar.gz |
|---|---|
| Size | 62.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d5616072471a633a59c6f409acb87237d676067d227a48580ae3012d735a72f6
|
|
BLAKE2b-256 checksum How to use checksums |
cb26afc780d786df4b674eca203531eddc2916dbbb738a8b24733d38163699d1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / gui_utilities-1.8.4-py3-none-any.whl
| Download URL | gui_utilities-1.8.4-py3-none-any.whl |
|---|---|
| Size | 59.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9066503be11e5d827940d48b6d336c77d1dc194e19466e13a05c066f05e409e3
|
|
BLAKE2b-256 checksum How to use checksums |
2bb7d84d7c57b0b5f4d5c0b9ee073206042ee7359cb56c28fbbf048a9200d905
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Security for gui-utilities 1.8.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.