scustomtkinter 0.2.1__py3-none-any.whl

scustomtkinter_pygubu/sCTkProgressBarbo.py

@@ -0,0 +1,45 @@
+#!/usr/bin/python3
+"""
+sCTkProgressBar.
+
+derived from progressBar
+
+UI source file: sCTkProgressBar.ui
+"""
+import tkinter as tk
+import tkinter.ttk as ttk
+from customtkinter import CTkProgressBar
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+)
+
+from pygubu.plugins.customtkinter.widgets import CTkProgressBarBO
+from scustomtkinter.sctk_progress_bar import sCTkProgressBar
+
+
+#
+# Builder definition section
+#
+widget_namespace = "scustomtkinter.sctk_progress_bar"
+widget_classname = "sCTkProgressBar"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkProgressBarBO(CTkProgressBarBO):
+    class_ = sCTkProgressBar
+
+    def code_imports(self):
+        # should return an iterable of (module, classname/function) to import
+        # or None
+        imports = [(widget_namespace, widget_classname)]
+        imports.extend(self.code_extra_imports())
+        return imports
+
+
+builder_id = f"{builder_namespace}.{widget_classname}"
+register_widget(
+    builder_id, sCTkProgressBarBO, widget_classname, ("ttk", section_name)
+)
+

scustomtkinter_pygubu/sCTkRadioButtonbo.py

@@ -0,0 +1,45 @@
+#!/usr/bin/python3
+"""
+sCTkRadioButton
+
+derived from radioButton
+
+UI source file: sCTkRadioButton.ui
+"""
+import tkinter as tk
+import tkinter.ttk as ttk
+from customtkinter import CTkRadioButton
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+)
+
+from pygubu.plugins.customtkinter.widgets import CTkRadioButtonBO
+from scustomtkinter.sctk_radiobutton import sCTkRadioButton
+
+
+#
+# Builder definition section
+#
+widget_namespace = "scustomtkinter.sctk_radiobutton"
+widget_classname = "sCTkRadioButton"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkRadioButtonBO(CTkRadioButtonBO):
+    class_ = sCTkRadioButton
+
+    def code_imports(self):
+        # should return an iterable of (module, classname/function) to import
+        # or None
+        imports = [(widget_namespace, widget_classname)]
+        imports.extend(self.code_extra_imports())
+        return imports
+
+
+builder_id = f"{builder_namespace}.{widget_classname}"
+register_widget(
+    builder_id, sCTkRadioButtonBO, widget_classname, ("ttk", section_name)
+)
+

scustomtkinter_pygubu/sCTkSMeterBarbo.py

