gui-utilities 1.3.27__py3-none-any.whl → 1.3.44__py3-none-any.whl

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,10 @@ 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
+    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,30 +404,6 @@ 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 = QLabel(text_box)
-        placeholder_label.setTextFormat(Qt.TextFormat.RichText)
-        placeholder_label.setText(f"<span style = \"color: {font_color}; font-family: {font_family}; font-size: {font_size}px;\">{html_placeholder}</span>")
-        placeholder_label.setAttribute(Qt.WidgetAttribute.WA_TransparentForMouseEvents)
-        placeholder_label.move(padding_left_value + 2, padding_top_value + 2)
-        placeholder_label.show()
-
-        def update_placeholder_visibility():
-            placeholder_label.setVisible(text_box.text() == "")
-        
-        text_box.textChanged.connect(update_placeholder_visibility)
-        update_placeholder_visibility()
     if hide_text:
         show_text_icon = QIcon(show_text_icon_url)
         hide_text_icon = QIcon(hide_text_icon_url)
@@ -403,38 +417,83 @@ 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)
+        
+        icon_focus_watcher = _IconFocusWatcher(text_box, update_icon)
+        text_box.installEventFilter(icon_focus_watcher)
+        setattr(text_box, "_icon_focus_watcher", icon_focus_watcher)
+    
+    placeholder_label = create_label(
+        text = placeholder_text,
+        font_family = font_family,
+        font_size = font_size,
+        font_color = placeholder_font_color,
+        font_weight = font_weight,
+        padding = padding,
+        padding_left = padding_left,
+        padding_top = padding_top,
+        padding_right = padding_right,
+        padding_bottom = padding_bottom,
+        math_expression = math_expression,
+        transparent_for_mouse = True,
+        parent = text_box
+    )
+    placeholder_label.move(0, 2)
+    
+    def update_placeholder_visibility():
+        has_text = bool(text_box.text().strip())
+        has_focus = text_box.hasFocus()
+        placeholder_label.setVisible(not has_text and not has_focus)
+        if hide_text: update_icon()
+    
+    class _PlaceholderFocusWatcher(QObject):
 
-        focus_watcher = FocusWatcher(text_box)
-        text_box.installEventFilter(focus_watcher)
-        setattr(text_box, "focus_watcher", focus_watcher)
-        update_icon()
+        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 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)
+    
+    placeholder_focus_watcher = _PlaceholderFocusWatcher(text_box, update_placeholder_visibility)
+    text_box.installEventFilter(placeholder_focus_watcher)
+    setattr(text_box, "_placeholder_focus_watcher", placeholder_focus_watcher)
+    update_placeholder_visibility()
     return text_box
 
 def create_combo_box(
@@ -464,9 +523,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)
@@ -545,9 +605,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
@@ -638,9 +699,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)
@@ -669,10 +731,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,
@@ -747,9 +809,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)
@@ -778,10 +841,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)
@@ -876,9 +939,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.27.dist-info → gui_utilities-1.3.44.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gui_utilities
-Version: 1.3.27
+Version: 1.3.44
 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.27.dist-info → gui_utilities-1.3.44.dist-info}/RECORD

@@ -1,11 +1,11 @@
-gui_utilities/gui_utilities.py,sha256=dy0LllUZ5mC09HdhMfTzvj1kzNBeztyJPNNUsu_6H0c,46185
+gui_utilities/gui_utilities.py,sha256=ijyqaux_QlVJdi80H2B9xLyRjs_mOH9Pcxea1ulEQKs,48674
 gui_utilities/icons/focused_hide_text_icon.png,sha256=0Ysx7vC-mEVfuSBWx1Zw-UhpqvrTCcIvnQ926wFmuK4,13084
 gui_utilities/icons/focused_show_text_icon.png,sha256=gmZU7RR4FN-9VSzpD00ZkQ8UGbihO2y808Kh3b_TaEg,6739
 gui_utilities/icons/hide_text_icon.png,sha256=f5jq6KaAygWNjzP_Ah6dw6eu8q5ml3m56JTeNSTSgEU,7207
 gui_utilities/icons/show_text_icon.png,sha256=8Vdp2XickPEM-eTb1-qBXf3qmHldSzllMZZfObir9p8,5376
 gui_utilities/tlds/tlds_list.txt,sha256=wIWmAQGVNsY0ZJy7qPW8kItDTCE4PTq8wcUhC2hpjkw,10916
-gui_utilities-1.3.27.dist-info/licenses/LICENSE,sha256=NNoMFs43kWl1J-aqq7_EsPlBjL5XTccWjZlwrlCR-Xc,1093
-gui_utilities-1.3.27.dist-info/METADATA,sha256=168zHVeB2toYacokpwO1kmBFZalHF3vxp5CQtGdmNIo,266
-gui_utilities-1.3.27.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-gui_utilities-1.3.27.dist-info/top_level.txt,sha256=c4C84nMT41keiX9b1AJJZDBU3kA38c7vOmP9kDie8Lk,14
-gui_utilities-1.3.27.dist-info/RECORD,,
+gui_utilities-1.3.44.dist-info/licenses/LICENSE,sha256=NNoMFs43kWl1J-aqq7_EsPlBjL5XTccWjZlwrlCR-Xc,1093
+gui_utilities-1.3.44.dist-info/METADATA,sha256=SbDw7yIbotPVveUWeugigOLO5Rbj-703ZDaEUGSVox0,266
+gui_utilities-1.3.44.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gui_utilities-1.3.44.dist-info/top_level.txt,sha256=c4C84nMT41keiX9b1AJJZDBU3kA38c7vOmP9kDie8Lk,14
+gui_utilities-1.3.44.dist-info/RECORD,,