microeye 2.3.2__py3-none-any.whl

microEye/qt.py

@@ -0,0 +1,181 @@
+import os
+
+
+def check_modules(modules: list[str]) -> dict[str, bool]:
+    availability = {}
+    for module in modules:
+        try:
+            __import__(module)
+            availability[module] = True
+        except ImportError:
+            availability[module] = False
+    return availability
+
+availability = check_modules(['PySide6', 'PyQt6', 'PyQt5'])
+
+all_false = all(not value for value in availability.values())
+
+if all_false:
+    raise ImportError('Missing Qt packages, install one of PySide6, PyQt5, PyQt6.')
+
+QT_API = os.environ.get('QT_API', 'PySide6')
+
+if not availability.get(QT_API, False):
+    for key, value in availability.items():
+        if value:
+            QT_API = key
+            break
+
+
+os.environ['QT_API'] = QT_API
+os.environ['PYQTGRAPH_QT_LIB'] = QT_API
+
+if QT_API == 'PySide6':
+    from PySide6 import QtCore, QtGui, QtSerialPort, QtSvg, QtWidgets
+    from PySide6.QtCore import QDateTime, Qt, Signal, Slot
+    from PySide6.QtGui import QAction, QIcon
+    from PySide6.QtWidgets import (
+        QApplication,
+        QFileSystemModel,
+        QMainWindow,
+        QVBoxLayout,
+    )
+elif QT_API == 'PyQt5':
+    from PyQt5 import Qsci, QtCore, QtGui, QtSerialPort, QtSvg, QtWidgets
+    from PyQt5.QtCore import QDateTime, Qt
+    from PyQt5.QtCore import pyqtSignal as Signal
+    from PyQt5.QtCore import pyqtSlot as Slot
+    from PyQt5.QtGui import QIcon
+    from PyQt5.QtWidgets import QAction, QApplication, QFileSystemModel, QMainWindow
+elif QT_API == 'PyQt6':
+    from PyQt6 import Qsci, QtCore, QtGui, QtSerialPort, QtSvg, QtWidgets
+    from PyQt6.QtCore import QDateTime, Qt
+    from PyQt6.QtCore import pyqtSignal as Signal
+    from PyQt6.QtCore import pyqtSlot as Slot
+    from PyQt6.QtGui import QAction, QFileSystemModel, QIcon
+    from PyQt6.QtWidgets import QApplication, QMainWindow
+else:
+    raise ImportError('QT_API environment variable is not correctly set. \
+                      It should be one of PySide6, PyQt5, PyQt6.')
+
+
+def checkDialogOptions(options) -> QtWidgets.QFileDialog.Option:
+    if options is None or not isinstance(options, QtWidgets.QFileDialog.Option):
+        options = QtWidgets.QFileDialog.Option(0)
+    return options
+
+
+def getOpenFileName(
+    parent: QtWidgets.QWidget = None,
+    caption='Open File',
+    directory='',
+    filter='All Files (*)',
+    initial_filter='',
+    options: QtWidgets.QFileDialog.Option =None,
+):
+    options = checkDialogOptions(options)
+    if QT_API == 'PySide6':
+        return QtWidgets.QFileDialog.getOpenFileName(
+            parent,
+            caption,
+            dir=directory,
+            filter=filter,
+            selectedFilter=initial_filter,
+            options=options,
+        )
+    elif QT_API == 'PyQt6' or QT_API == 'PyQt5':
+        return QtWidgets.QFileDialog.getOpenFileName(
+            parent,
+            caption,
+            directory=directory,
+            filter=filter,
+            initialFilter=initial_filter,
+            options=options,
+        )
+
+
+def getOpenFileNames(
+    parent: QtWidgets.QWidget = None,
+    caption='Save File',
+    directory='',
+    filter='All Files (*)',
+    initial_filter='',
+    options: QtWidgets.QFileDialog.Option =None,
+):
+    options = checkDialogOptions(options)
+    if QT_API == 'PySide6':
+        return QtWidgets.QFileDialog.getOpenFileNames(
+            parent,
+            caption,
+            dir=directory,
+            filter=filter,
+            selectedFilter=initial_filter,
+            options=options,
+        )
+    elif QT_API == 'PyQt6' or QT_API == 'PyQt5':
+        return QtWidgets.QFileDialog.getOpenFileNames(
+            parent,
+            caption,
+            directory=directory,
+            filter=filter,
+            initialFilter=initial_filter,
+            options=options,
+        )
+
+
+def getSaveFileName(
+    parent: QtWidgets.QWidget = None,
+    caption='Save File',
+    directory='',
+    filter='All Files (*)',
+    initial_filter='',
+    options: QtWidgets.QFileDialog.Option =None,
+):
+    options = checkDialogOptions(options)
+    if QT_API == 'PySide6':
+        return QtWidgets.QFileDialog.getSaveFileName(
+            parent,
+            caption,
+            dir=directory,
+            filter=filter,
+            selectedFilter=initial_filter,
+            options=options,
+        )
+    elif QT_API == 'PyQt6' or QT_API == 'PyQt5':
+        return QtWidgets.QFileDialog.getSaveFileName(
+            parent,
+            caption,
+            directory=directory,
+            filter=filter,
+            initialFilter=initial_filter,
+            options=options,
+        )
+
+
+def getExistingDirectory(
+    parent: QtWidgets.QWidget = None,
+    caption='Save File',
+    directory='',
+    filter='All Files (*)',
+    initial_filter='',
+    options: QtWidgets.QFileDialog.Option =None,
+):
+    options = checkDialogOptions(options)
+    if QT_API == 'PySide6':
+        return QtWidgets.QFileDialog.getExistingDirectory(
+            parent,
+            caption,
+            dir=directory,
+            filter=filter,
+            selectedFilter=initial_filter,
+            options=options,
+        )
+    elif QT_API == 'PyQt6' or QT_API == 'PyQt5':
+        return QtWidgets.QFileDialog.getExistingDirectory(
+            parent,
+            caption,
+            directory=directory,
+            filter=filter,
+            initialFilter=initial_filter,
+            options=options,
+        )

