pyqttoolkit 0.9.1__py3-none-any.whl

pyqttoolkit/views/dtype_edit.py

@@ -0,0 +1,117 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from math import isnan, isfinite
+
+from PyQt5.QtCore import pyqtSignal, Qt
+from PyQt5.QtGui import QDoubleValidator
+
+from pyqttoolkit.properties import AutoProperty
+from pyqttoolkit.views import LineEdit
+
+def _type_editor(dtype, default_value):
+    class _TypeEdit(LineEdit):
+        def __init__(self, parent):
+            LineEdit.__init__(self, parent)
+            self.setValidator(QDoubleValidator(self))
+            self.editComplete.connect(self._set_value)
+            self.valueChanged.connect(self._set_text)
+        
+        valueChanged = pyqtSignal(dtype)
+
+        value = AutoProperty(dtype)
+
+        def _set_value(self, text):
+            try:
+                self.value = dtype(text)
+            except (TypeError, ValueError):
+                self.value = default_value
+                self._set_text(self.value)
+        
+        def _set_text(self, value):
+            self.setText(str(value))
+    
+    return _TypeEdit
+
+FloatEdit = _type_editor(float, 0.0)
+IntEdit = _type_editor(int, 0)
+
+class InfFloatLineEdit(LineEdit):
+    def __init__(self, parent, formatter=None, update_on_enter_pressed=True):
+        LineEdit.__init__(self, parent)
+        self.editComplete.connect(self._handle_edit_complete)
+        self.valueChanged.connect(self._handle_value_changed)
+        self._formatter = formatter
+        self._update_on_enter_pressed = update_on_enter_pressed
+    
+    valueChanged = pyqtSignal(float)
+    value = AutoProperty(float)
+
+    def _handle_edit_complete(self):
+        try:
+            self.value = float(self.text())
+        except ValueError:
+            self.setText(self._get_text(self.value))
+    
+    def _handle_value_changed(self, value):
+        self.setText(self._get_text(value))
+
+    def _get_text(self, value):
+        if self._formatter is not None:
+            return self._formatter(value)
+        else:
+            return str(value)
+            
+    def keyPressEvent(self, event):
+        super().keyPressEvent(event)
+        if event.key() in [Qt.Key_Enter, Qt.Key_Return] and self._update_on_enter_pressed:
+            self.valueChanged.emit(self.value)
+
+
+class AutoFloatLineEdit(InfFloatLineEdit):
+    def __init__(self, parent, allow_inf=True, default_text=None, formatter=None, update_on_enter_pressed=True):
+        InfFloatLineEdit.__init__(self, parent, formatter, update_on_enter_pressed)
+        self._allow_inf = allow_inf
+        self._default_text_ = default_text or self.tr('Auto')
+
+    @property
+    def _default_text(self):
+        return self._default_text_
+    
+    def _handle_edit_complete(self):
+        if self.text().lower() == self._default_text.lower() or not self.text():
+            self._reset()
+        else:
+            if not self._allow_inf:
+                try:
+                    if not isfinite(float(self.text())):
+                        self._reset()
+                except ValueError:
+                    pass
+            InfFloatLineEdit._handle_edit_complete(self)
+    
+    def _reset(self):
+        self.value = float('nan')
+        self.setText(self._default_text)
+    
+    def _handle_value_changed(self, value):
+        if isnan(value):
+            self.setText(self._default_text)
+        else:
+            InfFloatLineEdit._handle_value_changed(self, value)
+
+    def setText(self, value):
+        InfFloatLineEdit.setText(self, self._default_text if value == 'nan' else value)

pyqttoolkit/views/editable_combo_box.py

@@ -0,0 +1,45 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+""":mod:`editable_combo_box`
+Defines the EditableComboBox class
+"""
+#pylint: disable=no-name-in-module
+from PyQt5.QtCore import QEvent
+from PyQt5.QtWidgets import QComboBox
+#pylint: enable=no-name-in-module
+
+class EditableComboBox(QComboBox):
+    """class::EditableComboBox
+    A combo box that is editable by default, and adds the current item if focus is lost
+    """
+    def __init__(self, parent):
+        QComboBox.__init__(self, parent)
+        self.setEditable(True)
+        self.installEventFilter(self)
+
+    def eventFilter(self, _obj, event):
+        """function::eventFilter(self, _obj, evet)
+        Override the QComboBox.eventFilter method to provide lost focus functionality
+        """
+        if event.type() == QEvent.FocusOut and self.currentText():
+            index = self.findText(self.currentText())
+            if index == -1:
+                self.addItem(self.currentText())
+                index = self.findText(self.currentText())
+                self.setCurrentIndex(index)
+            self.activated.emit(index)
+        return QComboBox.eventFilter(self, _obj, event)

