gui-utilities 1.3.30__tar.gz → 1.3.42__tar.gz

{gui_utilities-1.3.30 → gui_utilities-1.3.42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gui_utilities
-Version: 1.3.30
+Version: 1.3.42
 Summary: Librería de utilidades gráficas en PyQt6
 Author-email: Guido Iván Gross <grossguidoivan@gmail.com>
 Requires-Python: >=3.8

{gui_utilities-1.3.30 → gui_utilities-1.3.42}/gui_utilities/gui_utilities.py

@@ -9,8 +9,8 @@ main_dir = importlib.resources.files("gui_utilities")
 icons_dir = main_dir / "icons"
 tlds_path = main_dir / "tlds"
 
-def create_window(title, background_color = "#1e1e1e"):
-    window = QWidget()
+def create_window(title, background_color = "#1e1e1e", parent = None):
+    window = QWidget(parent)
     window.setObjectName("window")
     window.setWindowTitle(title)
     window.setStyleSheet(f"#window {{background-color: {background_color};}}")
@@ -33,7 +33,9 @@ def create_menu(
     title_padding_bottom = None,
     title_border_width = 0,
     title_border_color = "#ffffff",
-    title_border_radius = 0
+    title_border_radius = 0,
+    math_expression = False,
+    title_alignment = Qt.AlignmentFlag.AlignCenter
 ):
     main_layout = QVBoxLayout()
     main_layout.setContentsMargins(25, 25, 25, 25)
@@ -50,7 +52,9 @@ def create_menu(
         padding_bottom = title_padding_bottom,
         border_width = title_border_width,
         border_color = title_border_color,
-        border_radius = title_border_radius
+        border_radius = title_border_radius,
+        math_expression = math_expression,
+        alignment = title_alignment
     ))
     body_layout = QHBoxLayout()
     main_layout.addLayout(body_layout)
@@ -102,7 +106,9 @@ def create_header(
     title_padding_bottom = None,
     title_border_width = 0,
     title_border_color = "#ffffff",
-    title_border_radius = 0
+    title_border_radius = 0,
+    math_expression = False,
+    title_alignment = Qt.AlignmentFlag.AlignCenter
 ):
     main_layout = QVBoxLayout()
     main_layout.setContentsMargins(margin_left, margin_top, margin_right, margin_bottom)
@@ -119,7 +125,9 @@ def create_header(
         padding_bottom = title_padding_bottom,
         border_width = title_border_width,
         border_color = title_border_color,
-        border_radius = title_border_radius
+        border_radius = title_border_radius,
+        math_expression = math_expression,
+        alignment = title_alignment
     )
     main_layout.addLayout(title_layout)
     main_layout.addStretch()
@@ -138,11 +146,12 @@ def create_title(
     padding_bottom = None,
     border_width = 0,
     border_color = "#ffffff",
-    border_radius = 0
+    border_radius = 0,
+    math_expression = False,
+    alignment = Qt.AlignmentFlag.AlignCenter
 ):
     title_layout = QHBoxLayout()
     title_layout.setContentsMargins(0, 0, 0, 25)