microEye/utils/__init__.py

@@ -0,0 +1,2 @@
+from microEye.utils.parameter_tree import Tree
+from microEye.utils.start_gui import StartGUI

microEye/utils/enum_encoder.py

@@ -0,0 +1,10 @@
+import json
+from enum import Enum
+
+
+# Custom encoder for JSON serialization
+class EnumEncoder(json.JSONEncoder):
+    def default(self, obj):
+        if isinstance(obj, Enum):
+            return str(obj)
+        return super().default(obj)

microEye/utils/expandable_groupbox.py

@@ -0,0 +1,93 @@
+from microEye.qt import QApplication, QtWidgets
+
+
+class ExpandableGroupBox(QtWidgets.QGroupBox):
+    """
+    Custom QGroupBox with expandable functionality.
+
+    Parameters
+    ----------
+    title : str
+        The title of the group box.
+    parent : QWidget, optional
+        The parent widget.
+
+    Attributes
+    ----------
+    None
+
+    Signals
+    -------
+    toggled : bool
+        Emitted when the group box is toggled (expanded or collapsed).
+
+    Methods
+    -------
+    init_ui()
+        Initialize the user interface.
+    mouseDoubleClickEvent(event)
+        Handle the mouse press event to toggle the expansion state.
+    setFlat(flat)
+        Override the setFlat method to adjust the visibility of child widgets.
+
+    Example
+    -------
+    >>> app = QApplication([])
+    >>> main_widget = QWidget()
+    >>> main_layout = QVBoxLayout(main_widget)
+    >>> expandable_group = ExpandableGroupBox('Expandable Group')
+    >>> button1 = QPushButton('Button 1')
+    >>> button2 = QPushButton('Button 2')
+    >>> expandable_group.layout().addWidget(button1)
+    >>> expandable_group.layout().addWidget(button2)
+    >>> main_layout.addWidget(expandable_group)
+    >>> main_widget.show()
+    >>> app.exec()
+    """
+
+    def __init__(self, title: str, parent=None):
+        '''
+        Parameters
+        ----------
+        title : str
+            The title of the group box.
+        parent : QWidget, optional
+            The parent widget.
+        '''
+        super().__init__(title, parent)
+        self.init_ui()
+
+    def init_ui(self):
+        '''Initialize the user interface.'''
+        group_layout = QtWidgets.QVBoxLayout()
+        self.setLayout(group_layout)
+        self.expanded = True
+
+    def mouseDoubleClickEvent(self, event):
+        '''Handle the mouse press event to toggle the expansion state.'''
+        self.expanded = not self.expanded
+        self.setFlat(not self.expanded)
+        # Hide or show child widgets based on the expansion state
+        for i in range(self.layout().count()):
+            item = self.layout().itemAt(i)
+            if item.widget():
+                item.widget().setVisible(self.expanded)
+                # Set the minimum height dynamically based on the expansion state
+                if self.expanded:
+                    item.widget().setMinimumHeight(125)
+                else:
+                    item.widget().setMinimumHeight(0)
+
+
+if __name__ == '__main__':
+    app = QApplication([])
+    main_widget = QtWidgets.QWidget()
+    main_layout = QtWidgets.QVBoxLayout(main_widget)
+    expandable_group = ExpandableGroupBox('Expandable Group')
+    button1 = QtWidgets.QPushButton('Button 1')
+    button2 = QtWidgets.QPushButton('Button 2')
+    expandable_group.layout().addWidget(button1)
+    expandable_group.layout().addWidget(button2)
+    main_layout.addWidget(expandable_group)
+    main_widget.show()
+    app.exec()