pyqttoolkit/views/file_selector.py

@@ -0,0 +1,51 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from PyQt5.QtWidgets import QWidget, QLineEdit, QHBoxLayout
+from PyQt5.QtCore import pyqtSignal
+
+from pyqttoolkit.properties import auto_property
+
+from . import ShrunkPushButton
+
+class FileSelector(QWidget):
+    def __init__(self, parent, filter_, file_dialog_service):
+        QWidget.__init__(self, parent)
+        self._file_dialog_service = file_dialog_service
+        self._filter = filter_
+        self._line_edit = QLineEdit(self)
+        self._open_dialog = ShrunkPushButton('...', self)
+        self._layout = QHBoxLayout(self)
+        self._layout.setContentsMargins(0, 0, 0, 0)
+        self._layout.addWidget(self._line_edit)
+        self._layout.addWidget(self._open_dialog)
+        self._line_edit.textChanged.connect(self.textChanged)
+        self._open_dialog.clicked.connect(self._open_file_dialog)
+
+    textChanged = pyqtSignal(str)
+
+    @auto_property(str)
+    def text(self):
+        return self._line_edit.text()
+
+    @text.setter
+    def text(self, value):
+        self._line_edit.setText(value)
+
+    def _open_file_dialog(self):
+        file_name = self._file_dialog_service.get_open_filename(self, self._filter)
+        if file_name:
+            self.text = file_name

pyqttoolkit/views/icon.py

@@ -0,0 +1,67 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from PyQt5.QtWidgets import QHBoxLayout, QWidget
+from PyQt5.QtCore import QFile, QSize, Qt
+from PyQt5.QtSvg import QSvgWidget
+from PyQt5.QtXml import QDomDocument
+
+from pyqttoolkit.colors import format_color, ColorFormat
+from pyqttoolkit.services.theme_manager import ThemeManager
+from .styleable import make_styleable
+
+class Icon(QWidget):
+    def __init__(self, parent, icon, size=None, padding=None, color=None):
+        QWidget.__init__(self, parent)
+        padding = padding or 0
+        self._theme_manager = ThemeManager.get(self)
+        
+        self._color = format_color(color or self._theme_manager.get_color('button_foreground'), ColorFormat.rgb_string_256)
+
+        self._svgdoc = QDomDocument()
+        self._icon_widget = QSvgWidget(self)
+        self.loadIcon(icon)
+
+        if size:
+            self._icon_widget.setFixedSize(QSize(size.width() - 2 * padding, size.height() - 2 * padding))
+
+        self._layout = QHBoxLayout(self)
+        self._layout.setContentsMargins(padding, padding, padding, padding)
+        self._layout.addWidget(self._icon_widget, Qt.AlignCenter)
+    
+    def loadIcon(self, icon):
+        file = QFile(f'icons:{icon}', self)
+        try:
+            file.open(QFile.ReadOnly)
+            self._svgdoc.setContent(file.readAll())
+            self._svgdoc.documentElement().setAttribute('fill', self._color)
+            self._icon_widget.load(self._svgdoc.toByteArray())
+        finally:
+            file.close()
+
+    def setEnabled(self, enabled):
+        QWidget.setEnabled(self, enabled)
+        self._svgdoc.documentElement().setAttribute('fill', self._color)
+        self._svgdoc.documentElement().setAttribute('fill-opacity', '1' if self.isEnabled() else '0.4')
+        self._icon_widget.load(self._svgdoc.toByteArray())
+    
+    def setColor(self, color=None):
+        self._color = format_color(color or self._theme_manager.get_color('button_foreground'), ColorFormat.rgb_string_256) or self._color
+        self._svgdoc.documentElement().setAttribute('fill', self._color)
+        self._svgdoc.documentElement().setAttribute('fill-opacity', '1' if self.isEnabled() else '0.4')
+        self._icon_widget.load(self._svgdoc.toByteArray())
+
+Icon = make_styleable(Icon)

pyqttoolkit/views/icon_button.py