@@ -0,0 +1,153 @@
+#!/usr/bin/python3
+"""
+sCTkSMeterBar
+
+Pygubu Builder Object for a bar style s-meter, pwr and swr.
+"""
+import ast
+import pygubu
+
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+    register_custom_property
+)
+
+# Import the native custom class
+from scustomtkinter.themeable_widget import parse_font_property
+from scustomtkinter.sctk_smeter_bar import sCTkSMeterBar
+
+#
+# Builder definition section
+#
+widget_namespace = "scustomtkinter.sctk_smeter_bar"
+widget_classname = "sCTkSMeterBar"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkSMeterBarBO(BuilderObject):
+    class_ = sCTkSMeterBar
+
+    # Expose custom compound parameters alongside theme state configurations
+    OPTIONS_CUSTOM = ("width", "height", "fg_color", "swr_max_value", "swr_visible", "pwr_visible", "hide_lower_row", "hide_sig_row", "font", "scale_font")
+
+    # NOT CTkFrameBO.properties.
+    #
+    # Folding them in was tried and taken back out. The meter draws on a canvas
+    # that covers the whole widget, so the frame underneath is never visible:
+    # border_color, border_width and corner_radius appeared in the inspector
+    # and did nothing at all. A property that cannot work is worse than an
+    # absent one.
+    #
+    # fg_color IS listed above, because the widget paints the CANVAS with it --
+    # see sCTkSMeterBar.configure(). It was reaching sCTkSMeter and not this
+    # widget before, inherited from somewhere rather than declared, so the pair
+    # disagreed about a property they both support.
+    #
+    # corner_radius is the real loss: rounding the meter would mean rounding
+    # the canvas, which Tk cannot do to a canvas widget. It would have to be
+    # drawn -- a rounded rectangle filling the canvas in the parent's colour,
+    # masking the corners. Possible, not free.
+    properties = OPTIONS_CUSTOM
+
+    def _process_property_value(self, pname, value):
+        if pname in ("font", "scale_font"):
+            # Shared parser: Pygubu's fontentry emits a Tk font STRING, and
+            # "{}" for "no style selected" -- passed through, that reaches a
+            # canvas item as TclError: unknown font style "".
+            return parse_font_property(value)
+        if pname in ("width", "height"):
+            return int(value)
+        elif pname == "swr_max_value":
+            return float(value)
+        elif pname in ("swr_visible", "pwr_visible", "hide_lower_row", "hide_sig_row"):
+            if value == "True":
+                return True
+            else:
+                return False
+
+        return super()._process_property_value(pname, value)
+
+
+# Register the widget into Pygubu's parsing engine
+builder_id = f"{builder_namespace}.{widget_classname}"
+
+register_widget(builder_id, sCTkSMeterBarBO, 'sCTkSMeterBar', ("ttk", section_name))
+
+
+
+# Register custom attribute fields to display inside the Designer properties panel
+
+register_custom_property(
+    builder_id,
+    "width",
+    "naturalnumber",
+    help="Set total width in pixels of the meter"
+)
+
+register_custom_property(
+    builder_id,
+    "height",
+    "naturalnumber",
+    help="Set height in pixels of the meter"
+)
+
+
+register_custom_property(
+    builder_id,
+    "swr_max_value",
+    "realnumber",
+    help="largest value for signal on scale"
+)
+
+register_custom_property(
+    builder_id,
+    "swr_visible",
+    "choice",values=("True","False"),
+    default_value="True",
+    help="Controls the visability of the SWR meter"
+)
+
+register_custom_property(
+    builder_id,
+    "pwr_visible",
+    "choice",values=("True","False"),
+    default_value="True",
+    help="Controls the visability of the SWR meter"
+)
+
+
+register_custom_property(
+    builder_id,
+    "hide_lower_row",
+    "choice",values=("True","False"),
+    default_value="False",
+    help="Hides the PWR/SWR if True"
+)
+
+register_custom_property(
+    builder_id,
+    "hide_sig_row",
+    "choice", values=("True","False"),
+    default_value="False",
+    help="Hides the S row, leaving SWR and PWR. The mirror of hide_lower_row: "
+         "the two together let one meter be split across two panels -- signal "
+         "under the receive frequency, power under the transmit one."
+)
+
+register_custom_property(
+    builder_id, "font", "fontentry",
+    help='Font for the captions -- SIGNAL, SIG, SWR and PWR. Blank uses the theme font.'
+)
+register_custom_property(
+    builder_id, "scale_font", "fontentry",
+    help='Font for the scale tick labels. Blank uses the theme scale_font. Larger values can overlap on a narrow meter.'
+)
+
+register_custom_property(
+    builder_id, "fg_color", "colorentry",
+    help="Background the meter is drawn on. This paints the CANVAS, not the "
+         "frame behind it -- the canvas covers the whole widget. Blank uses "
+         "the theme's fg_color."
+)

scustomtkinter_pygubu/sCTkSMeterbo.py

