0.8.0

Develop

Author: bimac

CHANGELOG.md

@@ -6,6 +6,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.0] - 2025-07-18
+
+### Added
+- `widgets.ColoredButton`: as the name suggests ...
+
+### Changed
+- `widgets.SlideToggle`: tweaked color-scheme
+
 ## [0.7.1] - 2025-07-16
 
 ### Changed
@@ -145,6 +153,7 @@ _First release._
   providing color-mapped numerical data.
 - `widgets.StatefulButton`: A `QPushButton` that maintains an active/inactive state.
 
+[0.8.0]: https://github.com/int-brain-lab/iblqt/releases/tag/v0.8.0
 [0.7.1]: https://github.com/int-brain-lab/iblqt/releases/tag/v0.7.1
 [0.7.0]: https://github.com/int-brain-lab/iblqt/releases/tag/v0.7.0
 [0.6.1]: https://github.com/int-brain-lab/iblqt/releases/tag/v0.6.1

iblqt/__init__.py

@@ -1,3 +1 @@
 """A collection of extensions to the Qt framework."""
-
-__version__ = '0.7.1'

iblqt/widgets.py

@@ -147,7 +147,64 @@ def editorEvent(
         return super().editorEvent(event, model, option, index)
 
 
-class StatefulButton(QPushButton):
+class ColoredButton(QPushButton):
+    """A QPushButton that can change color."""
+
+    def __init__(
+        self,
+        text: str,
+        color: QColor | None = None,
+        parent: QWidget | None = None,
+        **kwargs,
+    ):
+        """
+        Initialize the ColoredButton.
+
+        Parameters
+        ----------
+        text : str
+            The text to be displayed.
+        color : QColor, optional
+            The color to use for the button.
+        parent : QWidget
+            The parent widget.
+        **kwargs : dict
+            Arbitrary keyword arguments (passed to QPushButton).
+        """
+        super().__init__(text, parent, **kwargs)
+        self._original_color = self.palette().color(QPalette.Button)
+        if color is not None:
+            self.setColor(color)
+
+    def setColor(self, color: QColor | None) -> None:
+        """
+        Set the color of the button.
+
+        Parameters
+        ----------
+        color : QColor, optional
+            The new color of the button. If None, the color will be reset to it's
+            default color.
+        """
+        palette = self.palette()
+        palette.setColor(QPalette.Button, color or self._original_color)
+        self.setPalette(palette)
+        self.setAutoFillBackground(True)
+        self.update()
+
+    def color(self) -> QColor:
+        """
+        Return the color of the button.
+
+        Returns
+        -------
+        QColor
+            The color of the button.
+        """
+        return self.palette().color(QPalette.Button)
+
+
+class StatefulButton(ColoredButton):
     """A QPushButton that maintains an active/inactive state."""
 
     clickedWhileActive = Signal()  # type: Signal
@@ -166,8 +223,10 @@ def __init__(
         textInactive: str | None = None,
         active: bool = False,
         parent: QWidget | None = None,
+        **kwargs: dict[str, Any],
     ):
-        """Initialize the StatefulButton with the specified active state.
+        """
+        Initialize the StatefulButton with the specified active state.
 
         Parameters
         ----------
@@ -179,11 +238,18 @@ def __init__(
             Initial state of the button (default is False).
         parent : QWidget
             The parent widget.
+        **kwargs : dict
+            Arbitrary keyword arguments (passed to ColoredButton).
         """
         self._isActive = active
         self._textActive = textActive or ''
         self._textInactive = textInactive or ''
-        super().__init__(self._textActive if active else self._textInactive, parent)
+        super().__init__(
+            text=self._textActive if active else self._textInactive,
+            color=None,
+            parent=parent,
+            **kwargs,
+        )
 
         self.clicked.connect(self._onClick)
         self.stateChanged.connect(self._onStateChange)
@@ -281,7 +347,10 @@ def _onClick(self):
     @Slot(bool)
     def _onStateChange(self, state: bool):
         """Handle the state change event."""
-        self.setText(self._textActive if state is True else self._textInactive)
+        if state is True:
+            self.setText(self._textActive)
+        if state is False:
+            self.setText(self._textInactive)
 
 
 class UseTokenCache(IntEnum):
@@ -913,11 +982,12 @@ def paintEvent(self, event: QPaintEvent):
         # Determine colors based on state
         palette = self.palette()
         if not self.isEnabled():
-            color_background = palette.shadow().color()
-            color_foreground = palette.midlight().color()
+            color_background = palette.dark().color()
+            color_background.setAlphaF(0.6)
+            color_foreground = palette.window().color()
         elif self.isChecked():
             color_background = palette.highlight().color()
-            color_foreground = palette.highlightedText().color()
+            color_foreground = palette.light().color()
         else:
             color_background = palette.dark().color()
             color_foreground = palette.light().color()

pyproject.toml

@@ -1,9 +1,10 @@
 [build-system]
-requires = ["pdm-backend"]
-build-backend = "pdm.backend"
+requires = ["uv_build"]
+build-backend = "uv_build"
 
 [project]
 name = "iblqt"
+version = "0.8.0"
 description = "A collection of extensions to the Qt framework."
 dependencies = [
   "qtpy>=2.4.1",
@@ -20,7 +21,6 @@ license = {text = "MIT"}
 authors = [
   {name = "Florian Rau", email = "[email protected]"},
 ]
-dynamic = ["version"]
 
 [project.optional-dependencies]
 pyqt5 = [
@@ -85,16 +85,11 @@ required-environments = [
     "sys_platform == 'darwin'",
 ]
 
-[tool.pdm]
-distribution = true
-
-[tool.pdm.build]
-excludes = [ "docs/source/api" ]
-source-includes = [ "tests/*.py", "resources/", "docs/source/" ]
-
-[tool.pdm.version]
-source = "file"
-path = "iblqt/__init__.py"
+[tool.uv.build-backend]
+module-name = "iblqt"
+module-root = ""
+source-include = [ "tests/*.py", "resources/**/*", "docs/source/**/*" ]
+source-exclude = [ "docs/source/api" ]
 
 [tool.ruff]
 include = ["pyproject.toml", "iblqt/**/*.py", "tests/**/*.py"]

tests/test_widgets.py

@@ -66,6 +66,39 @@ def test_painting_checkbox(self, qtbot, setup_method):
         self.delegate.paint(painter, option, index)
 
 
+class TestColoredButton:
+    @pytest.fixture
+    def button_factory(self, qtbot):
+        def _create_button(text='Click Me', color=None, parent=None):
+            button = widgets.ColoredButton(text, color=color, parent=parent)
+            qtbot.addWidget(button)
+            return button
+
+        return _create_button
+
+    def test_default_color(self, button_factory):
+        button = button_factory()
+        default_color = button._original_color
+        assert button.color() == default_color
+
+    def test_initial_color(self, button_factory):
+        button = button_factory(color=QColor('red'))
+        assert button.color() == QColor('red')
+
+    def test_set_color(self, button_factory):
+        button = button_factory()
+        new_color = QColor('red')
+        button.setColor(new_color)
+        assert button.color() == new_color
+
+    def test_resets_color(self, button_factory):
+        button = button_factory()
+        original = button._original_color
+        button.setColor(QColor('blue'))
+        button.setColor(None)
+        assert button.color() == original
+
+
 class TestStatefulButton:
     def test_initial_state(self, qtbot):
         """Test the initial state of the StatefulButton."""