@@ -0,0 +1,129 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from PyQt5.QtCore import QPropertyAnimation, QEasingCurve, pyqtSignal, pyqtProperty
+from PyQt5.QtWidgets import QPushButton, QHBoxLayout, QSizePolicy
+
+from pyqttoolkit.properties import AutoProperty
+from pyqttoolkit.colors import format_color, ColorFormat
+from pyqttoolkit.services.theme_manager import ThemeManager
+from .icon import Icon
+
+class IconButton(QPushButton):
+    def __init__(self, icon, title, parent, size=None, padding=None, color=None, hover_color=None):
+        QPushButton.__init__(self, parent)
+        self._theme_manager = ThemeManager.get(self)
+        self._background_color = hover_color or self._theme_manager.get_color('button_background_hover')
+        self.setToolTip(title)
+        self._icon = Icon(self, icon, size, padding, color)
+        self._iconname = icon
+
+        self._layout = QHBoxLayout(self)
+        self._layout.addWidget(self._icon)
+        self._layout.setContentsMargins(0, 0, 0, 0)
+        self.setSizePolicy(QSizePolicy.Fixed, QSizePolicy.Fixed)
+        self._size = size
+        self.setFlat(True)
+        self._background_opacity = 0.0
+        self._background_opacity_stop = 0.0
+        self._update_style_sheet()
+        self._animation = QPropertyAnimation(self, b'backgroundOpacity', self)
+        self.clicked.connect(self._update_background_opacity_stop)
+    
+    def setColor(self, color=None):
+        self._icon.setColor(color)
+    
+    def setIcon(self, icon):
+        self._icon.loadIcon(icon)
+
+    @pyqtProperty(float)
+    def backgroundOpacity(self):
+        return self._background_opacity
+
+    @backgroundOpacity.setter
+    def backgroundOpacity(self, value):
+        self._background_opacity = value
+        self._update_style_sheet()
+    
+    def sizeHint(self):
+        return self._size or self._icon.sizeHint()
+
+    def enterEvent(self, event):
+        if self.isEnabled():
+            self._start_opacity_animation(350, 0, 1)
+        return QPushButton.enterEvent(self, event)
+    
+    def leaveEvent(self, event):
+        if self.isEnabled():
+            self._start_opacity_animation(350, 1, 0)
+        return QPushButton.leaveEvent(self, event)
+    
+    def mousePressEvent(self, event):
+        if self.isEnabled():
+            self._start_opacity_animation(50, 1, 0.6)
+        return QPushButton.mousePressEvent(self, event)
+    
+    def mouseReleaseEvent(self, event):
+        if self.isEnabled():
+            self._start_opacity_animation(50, self._background_opacity, 1)
+        return QPushButton.mouseReleaseEvent(self, event)
+
+    def _start_opacity_animation(self, duration, start, end):
+        self._animation.stop()
+        self._animation.setDuration(duration)
+        self._animation.setStartValue(start)
+        self._animation.setEndValue(end)
+        self._animation.setEasingCurve(QEasingCurve.BezierSpline)
+        self._animation.start()
+    
+    def setEnabled(self, value):
+        QPushButton.setEnabled(self, value)
+        self._icon.setEnabled(value)
+
+    def _update_background_opacity_stop(self):
+        self._background_opacity_stop = 0.0 if not self.isChecked() else 0.8
+        self._update_style_sheet()
+
+    def setChecked(self, value):
+        QPushButton.setChecked(self, value)
+        self._update_background_opacity_stop()
+
+    def _update_style_sheet(self):
+        stylesheet = """
+Icon {{
+    background-color: {color};
+    border-radius: 2px;
+}}
+QPushButton {{
+    background-color: transparent;
+    border: none;
+}}
+""".format(color=format_color(self._background_color, ColorFormat.rgba_string_256, max(self._background_opacity, self._background_opacity_stop)))
+        self.setStyleSheet(stylesheet)
+
+
+class BindableIconButton(IconButton):
+    def __init__(self, icon, title, parent, size=None, padding=None, color=None, hover_color=None):
+        IconButton.__init__(self, icon, title, parent, size, padding, color, hover_color)
+        self.setCheckable(True)
+        self.clicked.connect(self._handle_clicked)
+        self.checkedChanged.connect(self.setChecked)
+    
+    checkedChanged = pyqtSignal(bool)
+    checked = AutoProperty(bool)
+
+    def _handle_clicked(self):
+        self.checked = self.isChecked()

pyqttoolkit/views/json_edit.py

@@ -0,0 +1,21 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from .code import CodeEdit
+
+class JsonEdit(CodeEdit):
+    def __init__(self, parent):
+        CodeEdit.__init__(self, parent)