@@ -0,0 +1,101 @@
+#!/usr/bin/python3
+"""
+sCTkSMeter.py
+
+Pygubu Builder Object for a S Meter.
+"""
+import ast
+import pygubu
+
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+    register_custom_property
+)
+
+# Import the native custom class
+from scustomtkinter.themeable_widget import parse_font_property
+from scustomtkinter.sctk_smeter import sCTkSMeter
+
+
+#
+# Builder definition section
+#
+widget_namespace = "scustomtkinter.sctk_smeter"
+widget_classname = "sCTkSMeter"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkSMeterBO(BuilderObject):
+    class_ = sCTkSMeter
+
+    # Expose custom compound parameters alongside theme state configurations
+    OPTIONS_CUSTOM = ("width", "height", "fg_color", "font", "scale_font")
+
+    # NOT CTkFrameBO.properties.
+    #
+    # Folding them in was tried and taken back out. The meter draws on a canvas
+    # that covers the whole widget, so the frame underneath is never visible:
+    # border_color, border_width and corner_radius appeared in the inspector
+    # and did nothing at all. A property that cannot work is worse than an
+    # absent one.
+    #
+    # fg_color IS listed, because the widget paints the canvas with it -- see
+    # sCTkSMeter.configure(). It was reaching only one of the two meters
+    # before, inherited from somewhere rather than declared, so the pair
+    # disagreed about a property they both support.
+    #
+    # corner_radius is the real loss: rounding the meter would mean rounding
+    # the canvas, which Tk cannot do to a canvas widget. It would have to be
+    # drawn -- a rounded rectangle filling the canvas in the parent's colour,
+    # masking the corners. Possible, not free.
+    properties = OPTIONS_CUSTOM
+
+    def _process_property_value(self, pname, value):
+        if pname in ("font", "scale_font"):
+            # Shared parser: Pygubu's fontentry emits a Tk font STRING, and
+            # "{}" for "no style selected" -- passed through, that reaches a
+            # canvas item as TclError: unknown font style "".
+            return parse_font_property(value)
+        if pname in ("width", "height"):
+            return int(value)
+        return super()._process_property_value(pname, value)
+
+
+# Register the widget into Pygubu's parsing engine
+builder_id = f"{builder_namespace}.{widget_classname}"
+
+register_widget(builder_id, sCTkSMeterBO, 'sCTkSMeter', ("ttk", section_name))
+
+
+
+# Register custom attribute fields to display inside the Designer properties panel
+
+register_custom_property(
+    builder_id,
+    "width",
+    "naturalnumber",
+    help="Set total width in pixels of the meter"
+)
+
+register_custom_property(
+    builder_id,
+    "height",
+    "naturalnumber",
+    help="Set height in pixels of the meter"
+)
+
+register_custom_property(
+    builder_id, "font", "fontentry",
+    help='Font for the captions -- SIGNAL, SIG, SWR and PWR. Blank uses the theme font.'
+)
+register_custom_property(
+    builder_id, "scale_font", "fontentry",
+    help='Font for the scale tick labels. Blank uses the theme scale_font. Larger values can overlap on a narrow meter.'
+)
+
+register_custom_property(
+    builder_id, "fg_color", "colorentry",
+    help="Background the meter is drawn on. This paints the CANVAS, not the frame behind it -- the canvas covers the whole widget. Blank uses the theme's fg_color."
+)

scustomtkinter_pygubu/sCTkScrollableFramebo.py

@@ -0,0 +1,66 @@
+#!/usr/bin/python3
+"""
+sCTkScrollableFrame
+
+subclass of ScrollableFrame tuned for this ux
+
+UI source file: sCTkScrollableFrame.ui
+"""
+import tkinter as tk
+import tkinter.ttk as ttk
+from customtkinter import CTkScrollableFrame
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+    register_custom_property
+)
+
+from pygubu.plugins.customtkinter import nsctk
+from pygubu.plugins.customtkinter.scrollableframe import CTkScrollableFrameBO
+from pygubu.api.v1 import copy_custom_property
+
+from scustomtkinter.sctk_scrollable_frame import sCTkScrollableFrame
+
+
+#
+# Builder definition section
+#
+widget_namespace = "scustomtkinter.sctk_scrollable_frame"
+widget_classname = "sCTkScrollableFrame"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+container = True
+# CTkScrollableFrame does some weird things
+# with layout so disabled container layout here on purpose.
+container_layout = False
+
+
+class sCTkScrollableFrameBO(CTkScrollableFrameBO):
+    class_ = sCTkScrollableFrame
+
+    OPTIONS_CUSTOM = ('state',)
+    properties = CTkScrollableFrameBO.properties + OPTIONS_CUSTOM
+
+    OPTIONS_CUSTOM_DEFAULTS = {
+        'state': 'normal'
+    }
+
+    def code_imports(self):
+        # should return an iterable of (module, classname/function) to import
+        # or None
+        imports = [(widget_namespace, widget_classname)]
+        imports.extend(self.code_extra_imports())
+        return imports
+
+builder_id = f"{builder_namespace}.{widget_classname}"
+register_widget(
+    builder_id, sCTkScrollableFrameBO, widget_classname, ("ttk", section_name)
+)
+
+
+# -----------------------------------------------------------------
+# EXPOSE CUSTOM 'STATE' CHANNELS INSIDE PYGUBU DESIGNER PANEL
+# -----------------------------------------------------------------
+# 1. Define the UI element type mapping definitions
+register_custom_property(builder_id,"state", "choice", values=("normal", "disabled"))

scustomtkinter_pygubu/sCTkScrollbarbo.py

