michis-python-sammlung 0.0.5__tar.gz → 0.8__tar.gz

{michis_python_sammlung-0.0.5 → michis_python_sammlung-0.8}/PKG-INFO

@@ -1,13 +1,16 @@
 Metadata-Version: 2.4
 Name: michis_python_sammlung
-Version: 0.0.5
-Summary: Collection of mostly QT related stuff
+Version: 0.8
+Summary: Personal collection of mostly QT related stuff
+Author: Michael Mischko
+License-Expression: MIT
 Project-URL: Homepage, https://github.com/mischkomichael/Michis_python_sammlung
+Project-URL: Repository, https://github.com/mischkomichael/Michis_python_sammlung
 Project-URL: Issues, https://github.com/mischkomichael/Michis_python_sammlung/issues
-Author-email: Michael Mischko <mischkom@web.de>
-License-Expression: MIT
-License-File: LICENSE
-Classifier: Operating System :: OS Independent
+Keywords: pyqt6,widgets,gui
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
-Requires-Dist: pyqt6>=6.6
+Description-Content-Type: text/markdown
+Requires-Dist: PyQt6<7,>=6.11

{michis_python_sammlung-0.0.5 → michis_python_sammlung-0.8}/pyproject.toml

@@ -1,32 +1,35 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.build]
-include = [
-  "src/michis_python_sammlung/**"
-]
-
-[project]
-name = "michis_python_sammlung"
-version = "0.0.5"
-authors = [
-  { name="Michael Mischko", email="mischkom@web.de" },
-]
-description = "Collection of mostly QT related stuff"
-readme = "README.md"
-requires-python = ">=3.10"
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "Operating System :: OS Independent",
-]
-license = "MIT"
-license-files = ["LICEN[CS]E*"]
-
-dependencies = [
-  "PyQt6>=6.6"
-]
-
-[project.urls]
-Homepage = "https://github.com/mischkomichael/Michis_python_sammlung"
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "michis_python_sammlung"
+version = "0.8"
+description = "Personal collection of mostly QT related stuff"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Michael Mischko" }
+]
+requires-python = ">=3.10"
+
+dependencies = [
+    "PyQt6>=6.11,<7",
+]
+
+keywords = [
+    "pyqt6",
+    "widgets",
+    "gui",
+]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/mischkomichael/Michis_python_sammlung"
+Repository = "https://github.com/mischkomichael/Michis_python_sammlung"
 Issues = "https://github.com/mischkomichael/Michis_python_sammlung/issues"

michis_python_sammlung-0.8/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

{michis_python_sammlung-0.0.5 → michis_python_sammlung-0.8}/src/michis_python_sammlung/pyqt/clickable_label.py