pyqttoolkit/views/labelled.py

@@ -0,0 +1,29 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from PyQt5.QtWidgets import QWidget, QHBoxLayout, QLabel
+
+
+def make_labelled(parent, label: str, widget: QWidget):
+    """Put a widget into a container with a label to the left of it. Like a single row of a `QFormLayout`"""
+    container = QWidget(parent)
+    label_widget = QLabel(label)
+    layout = QHBoxLayout(container)
+    layout.setSpacing(0)
+    layout.addWidget(label_widget)
+    layout.addWidget(widget)
+    layout.setContentsMargins(0, 0, 0, 0)
+    return container

pyqttoolkit/views/layout/__init__.py

@@ -0,0 +1,21 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from .lines import HLine, VLine
+from .group_panel import GroupPanelLayout, VGroupPanelLayout, HGroupPanelLayout, GroupPanelWidget, HGroupPanelWidget, VGroupPanelWidget
+from .group_box import wrap_in_group_box, wrap_many_in_group_box
+from .collabsible import HCollapsibleLayout, VCollapsibleLayout
+from .link import LinkWidget

pyqttoolkit/views/layout/collabsible.py

@@ -0,0 +1,59 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from PyQt5.QtWidgets import QBoxLayout, QToolButton
+from PyQt5.QtCore import Qt
+
+class CollapsibleLayout(QBoxLayout):
+    def __init__(self, parent, direction):
+        QBoxLayout.__init__(self, direction, parent)
+        self._index = 0
+        self._widgets = []
+    
+    def addWidget(self, widget, group_name, expanded=True):
+        QBoxLayout.addWidget(self, self._create_header(group_name, expanded))
+        QBoxLayout.addWidget(self, widget)
+        self._widgets.append(widget)
+        widget.setVisible(expanded)
+        self._index += 1
+    
+    def _create_header(self, name, expanded):
+        button = QToolButton(self.parent())
+        button.setStyleSheet('QToolButton { border: none; }')
+        button.setToolButtonStyle(Qt.ToolButtonTextBesideIcon)
+        button.setArrowType(self._get_arrow(expanded))
+        button.setText(name)
+        button.setCheckable(True)
+        button.setChecked(True)
+        button.clicked.connect(self._handle_toggle(button, self._index))
+        return button
+    
+    def _handle_toggle(self, button, index):
+        def _handler(checked):
+            button.setArrowType(self._get_arrow(checked))
+            self._widgets[index].setVisible(checked)
+        return _handler
+
+    def _get_arrow(self, expanded):
+        return Qt.DownArrow if expanded else Qt.RightArrow
+
+class VCollapsibleLayout(CollapsibleLayout):
+    def __init__(self, parent):
+        CollapsibleLayout.__init__(self, parent, QBoxLayout.TopToBottom)
+
+class HCollapsibleLayout(CollapsibleLayout):
+    def __init__(self, parent):
+        CollapsibleLayout.__init__(self, parent, QBoxLayout.LeftToRight)

pyqttoolkit/views/layout/group_box.py

@@ -0,0 +1,48 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from PyQt5.QtWidgets import QGroupBox, QGridLayout, QVBoxLayout
+from PyQt5.QtCore import Qt
+
+class LinkGroupBox(QGroupBox):
+    def __init__(self, name, parent, linkable_widget):
+        QGroupBox.__init__(self, name, parent)
+        self._linkable_widget = linkable_widget
+        if hasattr(self._linkable_widget, 'setLinkDisplay'):
+            self._linkable_widget.setLinkDisplay(self)
+    
+    def mouseDoubleClickEvent(self, _event):
+        if hasattr(self._linkable_widget, 'linkRequested'):
+            self._linkable_widget.linkRequested()
+
+def wrap_in_group_box(widget, parent, name, alignment=Qt.AlignTop):
+    group_box = LinkGroupBox(name, parent, widget)
+    group_box_layout = QGridLayout(group_box)
+    if alignment is not None:
+        group_box_layout.addWidget(widget, 0, 0, alignment)
+    else:
+        group_box_layout.addWidget(widget, 0, 0)
+    return group_box
+
+def wrap_many_in_group_box(widgets, parent, name, alignment=Qt.AlignTop):
+    group_box = QGroupBox(name, parent)
+    group_box_layout = QVBoxLayout(group_box)
+    for widget in widgets:
+        if alignment is not None:
+            group_box_layout.addWidget(widget, alignment)
+        else:
+            group_box_layout.addWidget(widget)
+    return group_box