-    title_layout.setAlignment(Qt.AlignmentFlag.AlignCenter)
     title_label = create_label(
         text = text,
         font_family = font_family,
@@ -157,7 +166,9 @@ def create_title(
         padding_bottom = padding_bottom,
         border_width = border_width,
         border_color = border_color,
-        border_radius = border_radius
+        border_radius = border_radius,
+        math_expression = math_expression,
+        alignment = alignment
     )
     title_layout.addWidget(title_label)
     return title_layout
@@ -183,9 +194,30 @@ def create_label(
         disabled_font_color = "#888888",
         disabled_background_color = "transparent",
         disabled_border_width = 0,
-        disabled_border_color = "#4a4a4a"
+        disabled_border_color = "#4a4a4a",
+        math_expression = False,
+        transparent_for_mouse = False,
+        alignment = None,
+        word_wrap = False,
+        parent = None
 ):
-    label = QLabel(text)
+    def latex_to_html(expression):
+        html_expression = expression
+        html_expression = re.sub(r"\\frac\{(.*?)\}\{(.*?)\}", r"<span style='font-size:90%;'>\1⁄\2</span>", html_expression)
+        html_expression = re.sub(r"_\{([^}]+)\}", r"<sub>\1</sub>", html_expression)
+        html_expression = re.sub(r"\^\{([^}]+)\}", r"<sup>\1</sup>", html_expression)
+        html_expression = re.sub(r"_([a-zA-Z0-9]+)", r"<sub>\1</sub>", html_expression)
+        html_expression = re.sub(r"\^([a-zA-Z0-9]+)", r"<sup>\1</sup>", html_expression)
+        html_expression = html_expression.replace(" ", "&nbsp;")
+        return html_expression
+    
+    if math_expression:
+        label = QLabel(latex_to_html(text), parent)
+        label.setTextFormat(Qt.TextFormat.RichText)
+    else: label = QLabel(text, parent)
+    if transparent_for_mouse: label.setAttribute(Qt.WidgetAttribute.WA_TransparentForMouseEvents, True)
+    if alignment: label.setAlignment(alignment)
+    if word_wrap: label.setWordWrap(True)
     padding_left_value = padding_left if padding_left is not None else padding
     padding_top_value = padding_top if padding_top is not None else padding
     padding_right_value = padding_right if padding_right is not None else padding
@@ -242,10 +274,12 @@ def create_button(
     disabled_background_color = "#2d2d2d",
     disabled_border_width = 2,
     disabled_border_color = "#4a4a4a",
-    maximum_width = 360
+    maximum_width = 360,
+    math_expression = False,
+    parent = None
 ):
-    button = QPushButton()
-    button.setMaximumWidth(maximum_width)
+    button = QPushButton(parent)
+    if maximum_width is not None: button.setMaximumWidth(maximum_width)
     main_layout = QVBoxLayout()
     button.setLayout(main_layout)
     main_layout.setContentsMargins(0, 0, 0, 0)
@@ -259,9 +293,11 @@ def create_button(
         padding_top = padding_top,
         padding_right = padding_right,
         padding_bottom = padding_bottom,
-        disabled_border_width = disabled_border_width
+        disabled_border_width = disabled_border_width,
+        transparent_for_mouse = True,
+        alignment = Qt.AlignmentFlag.AlignCenter,
+        math_expression = math_expression
     )
-    label.setAlignment(Qt.AlignmentFlag.AlignCenter)
     label.setWordWrap(True)
     main_layout.addWidget(label)
     button.setFixedHeight(main_layout.sizeHint().height() + 2 * border_width)
@@ -315,6 +351,7 @@ def create_text_box(
     border_width = 2,
     border_color = "#5c5c5c",
     border_radius = 0,
+    placeholder_font_color = "#888888",
     hover_background_color = "#333333",
     hover_border_width = 3,
     hover_border_color = "#777777",
@@ -330,9 +367,9 @@ def create_text_box(
     focused_show_text_icon_url = str(icons_dir / "focused_show_text_icon.png"),
     focused_hide_text_icon_url = str(icons_dir / "focused_hide_text_icon.png"),
     hide_text = False,
-    math_expression = False
+    parent = None
 ):
-    text_box = QLineEdit()
+    text_box = QLineEdit(parent)
     padding_left_value = padding_left if padding_left is not None else padding
     padding_top_value = padding_top if padding_top is not None else padding
     padding_right_value = padding_right if padding_right is not None else padding
@@ -366,36 +403,7 @@ def create_text_box(
         }}
     """
     text_box.setStyleSheet(style_sheet)
-
-    def latex_to_html(expression):
-        html_expression = expression
-        html_expression = re.sub(r"\\frac\{(.*?)\}\{(.*?)\}", r"<span style='font-size:90%;'>\1⁄\2</span>", html_expression)
-        html_expression = re.sub(r"([a-zA-Z])_(\d+)", r"\1<sub>\2</sub>", html_expression)
-        html_expression = re.sub(r"([a-zA-Z0-9])\^(\d+)", r"\1<sup>\2</sup>", html_expression)
-        html_expression = html_expression.replace(" ", "&nbsp;")
-        return html_expression
-    
-    if not math_expression: text_box.setPlaceholderText(placeholder_text)
-    else:
-        html_placeholder = latex_to_html(placeholder_text)
-        placeholder_label = create_label(
-            text = html_placeholder,
-            font_color = font_color,
-            font_family = font_family,
-            font_size = font_size,
-            background_color = background_color,
-            hover_background_color = hover_background_color,
-            disabled_background_color = disabled_background_color,
-        )
-        placeholder_label.setTextFormat(Qt.TextFormat.RichText)
-        placeholder_label.setAttribute(Qt.WidgetAttribute.WA_TransparentForMouseEvents)
-        placeholder_label.show()
-
-        def update_placeholder_visibility():
-            placeholder_label.setVisible(text_box.text() == "")
-        
-        text_box.textChanged.connect(update_placeholder_visibility)
-        update_placeholder_visibility()
+    text_box.setPlaceholderText(placeholder_text)
     if hide_text:
         show_text_icon = QIcon(show_text_icon_url)
         hide_text_icon = QIcon(hide_text_icon_url)
@@ -409,37 +417,43 @@ def create_text_box(
         toggle_text_visibility_button.setIconSize(QSize(25, 25))
         toggle_text_visibility_action = QWidgetAction(text_box)
         toggle_text_visibility_action.setDefaultWidget(toggle_text_visibility_button)
-        style_sheet = f"""
-            QToolButton {{
+        text_box.addAction(toggle_text_visibility_action, QLineEdit.ActionPosition.TrailingPosition)
+        toggle_text_visibility_button.setStyleSheet("""
+            QToolButton {
                 background-color: transparent;
                 border: none;
                 margin-right: 10px;
-            }}
-        """
-        toggle_text_visibility_button.setStyleSheet(style_sheet)
-        text_box.addAction(toggle_text_visibility_action, QLineEdit.ActionPosition.TrailingPosition)
+            }
+        """)
 
         def update_icon():
             is_password = text_box.echoMode() == QLineEdit.EchoMode.Password
             if text_box.hasFocus(): icon = focused_hide_text_icon if is_password else focused_show_text_icon
             else: icon = hide_text_icon if is_password else show_text_icon
             toggle_text_visibility_button.setIcon(icon)
-
+        
         def toggle_visibility():
             if text_box.echoMode() == QLineEdit.EchoMode.Password: text_box.setEchoMode(QLineEdit.EchoMode.Normal)
             else: text_box.setEchoMode(QLineEdit.EchoMode.Password)
             update_icon()
-
+        
         toggle_text_visibility_button.clicked.connect(toggle_visibility)
 
-        class FocusWatcher(QObject):
+        class _IconFocusWatcher(QObject):
+
+            def __init__(self, watched, on_focus_change):
+                super().__init__(watched)
+                self._watched = watched
+                self._on_focus_change = on_focus_change
+            
             def eventFilter(self, watched, event):
-                if event.type() in (QEvent.Type.FocusIn, QEvent.Type.FocusOut): update_icon()
+                if watched is self._watched and event.type() in (QEvent.Type.FocusIn, QEvent.Type.FocusOut):
+                    if callable(self._on_focus_change): self._on_focus_change()
                 return super().eventFilter(watched, event)
-
-        focus_watcher = FocusWatcher(text_box)
-        text_box.installEventFilter(focus_watcher)
-        setattr(text_box, "focus_watcher", focus_watcher)
+        
+        icon_focus_watcher = _IconFocusWatcher(text_box, update_icon)
+        text_box.installEventFilter(icon_focus_watcher)
+        setattr(text_box, "_icon_focus_watcher", icon_focus_watcher)
         update_icon()
     return text_box
 
@@ -470,9 +484,10 @@ def create_combo_box(
     dropdown_background_color = "#1e1e1e",
     dropdown_selection_background_color = "#0078d7",
     dropdown_border_width = 1,
-    dropdown_border_color = "#5c5c5c"
+    dropdown_border_color = "#5c5c5c",
+    parent = None
 ):
-    combo_box = QComboBox()
+    combo_box = QComboBox(parent)
     combo_box.setPlaceholderText(f"{placeholder_text}")
     combo_box.addItems(items)
     combo_box.setCurrentIndex(-1)
@@ -551,9 +566,10 @@ def create_checkbox(
     disabled_font_color = "#888888",
     disabled_background_color = "#2d2d2d",
     disabled_border_width = 1,
-    disabled_border_color = "#4a4a4a"
+    disabled_border_color = "#4a4a4a",
+    parent = None
 ):
-    check_box = QCheckBox(text)
+    check_box = QCheckBox(text, parent)
     padding_left_value = padding_left if padding_left is not None else padding
     padding_top_value = padding_top if padding_top is not None else padding
     padding_right_value = padding_right if padding_right is not None else padding
@@ -644,9 +660,10 @@ def create_information_message_box(
     button_disabled_font_color = "#888888",
     button_disabled_background_color = "#2d2d2d",
     button_disabled_border_width = 2,
-    button_disabled_border_color = "#4a4a4a"
+    button_disabled_border_color = "#4a4a4a",
+    parent = None
 ):
-    message_box = QDialog()
+    message_box = QDialog(parent)
     message_box.setObjectName("message_box")
     message_box.setWindowFlags(Qt.WindowType.FramelessWindowHint)
     message_box.setFixedWidth(360)
@@ -675,10 +692,10 @@ def create_information_message_box(
         padding_bottom = label_padding_bottom,
         border_width = label_border_width,
         border_color = label_border_color,
-        border_radius = label_border_radius
+        border_radius = label_border_radius,
+        alignment = Qt.AlignmentFlag.AlignCenter
     )
     main_layout.addWidget(text_label)
-    text_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
     text_label.setWordWrap(True)
     accept_button = create_button(
         text = button_text,
@@ -753,9 +770,10 @@ def create_confirmation_message_box(
     button_disabled_font_color = "#888888",
     button_disabled_background_color = "#2d2d2d",
     button_disabled_border_width = 2,
-    button_disabled_border_color = "#4a4a4a"
+    button_disabled_border_color = "#4a4a4a",
+    parent = None
 ):
-    confirm_message_box = QDialog()
+    confirm_message_box = QDialog(parent)
     confirm_message_box.setObjectName("confirm_message_box")
     confirm_message_box.setWindowFlags(Qt.WindowType.FramelessWindowHint)
     confirm_message_box.setFixedWidth(360)
@@ -784,10 +802,10 @@ def create_confirmation_message_box(
         padding_bottom = label_padding_bottom,
         border_width = label_border_width,
         border_color = label_border_color,
-        border_radius = label_border_radius
+        border_radius = label_border_radius,
+        alignment = Qt.AlignmentFlag.AlignCenter
     )
     main_layout.addWidget(text_label)
-    text_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
     text_label.setWordWrap(True)
     buttons_layout = QHBoxLayout()
     main_layout.addLayout(buttons_layout)
@@ -882,9 +900,10 @@ def create_list_table(
     hover_scrollbar_handle_border_color = "#777777",
     pressed_scrollbar_handle_background_color = "#4a4a4a",
     pressed_scrollbar_handle_border_width = 3,
-    pressed_scrollbar_handle_border_color = "#0078d7"
+    pressed_scrollbar_handle_border_color = "#0078d7",
+    parent = None
 ):
-    list_table = QTableWidget()
+    list_table = QTableWidget(parent)
     list_table.verticalHeader().setVisible(False)
     list_table.setColumnCount(len(column_headers))
     list_table.setHorizontalHeaderLabels(column_headers)

{gui_utilities-1.3.30 → gui_utilities-1.3.42}/gui_utilities.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gui_utilities
-Version: 1.3.30
+Version: 1.3.42
 Summary: Librería de utilidades gráficas en PyQt6
 Author-email: Guido Iván Gross <grossguidoivan@gmail.com>
 Requires-Python: >=3.8

{gui_utilities-1.3.30 → gui_utilities-1.3.42}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gui_utilities"
-version = "1.3.30"
+version = "1.3.42"
 description = "Librería de utilidades gráficas en PyQt6"
 authors = [{name = "Guido Iván Gross", email = "grossguidoivan@gmail.com"}]
 requires-python = ">=3.8"