codeallyadvanced 2.6.0__tar.gz → 3.1.0__tar.gz

{codeallyadvanced-2.6.0/src/codeallyadvanced.egg-info → codeallyadvanced-3.1.0}/PKG-INFO

@@ -1,27 +1,27 @@
 Metadata-Version: 2.4
 Name: codeallyadvanced
-Version: 2.6.0
+Version: 3.1.0
 Summary: Humberto`s Common wxPython UI Stuff
 Author-email: "Humberto A. Sanchez II" <Humberto.A.Sanchez.II@gmail.com>
 Maintainer-email: "Humberto A. Sanchez II" <Humberto.A.Sanchez.II@gmail.com>
 License-Expression: AGPL-1.0-or-later
 Project-URL: Repository, https://github.com/hasii2011/code-ally-advanced
-Keywords: pyut,python,wxPython,UI,umldiagrammer
+Keywords: uml,python,wxPython,UI,umldiagrammer
 Classifier: Programming Language :: Python
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: MacOS :: MacOS X
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: buildlackey>=2.0.0
-Requires-Dist: wxPython>=4.2.4
+Requires-Dist: buildlackey>=2.1.0
+Requires-Dist: wxPython>=4.3.1
 Provides-Extra: test
-Requires-Dist: mypy==1.18.2; extra == "test"
-Requires-Dist: codeallybasic==1.30.0; extra == "test"
+Requires-Dist: mypy==2.3.1; extra == "test"
+Requires-Dist: codeallybasic==1.40.0; extra == "test"
 Requires-Dist: mypy-extensions==1.1.0; extra == "test"
 Requires-Dist: types-Deprecated==1.3.1.20251101; extra == "test"
 Requires-Dist: html-testRunner~=1.2.1; extra == "test"
-Requires-Dist: click==8.3.3; extra == "test"
+Requires-Dist: click==8.5.0; extra == "test"
 Provides-Extra: docs
 Requires-Dist: sphinx>=7.0.0; extra == "docs"
 Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "docs"
@@ -33,39 +33,54 @@ Requires-Dist: twine==6.2.0; extra == "deploy"
 Requires-Dist: build==1.3.0; extra == "deploy"
 Dynamic: license-file
 
-![](https://github.com/hasii2011/code-ally-basic/blob/master/developer/agpl-license-web-badge-version-2-256x48.png "AGPL")
-
+[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/hasii2011/code-ally-advanced/graphs/commit-activity)
 [![CI](https://github.com/hasii2011/code-ally-advanced/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/hasii2011/code-ally-advanced/actions/workflows/ci.yml)
 [![PyPI version](https://badge.fury.io/py/codeallyadvanced.svg)](https://badge.fury.io/py/codeallyadvanced)
-[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/hasii2011/code-ally-advanced/graphs/commit-activity)
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE)
+[![Made with Python](https://img.shields.io/badge/Made%20with-Python-3776AB?logo=python&logoColor=white)](https://www.python.org/)
+[![Documentation Status](https://readthedocs.org/projects/code-ally-advanced/badge/?version=latest)](https://code-ally-advanced.readthedocs.io/en/latest/?badge=latest)
+[![GitHub Copilot: No](https://img.shields.io/badge/GitHub_Copilot-No-red?logo=github&style=flat-square)](https://github.com/hasii2011/code-ally-basic/wiki/GitHub-Copilot)
 
-[![forthebadge made-with-python](http://ForTheBadge.com/images/badges/made-with-python.svg)](https://www.python.org/)
+This repository hosts common UI artifacts for various projects I develop.
 
-Host common UI artifacts for various projects I am developing
+The documentation is on [Read the Docs](https://code-ally-advanced.readthedocs.io/en/latest/).
 
 ___
-Common wxPython UI artifacts for various projects I am developing
+Available wxPython UI components:
 
 * Dimensions Control
 * Position Control
 * MinMax Control
+* Named Spin Control
 * Directory Selector
+* Dial Selector
+* Titled Panels
 
-![SpinnerWidgets](./developer/SpinnerWidgets.png)
+### Component Previews
 
-* DialSelector
+* Spinner Widgets
+
+    ![SpinnerWidgets](./developer/SpinnerWidgets.png)
+
+* Directory Selector
+
+    ![DirectorySelector](./developer/DirectorySelector.png)
+
+* Dial Selector
 
     ![DialSelector](./developer/DialSelector.png)
 
-Written by <a href="mailto:email@humberto.a.sanchez.ii@gmail.com?subject=Hello Humberto">Humberto A. Sanchez II</a>  (C) 2025
+* Titled Panels
+
+    ![TitledPanels](./developer/TitledPanels.png)
+
+Written by <a href="mailto:humberto.a.sanchez.ii@gmail.com?subject=Hello Humberto">Humberto A. Sanchez II</a>  (C) 2026
 
 ## Note
 For all kinds of problems, requests, enhancements, bug reports, etc., drop me an e-mail.
 
 ## Developer Notes
-This project uses [buildlackey](https://github.com/hasii2011/buildlackey) for day-to-day development builds
-
-Also notice that this project does not include a `requirements.txt` file.  All dependencies are listed in the `pyproject.toml` file.
+This project uses [buildlackey](https://github.com/hasii2011/buildlackey) for day-to-day development builds.
 
 #### Install the main project dependencies
 
@@ -86,4 +101,5 @@ pip install .[deploy]
 ```
 
 ---