@@ -1,210 +1,210 @@
-from __future__ import annotations
-
-from PyQt6.QtCore import Qt, QSize, pyqtSignal, Qt, QPoint, QTimer, QRect
-from PyQt6.QtWidgets import QLabel, QApplication, QWidget, QVBoxLayout, QHBoxLayout, QLayout, QSizePolicy, QStackedLayout
-from PyQt6.QtGui import QPixmap, QResizeEvent, QColorConstants, QPainter, QRegion, QCursor, QMouseEvent, QColor, QBitmap, QTransform
-
-from numbers import Number
-from typing import Callable
-
-from PyQt6.QtGui import QImage
-from ..pyqt.image_paths import Image_paths
-
-def create_alpha_mask(image: QImage | QPixmap) -> QBitmap:
-    # Ensure the image has an alpha channel
-    if isinstance(image, QPixmap):
-        image = image.toImage()
-    image_with_alpha = image.convertToFormat(QImage.Format.Format_ARGB32)
-    mask_image = image_with_alpha.createAlphaMask()
-    return QBitmap.fromImage(mask_image)
-
-class Clickable_label(QLabel):
-
-    sg_clicked = pyqtSignal(QMouseEvent)
-
-    def __init__(
-        self,
-        pixmap: str | QPixmap,
-        pixmap_hover: str | QPixmap,
-        on_click_action: Callable = lambda: ...,
-        cursor: QPixmap | Qt.CursorShape = Qt.CursorShape.ArrowCursor,
-        scaled: float = None,
-        heuristic_mask: bool = True,
-        parent: QWidget = None
-    ):
-        super().__init__(parent)
-        self.setAlignment(Qt.AlignmentFlag.AlignCenter)
-        self._scaled = scaled
-        self.configure_pixmaps(pixmap, pixmap_hover, scaled=scaled)
-        self._hovering = False
-        #somehow, the sizes are too small for the mask to not clip from the top and bottom ... 
-        self.setMinimumSize(self._pixmap_hover.size())
-        cursor = QCursor(cursor) if isinstance(cursor, QPixmap) else cursor
-        self.setCursor(cursor)
-        self._on_click_action: Callable = on_click_action
-        self._heuristic_mask = heuristic_mask
-        self._mask_initialized = True
-        # ### lazy mask evaluation to make sure Clickable_labels can be instantiated even without properly initialized paintDevice
-        #self.set_mask(heuristic_mask=heuristic_mask)
-        self.setAttribute(Qt.WidgetAttribute.WA_TranslucentBackground, True)
-        self.setAutoFillBackground(False)
-
-    def sizeHint(self):
-        return self._pixmap_hover.size()
-
-    def showEvent(self, a0):
-        if not self._mask_initialized:
-            QTimer.singleShot(0, lambda: self._lazy_mask_init(self._heuristic_mask))
-        return super().showEvent(a0)
-    
-    def _lazy_mask_init(self, heuristic_mask: bool) -> None:
-        self.set_mask(heuristic_mask=heuristic_mask)
-        self._mask_initialized
-
-    def replace_widget(
-        self,
-        widget_to_replace: QWidget,
-        delete_old: bool = True
-    ) -> Clickable_label | tuple[Clickable_label]:
-        """
-        Replace an existing QWidget with self. Return self if delete_old is True or a tuple (self, replaced_widget) if not.
-        """
-        layouts_to_search: list[QLayout] = widget_to_replace.parent().findChildren(QVBoxLayout) + widget_to_replace.parent().findChildren(QHBoxLayout)
-        found_layout: None | QHBoxLayout | QVBoxLayout = None
-        for layout in layouts_to_search:
-            for index in range(layout.count()):
-                if widget_to_replace is layout.itemAt(index).widget():
-                    found_layout = layout
-                    break
-        if found_layout is None:
-            raise Exception("clickable_label.replace_widget_in_layout: widget has no layout !")
-        else:
-            found_layout.replaceWidget(widget_to_replace, self)
-            if delete_old:
-                widget_to_replace.deleteLater()
-                return self
-            else:
-                return (self, widget_to_replace)
-    
-    def resizeEvent(self, a0: QResizeEvent):
-        super().resizeEvent(a0)
-        self.set_mask(a0.size(), self._heuristic_mask)
-
-    def enterEvent(self, event):
-        self._hovering = True
-        self.setPixmap(self._pixmap_hover)
-        super().enterEvent(event)
-
-    def leaveEvent(self, a0):
-        self._hovering = False
-        self.setPixmap(self._pixmap)
-        super().leaveEvent(a0)
-
-    def mouseReleaseEvent(self, ev):
-        self._on_click_action()
-        self.sg_clicked.emit(ev)
-        return super().mouseReleaseEvent(ev)
-
-    def set_mask(self, new_size: QSize | None = None, heuristic_mask: bool=True) -> None:
-        new_size = new_size if new_size is not None else self._pixmap_hover.size()
-        empty_mask = QPixmap(new_size)
-        empty_mask.fill(QColorConstants.Transparent)
-        painter = QPainter(empty_mask)
-        center_anker_x = (new_size.width()-self._pixmap_hover.size().width())//2
-        center_anker_y = (new_size.height()-self._pixmap_hover.size().height())//2
-        painter.drawPixmap(center_anker_x, center_anker_y, self._pixmap_hover)
-        painter.end()
-        if not heuristic_mask:
-            self._mask = create_alpha_mask(empty_mask)
-        else:
-            self._mask = empty_mask.createHeuristicMask(clipTight=False)
-        self.setMask(self._mask)
-        # self.setMask(empty_mask.createMaskFromColor(QColorConstants.Transparent, Qt.MaskMode.MaskInColor))
-
-    def replace_on_click_action(self, new_action: Callable) -> None:
-        if not isinstance(new_action, Callable):
-            raise ValueError(f"utility.custom_widgets.clickable_label.Cliclable_label.replace_on_click_action:\
-                             Action must be of type 'Callable', is {type(new_action)} instead.")
-        self._on_click_action = new_action
-
-    def configure_pixmaps(self,
-        pixmap: str | QPixmap,
-        pixmap_hover: str | QPixmap,
-        scaled: float = None
-    ) -> None:
-        self._pixmap = QPixmap(pixmap) if isinstance(pixmap,str) else pixmap
-        self._pixmap_hover = QPixmap(pixmap_hover) if isinstance(pixmap_hover,str) else pixmap_hover
-        if self._pixmap.isNull() or self._pixmap_hover.isNull():
-            raise ValueError(f"Failed instantiating pixmap from path: {pixmap} / {pixmap_hover}")
-        if isinstance(scaled, Number):
-            self._scaled = scaled
-            self._pixmap = self._pixmap.scaled(self._pixmap.size()*self._scaled,transformMode=Qt.TransformationMode.SmoothTransformation)
-            self._pixmap_hover = self._pixmap_hover.scaled(self._pixmap_hover.size()*self._scaled,transformMode=Qt.TransformationMode.SmoothTransformation)
-        elif scaled is None:
-            self.setScaledContents(False)
-        self.setPixmap(self._pixmap)
-
-    def scale_pixmap(self, scaled: Number) -> None:
-        self._scaled = scaled
-        self._pixmap = self._pixmap.scaled(self.size()*self._scaled,transformMode=Qt.TransformationMode.SmoothTransformation)
-        self._pixmap_hover = self._pixmap_hover.scaled(self.size()*self._scaled,transformMode=Qt.TransformationMode.SmoothTransformation)
-
-    def reset(self) -> None:
-        self.setPixmap(self._pixmap)
-        self._hovering = False
-
-class Togglable_clickable_label(QWidget):
-
-    def __init__(
-        self,
-        untoggled_label: Clickable_label,
-        toggled_label: Clickable_label,
-        toggle_on_click: bool = True,
-        parent=None,
-        allow_expansion=True
-    ):
-        super().__init__(parent=parent)
-        if not (isinstance(untoggled_label, Clickable_label) or isinstance(toggled_label, Clickable_label)):
-            raise ValueError(f"label_1 and label_2 need to be of type Clickable_label not {type(untoggled_label), type(toggled_label)}")
-        self.untoggled_label = untoggled_label
-        self.toggled_label = toggled_label
-        size_1 = self.untoggled_label._pixmap_hover
-        size_2 = self.toggled_label._pixmap_hover
-        if allow_expansion:
-            self.setMinimumSize(QSize(size_1.width() if size_1.width() > size_2.width() else size_2.width(),
-                                    size_1.height() if size_1.height() > size_2.height() else size_2.height()))
-        else:
-            self.setFixedSize(QSize(size_1.width() if size_1.width() > size_2.width() else size_2.width(),
-                                                size_1.height() if size_1.height() > size_2.height() else size_2.height()))            
-        self._layout = QVBoxLayout(self)
-        self._layout.setContentsMargins(0,0,0,0)
-        self._layout.addWidget(untoggled_label)
-        self._layout.addWidget(toggled_label)
-        self.toggled = False
-        self.toggle(toggle=self.toggled)
-        if toggle_on_click:
-            print("TOGGLING")
-            self.untoggled_label.sg_clicked.connect(self.toggle)
-            self.toggled_label.sg_clicked.connect(self.toggle)
-
-    def toggle(self, mouse_event: QMouseEvent=None, toggle=None) -> None:
-        self.toggled = not self.toggled if toggle is None else toggle
-        if self.toggled:
-            self.untoggled_label.setVisible(False)
-            self.toggled_label.setVisible(True)
-        else:
-            self.toggled_label.setVisible(False)
-            self.untoggled_label.setVisible(True)
-
-    def replace_on_click_actions(self, action_1: Callable, action_2: Callable) -> None:
-        self.untoggled_label.replace_on_click_action(action_1)
-        self.toggled_label.replace_on_click_action(action_2)
-        
-def main():
-    import sys
-    app = QApplication(sys.argv)
-    label = Clickable_label(Image_paths.cogwheel, Image_paths.cogwheel_hover, heuristic_mask=False)
-    label.show()
-    sys.exit(app.exec())
-if __name__ == "__main__":
+from __future__ import annotations
+
+from PyQt6.QtCore import Qt, QSize, pyqtSignal, Qt, QPoint, QTimer, QRect
+from PyQt6.QtWidgets import QLabel, QApplication, QWidget, QVBoxLayout, QHBoxLayout, QLayout, QSizePolicy, QStackedLayout
+from PyQt6.QtGui import QPixmap, QResizeEvent, QColorConstants, QPainter, QRegion, QCursor, QMouseEvent, QColor, QBitmap, QTransform
+
+from numbers import Number
+from typing import Callable
+
+from PyQt6.QtGui import QImage
+from ..pyqt.image_paths import Image_paths
+
+def create_alpha_mask(image: QImage | QPixmap) -> QBitmap:
+    # Ensure the image has an alpha channel
+    if isinstance(image, QPixmap):
+        image = image.toImage()
+    image_with_alpha = image.convertToFormat(QImage.Format.Format_ARGB32)
+    mask_image = image_with_alpha.createAlphaMask()
+    return QBitmap.fromImage(mask_image)
+
+class Clickable_label(QLabel):
+
+    sg_clicked = pyqtSignal(QMouseEvent)
+
+    def __init__(
+        self,
+        pixmap: str | QPixmap,
+        pixmap_hover: str | QPixmap,
+        on_click_action: Callable = lambda: ...,
+        cursor: QPixmap | Qt.CursorShape = Qt.CursorShape.ArrowCursor,
+        scaled: float = None,
+        heuristic_mask: bool = True,
+        parent: QWidget = None
+    ):
+        super().__init__(parent)
+        self.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        self._scaled = scaled
+        self.configure_pixmaps(pixmap, pixmap_hover, scaled=scaled)
+        self._hovering = False
+        #somehow, the sizes are too small for the mask to not clip from the top and bottom ... 
+        self.setMinimumSize(self._pixmap_hover.size())
+        cursor = QCursor(cursor) if isinstance(cursor, QPixmap) else cursor
+        self.setCursor(cursor)
+        self._on_click_action: Callable = on_click_action
+        self._heuristic_mask = heuristic_mask
+        self._mask_initialized = True
+        # ### lazy mask evaluation to make sure Clickable_labels can be instantiated even without properly initialized paintDevice
+        #self.set_mask(heuristic_mask=heuristic_mask)
+        self.setAttribute(Qt.WidgetAttribute.WA_TranslucentBackground, True)
+        self.setAutoFillBackground(False)
+
+    def sizeHint(self):
+        return self._pixmap_hover.size()
+
+    def showEvent(self, a0):
+        if not self._mask_initialized:
+            QTimer.singleShot(0, lambda: self._lazy_mask_init(self._heuristic_mask))
+        return super().showEvent(a0)
+    
+    def _lazy_mask_init(self, heuristic_mask: bool) -> None:
+        self.set_mask(heuristic_mask=heuristic_mask)
+        self._mask_initialized
+
+    def replace_widget(
+        self,
+        widget_to_replace: QWidget,
+        delete_old: bool = True
+    ) -> Clickable_label | tuple[Clickable_label]:
+        """
+        Replace an existing QWidget with self. Return self if delete_old is True or a tuple (self, replaced_widget) if not.
+        """
+        layouts_to_search: list[QLayout] = widget_to_replace.parent().findChildren(QVBoxLayout) + widget_to_replace.parent().findChildren(QHBoxLayout)
+        found_layout: None | QHBoxLayout | QVBoxLayout = None
+        for layout in layouts_to_search:
+            for index in range(layout.count()):
+                if widget_to_replace is layout.itemAt(index).widget():
+                    found_layout = layout
+                    break
+        if found_layout is None:
+            raise Exception("clickable_label.replace_widget_in_layout: widget has no layout !")
+        else:
+            found_layout.replaceWidget(widget_to_replace, self)
+            if delete_old:
+                widget_to_replace.deleteLater()
+                return self
+            else:
+                return (self, widget_to_replace)
+    
+    def resizeEvent(self, a0: QResizeEvent):
+        super().resizeEvent(a0)
+        self.set_mask(a0.size(), self._heuristic_mask)
+
+    def enterEvent(self, event):
+        self._hovering = True
+        self.setPixmap(self._pixmap_hover)
+        super().enterEvent(event)
+
+    def leaveEvent(self, a0):
+        self._hovering = False
+        self.setPixmap(self._pixmap)
+        super().leaveEvent(a0)
+
+    def mouseReleaseEvent(self, ev):
+        self._on_click_action()
+        self.sg_clicked.emit(ev)
+        return super().mouseReleaseEvent(ev)
+
+    def set_mask(self, new_size: QSize | None = None, heuristic_mask: bool=True) -> None:
+        new_size = new_size if new_size is not None else self._pixmap_hover.size()
+        empty_mask = QPixmap(new_size)
+        empty_mask.fill(QColorConstants.Transparent)
+        painter = QPainter(empty_mask)
+        center_anker_x = (new_size.width()-self._pixmap_hover.size().width())//2
+        center_anker_y = (new_size.height()-self._pixmap_hover.size().height())//2
+        painter.drawPixmap(center_anker_x, center_anker_y, self._pixmap_hover)
+        painter.end()
+        if not heuristic_mask:
+            self._mask = create_alpha_mask(empty_mask)
+        else:
+            self._mask = empty_mask.createHeuristicMask(clipTight=False)
+        self.setMask(self._mask)
+        # self.setMask(empty_mask.createMaskFromColor(QColorConstants.Transparent, Qt.MaskMode.MaskInColor))
+
+    def replace_on_click_action(self, new_action: Callable) -> None:
+        if not isinstance(new_action, Callable):
+            raise ValueError(f"utility.custom_widgets.clickable_label.Cliclable_label.replace_on_click_action:\
+                             Action must be of type 'Callable', is {type(new_action)} instead.")
+        self._on_click_action = new_action
+
+    def configure_pixmaps(self,
+        pixmap: str | QPixmap,
+        pixmap_hover: str | QPixmap,
+        scaled: float = None
+    ) -> None:
+        self._pixmap = QPixmap(pixmap) if isinstance(pixmap,str) else pixmap
+        self._pixmap_hover = QPixmap(pixmap_hover) if isinstance(pixmap_hover,str) else pixmap_hover
+        if self._pixmap.isNull() or self._pixmap_hover.isNull():
+            raise ValueError(f"Failed instantiating pixmap from path: {pixmap} / {pixmap_hover}")
+        if isinstance(scaled, Number):
+            self._scaled = scaled
+            self._pixmap = self._pixmap.scaled(self._pixmap.size()*self._scaled,transformMode=Qt.TransformationMode.SmoothTransformation)
+            self._pixmap_hover = self._pixmap_hover.scaled(self._pixmap_hover.size()*self._scaled,transformMode=Qt.TransformationMode.SmoothTransformation)
+        elif scaled is None:
+            self.setScaledContents(False)
+        self.setPixmap(self._pixmap)
+
+    def scale_pixmap(self, scaled: Number) -> None:
+        self._scaled = scaled
+        self._pixmap = self._pixmap.scaled(self.size()*self._scaled,transformMode=Qt.TransformationMode.SmoothTransformation)
+        self._pixmap_hover = self._pixmap_hover.scaled(self.size()*self._scaled,transformMode=Qt.TransformationMode.SmoothTransformation)
+
+    def reset(self) -> None:
+        self.setPixmap(self._pixmap)
+        self._hovering = False
+
+class Togglable_clickable_label(QWidget):
+
+    def __init__(
+        self,
+        untoggled_label: Clickable_label,
+        toggled_label: Clickable_label,
+        toggle_on_click: bool = True,
+        parent=None,
+        allow_expansion=True
+    ):
+        super().__init__(parent=parent)
+        if not (isinstance(untoggled_label, Clickable_label) or isinstance(toggled_label, Clickable_label)):
+            raise ValueError(f"label_1 and label_2 need to be of type Clickable_label not {type(untoggled_label), type(toggled_label)}")
+        self.untoggled_label = untoggled_label
+        self.toggled_label = toggled_label
+        size_1 = self.untoggled_label._pixmap_hover
+        size_2 = self.toggled_label._pixmap_hover
+        if allow_expansion:
+            self.setMinimumSize(QSize(size_1.width() if size_1.width() > size_2.width() else size_2.width(),
+                                    size_1.height() if size_1.height() > size_2.height() else size_2.height()))
+        else:
+            self.setFixedSize(QSize(size_1.width() if size_1.width() > size_2.width() else size_2.width(),
+                                                size_1.height() if size_1.height() > size_2.height() else size_2.height()))            
+        self._layout = QVBoxLayout(self)
+        self._layout.setContentsMargins(0,0,0,0)
+        self._layout.addWidget(untoggled_label)
+        self._layout.addWidget(toggled_label)
+        self.toggled = False
+        self.toggle(toggle=self.toggled)
+        if toggle_on_click:
+            print("TOGGLING")
+            self.untoggled_label.sg_clicked.connect(self.toggle)
+            self.toggled_label.sg_clicked.connect(self.toggle)
+
+    def toggle(self, mouse_event: QMouseEvent=None, toggle=None) -> None:
+        self.toggled = not self.toggled if toggle is None else toggle
+        if self.toggled:
+            self.untoggled_label.setVisible(False)
+            self.toggled_label.setVisible(True)
+        else:
+            self.toggled_label.setVisible(False)
+            self.untoggled_label.setVisible(True)
+
+    def replace_on_click_actions(self, action_1: Callable, action_2: Callable) -> None:
+        self.untoggled_label.replace_on_click_action(action_1)
+        self.toggled_label.replace_on_click_action(action_2)
+        
+def main():
+    import sys
+    app = QApplication(sys.argv)
+    label = Clickable_label(Image_paths.cogwheel, Image_paths.cogwheel_hover, heuristic_mask=False)
+    label.show()
+    sys.exit(app.exec())
+if __name__ == "__main__":
     main()