bec-widgets 0.95.1__py3-none-any.whl → 0.96.0__py3-none-any.whl

CHANGELOG.md

@@ -1,5 +1,15 @@
 # CHANGELOG
 
+## v0.96.0 (2024-08-22)
+
+### Documentation
+
+* docs(scan_control): added designer options ([`9d7718c`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/9d7718c3d9badf14150174410b9958a3134a1e23))
+
+### Feature
+
+* feat(scan_control): added the ability to configure the scan control widget from designer ([`9d8fb0b`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/9d8fb0b761efa92972399bcd9aea28e956074380))
+
 ## v0.95.1 (2024-08-22)
 
 ### Documentation
@@ -148,12 +158,6 @@ Terminating client connections has to be done at the application level ([`198c1d
 
 * fix(dock): properly shut down docks and temp areas ([`99ee545`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/99ee545e41c6078654958b668b5b329f85553d16))
 
-* fix(settings): shut down settings dialog ([`b50b3a2`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/b50b3a27e68956e10e8169a0aa698c911d2d9642))
-
-* fix(website): fixed teardown of website widgets ([`a3d4f5a`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/a3d4f5ac4bc52acfed2791a1724fade6972ed320))
-
 ### Test
 
 * test: removed quit from teardown ([`cf94599`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/cf94599c2544d6831c8afbe7b340082077557ed1))
-
-* test: removed explicit call to close the widget ([`bf6294e`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/bf6294ecbfd494565d2dc215e4d7e0c280ac7745))

PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: bec_widgets
-Version: 0.95.1
+Version: 0.96.0
 Summary: BEC Widgets
 Project-URL: Bug Tracker, https://gitlab.psi.ch/bec/bec_widgets/issues
 Project-URL: Homepage, https://gitlab.psi.ch/bec/bec_widgets

bec_widgets/widgets/scan_control/scan_control.py

@@ -1,9 +1,11 @@
 from bec_lib.endpoints import MessageEndpoints
+from qtpy.QtCore import Property, Signal, Slot
 from qtpy.QtWidgets import (
     QApplication,
     QComboBox,
     QGridLayout,
     QGroupBox,
+    QHBoxLayout,
     QPushButton,
     QSizePolicy,
     QVBoxLayout,
@@ -18,6 +20,9 @@ from bec_widgets.widgets.stop_button.stop_button import StopButton
 
 class ScanControl(BECWidget, QWidget):
 
+    scan_started = Signal()
+    scan_selected = Signal(str)
+
     def __init__(
         self, parent=None, client=None, gui_id: str | None = None, allowed_scans: list | None = None
     ):
@@ -50,11 +55,26 @@ class ScanControl(BECWidget, QWidget):
         self.layout.addWidget(self.scan_selection_group)
 
         # Connect signals
-        self.comboBox_scan_selection.currentIndexChanged.connect(self.on_scan_selected)
+        self.comboBox_scan_selection.currentIndexChanged.connect(self.on_scan_selection_changed)
         self.button_run_scan.clicked.connect(self.run_scan)
+
+        # Add bundle button
+        self.button_add_bundle = QPushButton("Add Bundle")
+        self.button_add_bundle.setVisible(False)
+        # Remove bundle button
+        self.button_remove_bundle = QPushButton("Remove Bundle")
+        self.button_remove_bundle.setVisible(False)
+
+        bundle_layout = QHBoxLayout()
+        bundle_layout.addWidget(self.button_add_bundle)
+        bundle_layout.addWidget(self.button_remove_bundle)
+        self.layout.addLayout(bundle_layout)
+
         self.button_add_bundle.clicked.connect(self.add_arg_bundle)
         self.button_remove_bundle.clicked.connect(self.remove_arg_bundle)
 
+        self.scan_selected.connect(self.scan_select)
+
         # Initialize scan selection
         self.populate_scans()
 
@@ -69,21 +89,16 @@ class ScanControl(BECWidget, QWidget):
         scan_selection_group = QGroupBox("Scan Selection", self)
         self.scan_selection_layout = QGridLayout(scan_selection_group)
         self.comboBox_scan_selection = QComboBox(scan_selection_group)
+
         # Run button
         self.button_run_scan = QPushButton("Start", scan_selection_group)
         self.button_run_scan.setStyleSheet("background-color:  #559900; color: white")
         # Stop button
         self.button_stop_scan = StopButton(parent=scan_selection_group)
-        # Add bundle button
-        self.button_add_bundle = QPushButton("Add Bundle", scan_selection_group)
-        # Remove bundle button
-        self.button_remove_bundle = QPushButton("Remove Bundle", scan_selection_group)
 
         self.scan_selection_layout.addWidget(self.comboBox_scan_selection, 0, 0, 1, 2)
         self.scan_selection_layout.addWidget(self.button_run_scan, 1, 0)
         self.scan_selection_layout.addWidget(self.button_stop_scan, 1, 1)
-        self.scan_selection_layout.addWidget(self.button_add_bundle, 2, 0)
-        self.scan_selection_layout.addWidget(self.button_remove_bundle, 2, 1)
 
         return scan_selection_group
 
@@ -104,23 +119,65 @@ class ScanControl(BECWidget, QWidget):
             allowed_scans = self.allowed_scans
         self.comboBox_scan_selection.addItems(allowed_scans)
 
-    def on_scan_selected(self):
+    def on_scan_selection_changed(self, index: int):
         """Callback for scan selection combo box"""
-        self.reset_layout()
         selected_scan_name = self.comboBox_scan_selection.currentText()
-        selected_scan_info = self.available_scans.get(selected_scan_name, {})
+        self.scan_selected.emit(selected_scan_name)
+
+    @Property(bool)
+    def hide_scan_control_buttons(self):
+        return not self.button_run_scan.isVisible()
+
+    @hide_scan_control_buttons.setter
+    def hide_scan_control_buttons(self, hide: bool):
+        self.show_scan_control_buttons(not hide)
+
+    @Slot(bool)
+    def show_scan_control_buttons(self, show: bool):
+        """Shows or hides the scan control buttons."""
+        self.button_run_scan.setVisible(show)
+        self.button_stop_scan.setVisible(show)
+
+        show_group = show or self.button_run_scan.isVisible()
+        self.scan_selection_group.setVisible(show_group)
+
+    @Property(bool)
+    def hide_scan_selection_combobox(self):
+        return not self.comboBox_scan_selection.isVisible()
+
+    @hide_scan_selection_combobox.setter
+    def hide_scan_selection_combobox(self, hide: bool):
+        self.show_scan_selection_combobox(not hide)
+
+    @Slot(bool)
+    def show_scan_selection_combobox(self, show: bool):
+        """Shows or hides the scan selection combobox."""
+        self.comboBox_scan_selection.setVisible(show)
+
+        show_group = show or self.button_run_scan.isVisible()
+        self.scan_selection_group.setVisible(show_group)
+
+    @Slot(str)
+    def scan_select(self, scan_name: str):
+        """
+        Slot for scan selection. Updates the scan control layout based on the selected scan.
+
+        Args:
+            scan_name(str): Name of the selected scan.
+        """
+        self.reset_layout()
+        selected_scan_info = self.available_scans.get(scan_name, {})
 
         gui_config = selected_scan_info.get("gui_config", {})
         self.arg_group = gui_config.get("arg_group", None)
         self.kwarg_groups = gui_config.get("kwarg_groups", None)
 
-        if self.arg_box is None:
-            self.button_add_bundle.setEnabled(False)
-            self.button_remove_bundle.setEnabled(False)
+        show_bundle_buttons = bool(self.arg_group["arg_inputs"])
+
+        self.button_add_bundle.setVisible(show_bundle_buttons)
+        self.button_remove_bundle.setVisible(show_bundle_buttons)
 
-        if len(self.arg_group["arg_inputs"]) > 0:
-            self.button_add_bundle.setEnabled(True)
-            self.button_remove_bundle.setEnabled(True)
+        if show_bundle_buttons:
             self.add_arg_group(self.arg_group)
         if len(self.kwarg_groups) > 0:
             self.add_kwargs_boxes(self.kwarg_groups)
@@ -151,9 +208,11 @@ class ScanControl(BECWidget, QWidget):
         self.arg_box.setSizePolicy(QSizePolicy.Preferred, QSizePolicy.Fixed)
         self.layout.addWidget(self.arg_box)
 
+    @Slot()
     def add_arg_bundle(self):
         self.arg_box.add_widget_bundle()
 
+    @Slot()
     def remove_arg_bundle(self):
         self.arg_box.remove_widget_bundle()
 
@@ -172,7 +231,9 @@ class ScanControl(BECWidget, QWidget):
             box.deleteLater()
         self.kwarg_boxes = []
 
+    @Slot()
     def run_scan(self):
+        self.scan_started.emit()
         args = []
         kwargs = {}
         if self.arg_box is not None:

{bec_widgets-0.95.1.dist-info → bec_widgets-0.96.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: bec_widgets
-Version: 0.95.1
+Version: 0.96.0
 Summary: BEC Widgets
 Project-URL: Bug Tracker, https://gitlab.psi.ch/bec/bec_widgets/issues
 Project-URL: Homepage, https://gitlab.psi.ch/bec/bec_widgets

{bec_widgets-0.95.1.dist-info → bec_widgets-0.96.0.dist-info}/RECORD

@@ -2,11 +2,11 @@
 .gitlab-ci.yml,sha256=BtKhZI3dhK09En1BfpglYi-ZJwG6ZdC-iJr7kXFVfCg,8346
 .pylintrc,sha256=eeY8YwSI74oFfq6IYIbCqnx3Vk8ZncKaatv96n_Y8Rs,18544
 .readthedocs.yaml,sha256=aSOc277LqXcsTI6lgvm_JY80lMlr69GbPKgivua2cS0,603
-CHANGELOG.md,sha256=fG-xnuzKLzH0m71vhqcb8WPat38owyxfhx9KE5gJzVg,6787
+CHANGELOG.md,sha256=cn9vMVxfaE1aginGiTCdUyQqJGCeFJ8LjFsmXsuI8Gg,6733
 LICENSE,sha256=YRKe85CBRyP7UpEAWwU8_qSIyuy5-l_9C-HKg5Qm8MQ,1511
-PKG-INFO,sha256=LfNoUqnLb3yWVkPszaOR7AxQJiHoryDrodbow5LQzHY,1325
+PKG-INFO,sha256=wPwVfj4xSkopVoH2p_P6HnIWGsIpRruwbtMoyn-TEW0,1325
 README.md,sha256=Od69x-RS85Hph0-WwWACwal4yUd67XkEn4APEfHhHFw,2649
-pyproject.toml,sha256=4RUSw-USwHLp_gv-hNEjAcfTVt0Z4GoGDHW6Qlcs4Es,2416
+pyproject.toml,sha256=K2NOh1jWSsA8Lu9cm-ed-LPb1LoORhaFvSNJcmFGcy4,2416
 .git_hooks/pre-commit,sha256=n3RofIZHJl8zfJJIUomcMyYGFi_rwq4CC19z0snz3FI,286
 .gitlab/issue_templates/bug_report_template.md,sha256=gAuyEwl7XlnebBrkiJ9AqffSNOywmr8vygUFWKTuQeI,386
 .gitlab/issue_templates/documentation_update_template.md,sha256=FHLdb3TS_D9aL4CYZCjyXSulbaW5mrN2CmwTaeLPbNw,860
@@ -211,7 +211,7 @@ bec_widgets/widgets/ring_progress_bar/ring_progress_bar.pyproject,sha256=ZNYDnKD
 bec_widgets/widgets/ring_progress_bar/ring_progress_bar_plugin.py,sha256=f6eAuDEvmnl0gy-cBwUkuUS4yr1VGjVEa40N5MIXwF0,1511
 bec_widgets/widgets/scan_control/__init__.py,sha256=IOfHl15vxb_uC6KN62-PeUzbBha_vQyqkkXbJ2HU674,38
 bec_widgets/widgets/scan_control/register_scan_control.py,sha256=xUX2yR0-MaIMg9_y9qe50yDDphzsh2x1b5PMrF90yPM,475
-bec_widgets/widgets/scan_control/scan_control.py,sha256=YT3Vvy27_FY3UY7IXvy87o9ZB_syauuEKzkJFOpbP4s,7610
+bec_widgets/widgets/scan_control/scan_control.py,sha256=30pcaVaBVo6JxJuMH1ul1s-sPuWqCUKsUQ-XfAgzRZ8,9384
 bec_widgets/widgets/scan_control/scan_control.pyproject,sha256=eTgVDFKToIH8_BbJjM2RvbOLr7HnYoidX0SAHx640DM,30
 bec_widgets/widgets/scan_control/scan_control_plugin.py,sha256=t3_qTACqYcvl_Wr102bIdVDyw6uNK1B94fh_wjs-lxg,1477
 bec_widgets/widgets/scan_control/scan_group_box.py,sha256=BpX9ZphqOhdEbQnGzNeNlmuZsMS__U97CkBMical2FY,9300
@@ -329,8 +329,9 @@ docs/user/widgets/positioner_box/positioner_box.md,sha256=voOU_wfwd-qBykk-60PWoO
 docs/user/widgets/progress_bar/progress_bar.gif,sha256=5jh0Zw2BBGPuNxszV1DBLJCb4_6glIRX-U2ABjnsK2k,5263592
 docs/user/widgets/progress_bar/ring_progress_bar.md,sha256=F9q2UrwZWwNzbjs1ONfSgP1dqgb5dx8AbOoTZOJGzWA,3705
 docs/user/widgets/queue/queue.md,sha256=Re37dp_YHTa9N6TTobScO_n3Fniq2_Ca2Ms3DOb0suA,2110
+docs/user/widgets/scan_control/hide_scan_control.png,sha256=juhkTBdz-WnJfPhj6UEkOiiCD6HfTinoETokF20nhsA,21890
 docs/user/widgets/scan_control/scan_control.gif,sha256=zrVOZgleMbu7Jd8AAIn2fQ08tNAEMSud3g0ZLyNUcjQ,1506739
-docs/user/widgets/scan_control/scan_control.md,sha256=7czdukW_C76st9tWr85tnNUi0Z-WsKfaYKrr37Vp8n8,2545
+docs/user/widgets/scan_control/scan_control.md,sha256=4pMTZJHx9VMYgEVGG_ybiJxwNbdQqAqa_dvM6lz0LMs,3275
 docs/user/widgets/spinner/spinner.md,sha256=MN7LeAkNOqRZ_A6c4PGv6KsiGbjm7Q-nkGkL5CcxOeE,2465
 docs/user/widgets/text_box/text_box.md,sha256=u8UoApmnH3LilWUQ73ASd6ts0FQfM6eRqg3GG9iQhOc,2508
 docs/user/widgets/toggle/toggle.md,sha256=vmhqbTU93R9DUeR0a85gGIRPc07cSl3_vtsVN4r0yO0,2983
@@ -398,8 +399,8 @@ tests/unit_tests/test_configs/config_device_no_entry.yaml,sha256=hdvue9KLc_kfNzG
 tests/unit_tests/test_configs/config_scan.yaml,sha256=vo484BbWOjA_e-h6bTjSV9k7QaQHrlAvx-z8wtY-P4E,1915
 tests/unit_tests/test_msgs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/unit_tests/test_msgs/available_scans_message.py,sha256=m_z97hIrjHXXMa2Ex-UvsPmTxOYXfjxyJaGkIY6StTY,46532
-bec_widgets-0.95.1.dist-info/METADATA,sha256=LfNoUqnLb3yWVkPszaOR7AxQJiHoryDrodbow5LQzHY,1325
-bec_widgets-0.95.1.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
-bec_widgets-0.95.1.dist-info/entry_points.txt,sha256=3otEkCdDB9LZJuBLzG4pFLK5Di0CVybN_12IsZrQ-58,166
-bec_widgets-0.95.1.dist-info/licenses/LICENSE,sha256=YRKe85CBRyP7UpEAWwU8_qSIyuy5-l_9C-HKg5Qm8MQ,1511
-bec_widgets-0.95.1.dist-info/RECORD,,
+bec_widgets-0.96.0.dist-info/METADATA,sha256=wPwVfj4xSkopVoH2p_P6HnIWGsIpRruwbtMoyn-TEW0,1325
+bec_widgets-0.96.0.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
+bec_widgets-0.96.0.dist-info/entry_points.txt,sha256=3otEkCdDB9LZJuBLzG4pFLK5Di0CVybN_12IsZrQ-58,166
+bec_widgets-0.96.0.dist-info/licenses/LICENSE,sha256=YRKe85CBRyP7UpEAWwU8_qSIyuy5-l_9C-HKg5Qm8MQ,1511
+bec_widgets-0.96.0.dist-info/RECORD,,

docs/user/widgets/scan_control/scan_control.md

@@ -23,11 +23,19 @@ By default, this widget supports scans that are derived from the following base
 The full procedure how to design `gui_config` for your custom scan class is described in the [Scan GUI Configuration](https://bec.readthedocs.io/en/latest/developer/scans/scan_gui_config.html) tutorial.
 ```
 
+## BECDesigner Customization
+Within the BECDesigner's [property editor](https://doc.qt.io/qt-6/designer-widget-mode.html#the-property-editor/), the `ScanControl` widget can be customized to suit your application's requirements. The widget provides the following customization options:
+- **Hide Scan Control**: Allows you to hide the scan control buttons from the widget interface. This is useful when you want to place the control buttons in a different location.
+- **Hide Scan Selection**: Allows you to hide the scan selection combobox from the widget interface. This is useful when you want to restrict the user to a specific scan type or implement a custom scan selection mechanism.
+
+```{figure} ./hide_scan_control.png
+```
+
 ````
 
 ````{tab} Examples
 
-The `ScanControl` widget can be integrated within a [`BECDockArea`](user.widgets.bec_dock_area) or used as an individual component in your application through `QtDesigner`. Below are examples demonstrating how to create and use the `ScanControl` widget.
+The `ScanControl` widget can be integrated within a [`BECDockArea`](user.widgets.bec_dock_area) or used as an individual component in your application through `BECDesigner`. Below are examples demonstrating how to create and use the `ScanControl` widget.
 
 ## Example 1 - Adding Scan Control Widget to BECDockArea
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "bec_widgets"
-version = "0.95.1"
+version = "0.96.0"
 description = "BEC Widgets"
 requires-python = ">=3.10"
 classifiers = [