-[Copilot Statement](https://github.com/hasii2011/code-ally-basic/wiki/GitHub-Copilot).
+> [!NOTE]
+> **I do not consent to GitHub's use of this project's code in Copilot.** See our [GitHub Copilot Statement](https://github.com/hasii2011/code-ally-basic/wiki/GitHub-Copilot) for details.

codeallyadvanced-3.1.0/README.md

@@ -0,0 +1,70 @@
+[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/hasii2011/code-ally-advanced/graphs/commit-activity)
+[![CI](https://github.com/hasii2011/code-ally-advanced/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/hasii2011/code-ally-advanced/actions/workflows/ci.yml)
+[![PyPI version](https://badge.fury.io/py/codeallyadvanced.svg)](https://badge.fury.io/py/codeallyadvanced)
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE)
+[![Made with Python](https://img.shields.io/badge/Made%20with-Python-3776AB?logo=python&logoColor=white)](https://www.python.org/)
+[![Documentation Status](https://readthedocs.org/projects/code-ally-advanced/badge/?version=latest)](https://code-ally-advanced.readthedocs.io/en/latest/?badge=latest)
+[![GitHub Copilot: No](https://img.shields.io/badge/GitHub_Copilot-No-red?logo=github&style=flat-square)](https://github.com/hasii2011/code-ally-basic/wiki/GitHub-Copilot)
+
+This repository hosts common UI artifacts for various projects I develop.
+
+The documentation is on [Read the Docs](https://code-ally-advanced.readthedocs.io/en/latest/).
+
+___
+Available wxPython UI components:
+
+* Dimensions Control
+* Position Control
+* MinMax Control
+* Named Spin Control
+* Directory Selector
+* Dial Selector
+* Titled Panels
+
+### Component Previews
+
+* Spinner Widgets
+
+    ![SpinnerWidgets](./developer/SpinnerWidgets.png)
+
+* Directory Selector
+
+    ![DirectorySelector](./developer/DirectorySelector.png)
+
+* Dial Selector
+
+    ![DialSelector](./developer/DialSelector.png)
+
+* Titled Panels
+
+    ![TitledPanels](./developer/TitledPanels.png)
+
+Written by <a href="mailto:humberto.a.sanchez.ii@gmail.com?subject=Hello Humberto">Humberto A. Sanchez II</a>  (C) 2026
+
+## Note
+For all kinds of problems, requests, enhancements, bug reports, etc., drop me an e-mail.
+
+## Developer Notes
+This project uses [buildlackey](https://github.com/hasii2011/buildlackey) for day-to-day development builds.
+
+#### Install the main project dependencies
+
+```bash
+pip install .
+```
+
+#### Install the test dependencies
+
+```bash
+pip install .[test]
+```
+
+#### Install the deploy dependencies
+
+```bash
+pip install .[deploy]
+```
+
+---
+> [!NOTE]
+> **I do not consent to GitHub's use of this project's code in Copilot.** See our [GitHub Copilot Statement](https://github.com/hasii2011/code-ally-basic/wiki/GitHub-Copilot) for details.

{codeallyadvanced-2.6.0 → codeallyadvanced-3.1.0}/pyproject.toml

@@ -9,7 +9,7 @@ description = 'Humberto`s Common wxPython UI Stuff'
 readme      = "README.md"
 authors     = [{name = 'Humberto A. Sanchez II', email = 'Humberto.A.Sanchez.II@gmail.com'}]
 maintainers = [{name = 'Humberto A. Sanchez II', email = 'Humberto.A.Sanchez.II@gmail.com'}]
-keywords    = ['pyut', 'python', 'wxPython', 'UI', 'umldiagrammer']
+keywords    = ['uml', 'python', 'wxPython', 'UI', 'umldiagrammer']
 license     = 'AGPL-1.0-or-later'
 license-files = ['LICENSE']
 classifiers = [
@@ -20,18 +20,18 @@ classifiers = [
 ]
 
 dependencies = [
-  'buildlackey>=2.0.0',
-  'wxPython>=4.2.4'
+  'buildlackey>=2.1.0',
+  'wxPython>=4.3.1'
 ]
 
 [project.optional-dependencies]
 test = [
-    'mypy==1.18.2',
-    'codeallybasic==1.30.0',
+    'mypy==2.3.1',
+    'codeallybasic==1.40.0',
     'mypy-extensions==1.1.0',
     'types-Deprecated==1.3.1.20251101',
     'html-testRunner~=1.2.1',
-    'click==8.3.3'
+    'click==8.5.0'
 
 ]
 

codeallyadvanced-3.1.0/src/codeallyadvanced/_version.py

@@ -0,0 +1 @@
+__version__: str = '3.1.0'

codeallyadvanced-3.1.0/src/codeallyadvanced/ui/widgets/DimensionsControl.py

@@ -0,0 +1,63 @@
+
+from logging import Logger
+from logging import getLogger
+
+from dataclasses import dataclass
+
+from wx.lib.sized_controls import SizedPanel
+
+from codeallybasic.Dimensions import Dimensions
+
+from codeallyadvanced.ui.widgets.DualSpinnerControl import DualSpinnerControl
+from codeallyadvanced.ui.widgets.DualSpinnerControl import DualSpinnerParameters
+from codeallyadvanced.ui.widgets.DualSpinnerControl import SpinnerValues
+from codeallyadvanced.ui.widgets.DualSpinnerControl import ValueChangeCallback
+
+
+@dataclass
+class DimensionsParameters(DualSpinnerParameters):
+    minValue:           int = 50
+    maxValue:           int = 300
+    firstSpinnerLabel:  str = 'W:'
+    secondSpinnerLabel: str = 'H:'
+
+
+class DimensionsControl(DualSpinnerControl):
+    """
+    A facade around the basic dual spinner control;   Essentially
+        * Converts the spinner values to and from the Dimension type;
+        * Handles the spinner callback
+        * Forwards the spinner values as Dimension values
+    """
+    DIMENSION_MIN_VALUE: int = 50
+    DIMENSION_MAX_VALUE: int = 300
+
+    def __init__(self, parent: SizedPanel, parameters: DimensionsParameters):
+        """
+
+        Args:
+            parent:     The parent window
+            parameters: Configuration parameters for the dimensions control
+        """
+        self.logger:                     Logger              = getLogger(__name__)
+        self._dimensionsChangedCallback: ValueChangeCallback = parameters.valueChangedCallback
+        self._dimensions:                Dimensions          = Dimensions()
+
+        super().__init__(parent=parent, parameters=parameters)
+
+    def _setDimensions(self, newValue: Dimensions):
+        self._dimensions  = newValue
+        self.spinnerValues = SpinnerValues(value0=newValue.width, value1=newValue.height)
+
+    # noinspection PyPropertyDefinition
+    # noinspection PyTypeChecker
+    dimensions = property(fget=None, fset=_setDimensions, fdel=None, doc='Write only property to set dimensions on control')
+
+    def _notifyValueChanged(self, spinnerValues: SpinnerValues):
+        self.logger.info(f'{spinnerValues}')
+
+        self._dimensions.width  = spinnerValues.value0
+        self._dimensions.height = spinnerValues.value1
+
+        if self._dimensionsChangedCallback is not None:
+            self._dimensionsChangedCallback(self._dimensions)

codeallyadvanced-3.1.0/src/codeallyadvanced/ui/widgets/DirectorySelector.py

@@ -0,0 +1,141 @@
+
+from dataclasses import dataclass
+from logging import Logger
+from logging import getLogger
+
+from pathlib import Path
+from typing import Callable
+from typing import Optional
+from typing import cast
+
+from wx import BORDER_THEME
+from wx import ID_ANY
+from wx import ID_OK
+from wx import DD_DEFAULT_STYLE
+from wx import EVT_BUTTON
+from wx import ART_BUTTON
+from wx import ART_FOLDER
+
+from wx import ArtProvider
+from wx import BitmapBundle
+from wx import BitmapButton
+from wx import DirDialog
+from wx import CommandEvent
+from wx import Size
+from wx import TextCtrl
+
+from wx.lib.sized_controls import SizedPanel
+from wx.lib.sized_controls import SizedStaticBox
+
+DEFAULT_MIN_WIDTH:      int  = 280
+DEFAULT_MAX_WIDTH:      int  = 600
+DEFAULT_CONTROL_HEIGHT: int  = 58
+FOLDER_BITMAP_SIZE:     Size = Size(16, 16)
+
+DirectoryPathChangedCallback = Callable[[Path], None]
+NO_PATH_CALLBACK: DirectoryPathChangedCallback = cast(DirectoryPathChangedCallback, None)
+
+
+@dataclass
+class DirectorySelectorParameters:
+    caption:             str                          = ''
+    pathChangedCallback: DirectoryPathChangedCallback = NO_PATH_CALLBACK
+    expand:              bool                         = True
+    proportion:          int                          = 0
+
+
+class DirectorySelector(SizedStaticBox):
+    """
+    A horizontal row container used for selecting and displaying a filesystem directory.
+
+    Combines a non-editable TextCtrl showing the current directory path with a
+    BitmapButton featuring a folder icon. Clicking the button
+    invokes a DirDialog allowing the user to browse for a directory.
+
+    Features:
+        * Responsive layout: Horizontally expands (proportion=1) to fill available
+          width in parent sizers, bounded by DEFAULT_MIN_WIDTH and
+          DEFAULT_MAX_WIDTH.
+        * Vertical alignment: Maintains a compact, single-line height
+          (DEFAULT_CONTROL_HEIGHT) with centered controls.
+        * Callback notification: Dispatches directory change events to an optional
+          callback (`pathChangedCallback`) whenever a new directory is selected.
+        * Two-way path binding: Provides a `directoryPath` property (getter/setter)
+          to read or programmatically update the selected Path.
+    """
+    DEFAULT_MIN_WIDTH:      int  = DEFAULT_MIN_WIDTH
+    DEFAULT_MAX_WIDTH:      int  = DEFAULT_MAX_WIDTH
+    DEFAULT_CONTROL_HEIGHT: int  = DEFAULT_CONTROL_HEIGHT
+    FOLDER_BITMAP_SIZE:     Size = FOLDER_BITMAP_SIZE
+
+    def __init__(
+        self,
+        parent:     SizedPanel,
+        parameters: Optional[DirectorySelectorParameters] = None,
+        caption:    str                                   = '',
+    ):
+        """
+        Initialize the DirectorySelector static box and child controls.
+
+        Args:
+            parent:     The parent sized panel
+            parameters: Configuration parameters for the directory selector
+            caption:    Optional caption string used if parameters is not provided
+        """
+
+        self.logger: Logger = getLogger(__name__)
+
+        params: DirectorySelectorParameters = parameters if parameters is not None else DirectorySelectorParameters(caption=caption)
+
+        super().__init__(parent, ID_ANY, params.caption, style=BORDER_THEME)
+
+        self.SetSizerType('horizontal')
+        # noinspection PyUnresolvedReferences
+        self.SetSizerProps(expand=params.expand, proportion=params.proportion)
+
+        self._directorPathChangedCallback: DirectoryPathChangedCallback = params.pathChangedCallback
+
+        textCtrl: TextCtrl = TextCtrl(self)
+        textCtrl.SetSizerProps(valign='centre', proportion=1, border=(('right',), 5))
+
+        folderBitmapBundle: BitmapBundle = ArtProvider.GetBitmapBundle(ART_FOLDER, ART_BUTTON, FOLDER_BITMAP_SIZE)
+        selectButton:       BitmapButton = BitmapButton(self, ID_ANY, folderBitmapBundle)
+        selectButton.SetSizerProps(valign='centre')
+
+        textCtrl.SetValue('')
+        textCtrl.SetEditable(False)
+
+        self._textDiagramsDirectory: TextCtrl = textCtrl
+        self._directoryPath:         Path     = Path('')
+
+        self.Bind(EVT_BUTTON, self._onSelectDiagramsDirectory, selectButton)
+
+        self.SetMinSize(Size(DEFAULT_MIN_WIDTH, DEFAULT_CONTROL_HEIGHT))
+        self.SetMaxSize(Size(DEFAULT_MAX_WIDTH, DEFAULT_CONTROL_HEIGHT))
+
+    def DoGetBestSize(self) -> Size:
+        """
+        Calculate the best size for this directory selector static box.
+        """
+        return Size(400, DEFAULT_CONTROL_HEIGHT)
+
+    @property
+    def directoryPath(self) -> Path:
+        return self._directoryPath
+
+    @directoryPath.setter
+    def directoryPath(self, value: Path):
+
+        self._directoryPath = value
+        self._textDiagramsDirectory.SetValue(str(value))
+
+    # noinspection PyUnusedLocal
+    def _onSelectDiagramsDirectory(self, _event: CommandEvent):
+
+        with DirDialog(None, 'Choose the Diagrams Directory', defaultPath=str(self._directoryPath), style=DD_DEFAULT_STYLE) as dlg:
+
+            if dlg.ShowModal() == ID_OK:
+                self._directoryPath = Path(dlg.GetPath())
+                self._textDiagramsDirectory.SetValue(str(self._directoryPath))
+                if self._directorPathChangedCallback is not None:
+                    self._directorPathChangedCallback(self._directoryPath)

codeallyadvanced-3.1.0/src/codeallyadvanced/ui/widgets/DualSpinnerControl.py

@@ -0,0 +1,196 @@
+
+from typing import Any
+from typing import Callable
+from typing import cast
+from typing import Optional
+
+from logging import Logger
+from logging import getLogger
+
+from dataclasses import dataclass
+
+from wx import Size
+from wx import ID_ANY
+from wx import EVT_TEXT
+from wx import EVT_SPINCTRL
+from wx import BORDER_THEME
+
+from wx import SpinCtrl
+from wx import StaticText
+from wx import CommandEvent
+
+from wx import NewIdRef as wxNewIdRef
+
+from wx.lib.sized_controls import SizedPanel
+from wx.lib.sized_controls import SizedStaticBox
+
+SPINNER_WIDTH:          int = 80
+SPINNER_HEIGHT:         int = -1    # In wxWidgets, passing -1 for height uses native platform control height
+DEFAULT_CONTROL_HEIGHT: int = 58
+
+ValueChangeCallback = Callable[[Any], None]
+NO_VALUE_CALLBACK: ValueChangeCallback = cast(ValueChangeCallback, None)
+
+
+@dataclass
+class DualSpinnerParameters:
+    caption:              str                 = ''
+    valueChangedCallback: ValueChangeCallback = NO_VALUE_CALLBACK
+    minValue:             int                 = 100
+    maxValue:             int                 = 300
+    firstSpinnerLabel:    str                 = ''
+    secondSpinnerLabel:   str                 = ''
+    proportion:           int                 = 0
+    expand:               bool                = True
+
+
+@dataclass
+class SpinnerValues:
+    value0: int = 0
+    value1: int = 0
+
+
+class DualSpinnerControl(SizedStaticBox):
+    """
+    A component that pairs two spinners in a horizontal panel;  Callers set
+    the title to display and optionally the minimum and maximum spinner values
+    Ideal for subclassing to use as a way to get x,y coordinates or width, height
+    sizes
+    """
+
+    DEFAULT_MIN_VALUE: int = 100
+    DEFAULT_MAX_VALUE: int = 300
+
+    dscLogger: Logger = getLogger(__name__)     # Used as base class; So needs unique logger
+
+    def __init__(self, parent: SizedPanel, parameters: DualSpinnerParameters):
+        """
+
+        Args:
+            parent:     The parent panel
+            parameters: Configuration parameters for the dual spinner control
+        """
+
+        super().__init__(parent, ID_ANY, parameters.caption, style=BORDER_THEME)
+
+        self.SetSizerType('horizontal')
+        # noinspection PyUnresolvedReferences
+        self.SetSizerProps(expand=parameters.expand, proportion=parameters.proportion)
+
+        self._callback: ValueChangeCallback = parameters.valueChangedCallback
+
+        self._wxSpinner0Id: int = wxNewIdRef()
+        self._wxSpinner1Id: int = wxNewIdRef()
+
+        self._firstSpinnerLabel:  Optional[StaticText] = None
+        self._secondSpinnerLabel: Optional[StaticText] = None
+
+        self._spinner0: SpinCtrl = cast(SpinCtrl, None)
+        self._spinner1: SpinCtrl = cast(SpinCtrl, None)
+
+        self._createControls(parameters)
+        self._bindEventHandlers()
+
+        self.SetMinSize(Size(-1, DEFAULT_CONTROL_HEIGHT))
+        self.SetMaxSize(Size(-1, DEFAULT_CONTROL_HEIGHT))
+
+    def _createControls(self, parameters: DualSpinnerParameters):
+        """
+        Instantiate labels, spin controls, and configure ranges and initial values
+
+        Args:
+            parameters: Configuration parameters for the dual spinner control
+        """
+        if len(parameters.firstSpinnerLabel) > 0:
+            self._firstSpinnerLabel = StaticText(self, ID_ANY, parameters.firstSpinnerLabel)
+            self._firstSpinnerLabel.SetSizerProps(valign='centre', border=(('right',), 5))
+
+        self._spinner0 = SpinCtrl(self, self._wxSpinner0Id, '', size=Size(SPINNER_WIDTH, SPINNER_HEIGHT))
+        self._spinner0.SetSizerProps(valign='centre', border=(('right',), 10))
+
+        if len(parameters.secondSpinnerLabel) > 0:
+            self._secondSpinnerLabel = StaticText(self, ID_ANY, parameters.secondSpinnerLabel)
+            self._secondSpinnerLabel.SetSizerProps(valign='centre', border=(('right',), 5))
+
+        self._spinner1 = SpinCtrl(self, self._wxSpinner1Id, '', size=Size(SPINNER_WIDTH, SPINNER_HEIGHT))
+        self._spinner1.SetSizerProps(valign='centre')
+
+        self._spinner0.SetRange(parameters.minValue, parameters.maxValue)
+        self._spinner1.SetRange(parameters.minValue, parameters.maxValue)
+
+        self._spinnerValues: SpinnerValues = SpinnerValues(parameters.minValue, parameters.maxValue)
+
+    def _bindEventHandlers(self):
+        """
+        Bind to both text and spin events for typing and arrow clicks
+
+        """
+        self.Bind(EVT_TEXT,     self._onSpinnerValueChanged, self._spinner0)
+        self.Bind(EVT_TEXT,     self._onSpinnerValueChanged, self._spinner1)
+        self.Bind(EVT_SPINCTRL, self._onSpinnerValueChanged, self._spinner0)
+        self.Bind(EVT_SPINCTRL, self._onSpinnerValueChanged, self._spinner1)
+
+    def DoGetBestSize(self) -> Size:
+        """
+        Calculate the best size for this static box container, keeping
+        a compact vertical height suitable for spinner controls.
+        """
+        sizerBest:  Size            = self.GetSizer().GetMinSize()
+        borders:    tuple[int, int] = self.GetBordersForSizer()
+        totalWidth: int             = sizerBest.width + (borders[1] * 2) + 10
+
+        return Size(totalWidth, DEFAULT_CONTROL_HEIGHT)
+
+    def _setSpinnerValues(self, spinnerValues: SpinnerValues):
+        """
+        Write only;  The appropriate way to retrieve the values is via the change callback
+        Args:
+            spinnerValues:
+        """
+        self._spinnerValues = spinnerValues
+        self._spinner0.SetValue(spinnerValues.value0)
+        self._spinner1.SetValue(spinnerValues.value1)
+        self.dscLogger.info(f'range: {self._spinner0.GetRange()} - {self._spinner0.GetValue()=} {self._spinner1.GetValue()=}')
+
+    # noinspection PyPropertyDefinition
+    # noinspection PyTypeChecker
+    spinnerValues = property(fget=None, fset=_setSpinnerValues, fdel=None, doc='Write only property to initialize spinner values')
+
+    def enableControls(self, value: bool):
+        """
+        Enable or disable the spinner controls
+
+        Args:
+            value: `True` to enable, else `False`
+        """
+        if value is True:
+            self._spinner0.Enable()
+            self._spinner1.Enable()
+            if self._firstSpinnerLabel is not None:
+                self._firstSpinnerLabel.Enable()
+            if self._secondSpinnerLabel is not None:
+                self._secondSpinnerLabel.Enable()
+        else:
+            self._spinner0.Disable()
+            self._spinner1.Disable()
+            if self._firstSpinnerLabel is not None:
+                self._firstSpinnerLabel.Disable()
+            if self._secondSpinnerLabel is not None:
+                self._secondSpinnerLabel.Disable()
+
+    def _onSpinnerValueChanged(self, event: CommandEvent):
+
+        eventId:  int = event.GetId()
+
+        if eventId == self._wxSpinner0Id:
+            self._spinnerValues.value0 = self._spinner0.GetValue()
+        elif eventId == self._wxSpinner1Id:
+            self._spinnerValues.value1 = self._spinner1.GetValue()
+        else:
+            self.dscLogger.error(f'Unknown spinner event id: {eventId}')
+
+        self._notifyValueChanged(self._spinnerValues)
+
+    def _notifyValueChanged(self, spinnerValues: SpinnerValues):
+        if self._callback is not None:
+            self._callback(spinnerValues)

codeallyadvanced-3.1.0/src/codeallyadvanced/ui/widgets/MinMaxControl.py

@@ -0,0 +1,57 @@
+
+from logging import Logger
+from logging import getLogger
+
+from dataclasses import dataclass
+
+from wx.lib.sized_controls import SizedPanel
+
+from codeallybasic.MinMax import MinMax
+
+from codeallyadvanced.ui.widgets.DualSpinnerControl import DualSpinnerControl
+from codeallyadvanced.ui.widgets.DualSpinnerControl import DualSpinnerParameters
+from codeallyadvanced.ui.widgets.DualSpinnerControl import SpinnerValues
+from codeallyadvanced.ui.widgets.DualSpinnerControl import ValueChangeCallback
+
+
+@dataclass
+class MinMaxParameters(DualSpinnerParameters):
+    minValue:           int = -1024
+    maxValue:           int = 1024
+    firstSpinnerLabel:  str = 'Min:'
+    secondSpinnerLabel: str = 'Max:'
+
+
+class MinMaxControl(DualSpinnerControl):
+    """
+    A facade around the basic dual spinner control for MinMax values.
+    """
+    def __init__(self, parent: SizedPanel, parameters: MinMaxParameters):
+        """
+
+        Args:
+            parent:     The parent window
+            parameters: Configuration parameters for the min/max control
+        """
+        self.logger:                 Logger              = getLogger(__name__)
+        self._valuesChangedCallback: ValueChangeCallback = parameters.valueChangedCallback
+        self._minMax:                MinMax              = MinMax()
+
+        super().__init__(parent=parent, parameters=parameters)
+
+    def _setMinMax(self, newValue: MinMax):
+        self._minMax = newValue
+        self.spinnerValues = SpinnerValues(value0=newValue.minValue, value1=newValue.maxValue)
+
+    # noinspection PyPropertyDefinition
+    # noinspection PyTypeChecker
+    minMax = property(fget=None, fset=_setMinMax, fdel=None, doc='Write only property to set values')
+
+    def _notifyValueChanged(self, spinnerValues: SpinnerValues):
+
+        self.logger.info(f'{spinnerValues}')
+        self._minMax.minValue = spinnerValues.value0
+        self._minMax.maxValue = spinnerValues.value1
+
+        if self._valuesChangedCallback is not None:
+            self._valuesChangedCallback(self._minMax)