@@ -0,0 +1,48 @@
+#!/usr/bin/python3
+"""
+sCTkScrollbar
+
+scrollbar
+
+UI source file: sCTkScrollbar.ui
+"""
+import tkinter as tk
+import tkinter.ttk as ttk
+from customtkinter import CTkScrollbar
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+)
+
+from pygubu.plugins.customtkinter import nsctk
+from pygubu.plugins.customtkinter.widgets import CTkScrollbarBO
+from pygubu.api.v1 import copy_custom_property
+
+from scustomtkinter.sctk_scrollbar import sCTkScrollbar
+
+
+#
+# Builder definition section
+#
+widget_namespace = "scustomtkinter.sctk_scrollbar"
+widget_classname = "sCTkScrollbar"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkScrollbarBO(CTkScrollbarBO):
+    class_ = sCTkScrollbar
+
+    def code_imports(self):
+        # should return an iterable of (module, classname/function) to import
+        # or None
+        imports = [(widget_namespace, widget_classname)]
+        imports.extend(self.code_extra_imports())
+        return imports
+
+
+builder_id = f"{builder_namespace}.{widget_classname}"
+register_widget(
+    builder_id, sCTkScrollbarBO, widget_classname, ("ttk", section_name)
+)
+

scustomtkinter_pygubu/sCTkSegmentedButtonbo.py

@@ -0,0 +1,47 @@
+#!/usr/bin/python3
+"""
+sCTkSegmentedButton
+
+segmentedButton
+
+UI source file: sCTkSegmentedButton.ui
+"""
+import tkinter as tk
+import tkinter.ttk as ttk
+from customtkinter import CTkSegmentedButton
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+)
+
+from pygubu.plugins.customtkinter import nsctk
+from pygubu.plugins.customtkinter.widgets import CTkSegmentedButtonBO
+from pygubu.api.v1 import copy_custom_property
+
+from scustomtkinter.sctk_segmentedbutton import sCTkSegmentedButton
+
+
+#
+# Builder definition section
+#
+widget_namespace = "scustomtkinter.sctk_segmentedbutton"
+widget_classname = "sCTkSegmentedButton"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkSegmentedButtonBO(CTkSegmentedButtonBO):
+    class_ = sCTkSegmentedButton
+
+    def code_imports(self):
+        # should return an iterable of (module, classname/function) to import
+        # or None
+        imports = [(widget_namespace, widget_classname)]
+        imports.extend(self.code_extra_imports())
+        return imports
+
+
+builder_id = f"{builder_namespace}.{widget_classname}"
+register_widget(
+    builder_id, sCTkSegmentedButtonBO, widget_classname, ("ttk", section_name)
+)

scustomtkinter_pygubu/sCTkSelectorbo.py

@@ -0,0 +1,167 @@
+#!/usr/bin/python3
+"""
+sCTkSelector Builder Object
+"""
+import pygubu
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+    register_custom_property
+)
+from scustomtkinter.sctk_selector import sCTkSelector
+from scustomtkinter.themeable_widget import parse_list_property
+from pygubu.plugins.customtkinter.widgets import CTkFrameBO
+
+widget_namespace = "scustomtkinter.sctk_selector"
+widget_classname = "sCTkSelector"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkSelectorBO(BuilderObject):
+    class_ = sCTkSelector
+
+    # OPTIONS_STANDARD = ('height', 'width')
+    # 1. Append 'state' to your custom options tuple array
+    # grid_propagate is deliberately absent. pack_propagate() and
+    # grid_propagate() control whether a container resizes to fit its CHILDREN,
+    # and which applies depends on how those children are managed -- this
+    # widget packs its own, so grid_propagate could never have an effect. It
+    # was offered anyway, which made it look like a knob that did nothing.
+    OPTIONS_CUSTOM = ('items', 'multiple_choices', 'pack_propagate', 'state')
+    properties = CTkFrameBO.properties + OPTIONS_CUSTOM
+
+    OPTIONS_CUSTOM_DEFAULTS = {
+        'multiple_choices': 'True',
+        'items': '["Item 1", "Item 2"]',
+        'pack_propagate': 'True',
+        'state': 'normal'
+    }
+
+    # NOT a container. sCTkSelector builds and manages its own checkbox list
+    # from the `items` property, laying them out inside its internal
+    # checkboxes_frame. A child dropped in from the Designer would land in an
+    # unmanaged position and be destroyed by the next rebuild -- which happens
+    # whenever `items` changes. It inherits sCTkFrame and composes an
+    # sCTkScrollableFrame internally, which is what made it LOOK like a
+    # container to the Designer.
+    container = False
+    container_layout = False
+
+    def realize(self, parent, extra_init_args: dict = None):
+        if extra_init_args is None:
+            extra_init_args = {}
+
+        # Shared parser: accepts the quoted-list form, a bare comma-separated
+        # string, or a real list -- see parse_list_property(). The inspector
+        # default is the quoted-list form, which is what Pygubu Designer users
+        # expect and is the only one of the two text forms that can express a
+        # value containing a comma.
+        items_val = self.wmeta.properties.get('items', '["Item 1", "Item 2"]')
+        items_arg = parse_list_property(items_val, default=["Item 1", "Item 2"])
+
+        mult_choice = self.wmeta.properties.get('multiple_choices', 'True')
+        mult_choice_arg = str(mult_choice).lower() in ['true', '1', 'yes']
+
+        p_prop = self.wmeta.properties.get('pack_propagate', 'True')
+        p_prop_arg = str(p_prop).lower() in ['true', '1', 'yes']
+
+        # 2. Extract designer state choice
+        state_arg = self.wmeta.properties.get('state', 'normal')
+
+        init_args = {
+            'items': items_arg,
+            'multiple_choices': mult_choice_arg,
+            'pack_propagate': p_prop_arg,
+            'state': state_arg
+        }
+
+        for prop in self.OPTIONS_CUSTOM:
+            extra_init_args.pop(prop, None)
+
+        init_args.update(extra_init_args)
+        real_master = parent.widget if hasattr(parent, 'widget') else parent
+        self.widget = self.class_(real_master, **init_args)
+        return self.widget
+
+    def _set_property(self, target_widget, pname, value):
+        """
+        Rebuilds the widget after a structural change.
+
+        Some properties cannot be expressed by configuring the existing
+        widget. A size only takes effect once Tk runs a geometry pass, and
+        turning pack_propagate back on merely tells it what to do at the next
+        one -- in an application the next event triggers that invisibly, but in
+        the Designer nothing else happens, so clearing a height appeared to do
+        nothing until an unrelated edit forced a repaint. `items` rebuilds the
+        checkbox list outright.
+
+        recreate_widget() is what the Designer itself does when you add or
+        delete a widget, which is why doing that by hand made the change
+        appear.
+
+        This hangs off _set_property, NOT set_property. The Designer edits a
+        property through the former -- confirmed by tracing, and it is the one
+        named in its own error messages ("Failed to set property 'x' on class
+        ..."). set_property is never called, so sCTkTableviewBO's identical
+        rebuild, which hangs off that, has probably never fired either.
+
+        Deliberately NOT used for colours: rebuilding on every keystroke in a
+        colour field would be unpleasant, and a colour needs no rebuild.
+        """
+        super()._set_property(target_widget, pname, value)
+
+        if pname in ("width", "height", "items", "pack_propagate"):
+            if hasattr(self, "builder") and hasattr(self.builder, "recreate_widget"):
+                try:
+                    self.builder.recreate_widget(self)
+                except Exception:
+                    # A widget not yet realized, or a builder that does not
+                    # offer the call. Losing the rebuild costs a stale canvas,
+                    # not correctness -- the .ui data is already updated.
+                    pass
+
+    def _code_set_property(self, targetid, pname, value, code_bag):
+        """
+        The low-level code generation interception layer.
+        Ensures lists and booleans write as raw tokens, while text properties
+        like 'state' write out with proper Python string quotes.
+        """
+        # 1. Handle properties that MUST be generated as raw unquoted Python code/tokens
+        if pname in ('items', 'multiple_choices', 'pack_propagate'):
+            clean_string = str(value).strip("'\"")
+            code_bag[pname] = clean_string
+
+        # 2. FIXED: Handle properties that MUST keep their string quote wrappers
+        elif pname == 'state':
+            # Force it to explicitly keep single quotes, preventing NameErrors at runtime
+            clean_string = str(value).strip("'\"")
+            code_bag[pname] = f"'{clean_string}'"
+
+        else:
+            super()._code_set_property(targetid, pname, value, code_bag)
+
+
+builder_id = f"{builder_namespace}.{widget_classname}"
+
+register_widget(
+    builder_id, sCTkSelectorBO, widget_classname, ("ttk", section_name)
+)
+
+register_custom_property(
+    builder_id,
+    'items',
+    'entry',
+    help='Preferred: ["A", "B", "C"]. Bare comma-separated (A, B, C) also works, but cannot contain a comma inside a value.'
+)
+
+register_custom_property(builder_id, 'multiple_choices', 'choice', values=('True', 'False'))
+# 4. Register the new UI type as a dropdown option selection field
+register_custom_property(builder_id, 'state', 'choice', values=('normal', 'disabled'))
+
+# 2. Register custom UI types as standard True/False dropdown pickers
+register_custom_property(
+    builder_id, 'pack_propagate', 'choice', values=('True', 'False'),
+    help="False stops the widget resizing to fit its checkboxes, so an "
+         "explicit width and height are honoured."
+)