bootstack 0.1.4__tar.gz → 0.1.5__tar.gz

{bootstack-0.1.4/src/bootstack.egg-info → bootstack-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.4
+Version: 0.1.5
 Summary: Build desktop GUI apps in pure Python and ship them as a standalone executable — built on Tk, no Tkinter boilerplate.
 Author-email: Israel Dryer <israel.dryer@gmail.com>
 License-Expression: MIT

{bootstack-0.1.4 → bootstack-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.1.4"
+version = "0.1.5"
 description = "Build desktop GUI apps in pure Python and ship them as a standalone executable — built on Tk, no Tkinter boilerplate."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -114,7 +114,7 @@ where = ["src"]
 ]
 
 [tool.bumpversion]
-current_version = "0.1.4"
+current_version = "0.1.5"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)((?P<pre>a|b|rc)(?P<pre_n>\\d+))?"
 serialize = [
     "{major}.{minor}.{patch}{pre}{pre_n}",

{bootstack-0.1.4 → bootstack-0.1.5}/src/bootstack/widgets/_impl/primitives/checkbutton.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from tkinter import ttk
+from tkinter import StringVar, ttk
 from typing import Any, Callable, Literal, TYPE_CHECKING
 
 from typing_extensions import Unpack
@@ -94,9 +94,21 @@ class CheckButton(LocalizationMixin, SignalMixin, TextSignalMixin, IconMixin, TT
         signal_provided = 'signal' in kwargs
         variable_provided = 'variable' in kwargs
         initial_value = kwargs.pop('value', None)
+        # Only non-bool on/off values need a StringVar. A BooleanVar (the type
+        # inferred from the ttk class) coerces the value to True/False, which
+        # loses a string or other custom `onvalue`/`offvalue`; a StringVar holds
+        # it verbatim (mirrors RadioGroup / ToggleGroup, which track with a
+        # StringVar). For the default bool control we keep the BooleanVar so its
+        # reactive `signal` stays boolean — the common case is unchanged.
+        custom_values = any(
+            not isinstance(kwargs.get(k, True), bool) for k in ('onvalue', 'offvalue')
+        )
+        injected_variable = not signal_provided and not variable_provided and custom_values
+        if injected_variable:
+            kwargs['variable'] = StringVar(master=master)
         kwargs.update(style_options=self._capture_style_options(['icon_only', 'icon', 'on_icon', 'off_icon', 'show_indicator', 'anchor'], kwargs))
         super().__init__(master, **kwargs)
-        if initial_value is not None and not signal_provided and not variable_provided:
+        if initial_value is not None and not signal_provided and injected_variable:
             self.variable.set(initial_value)
 
     def get(self) -> Any:

{bootstack-0.1.4 → bootstack-0.1.5}/src/bootstack/widgets/boolean_controls.py

@@ -81,29 +81,14 @@ class _BooleanControlBase(PublicWidgetBase):
 
         self._internal = self._internal_class(tk_master, **internal_kwargs)
 
-        # Seed initial value when no signal was passed.
-        # tristate=False: default to unchecked_value so the box never shows the
-        # indeterminate dash unexpectedly. tristate=True: leave unseeded so the
-        # initial state is None (indeterminate) unless value= was explicitly given.
-        if signal is None:
-            if value is not None:
-                self._internal.set(value)
-            elif not _tristate:
-                self._internal.set(unchecked_value)
-
-        # Track the previous value so on_change can report it. The control may be
-        # tristate (checked / unchecked / indeterminate), so prev cannot be derived
-        # from the new value alone — and the command fires after Tk updates the var.
-        self._prev_value = self._internal.get()
-
         # Wire command → virtual events so on_change() / on_check() subscriptions work.
         def _command():
-            v = self._internal.get()
+            v = self.value
             prev, self._prev_value = self._prev_value, v
             self._internal.event_generate(
                 "<<Change>>", data=ChangeEvent(value=v, prev_value=prev)
             )
-            if v == self._checked_value:
+            if self._internal.instate(("selected",)):
                 self._internal.event_generate("<<ToggleOn>>")
             else:
                 self._internal.event_generate("<<ToggleOff>>")
@@ -111,8 +96,51 @@ class _BooleanControlBase(PublicWidgetBase):
                 _ctor_callback()
 
         self._internal.configure(command=_command)
+
+        # Seed the initial state when no signal was passed. tristate + no value
+        # starts indeterminate (the documented behavior); otherwise start from
+        # the given value, defaulting to unchecked. This must run AFTER
+        # configure(command=...), which resets the ttk state (clearing an
+        # indeterminate `alternate` flag set earlier).
+        if signal is None:
+            if value is not None:
+                self._apply_value(value)
+            elif _tristate:
+                self._apply_value(None)
+            else:
+                self._apply_value(unchecked_value)
+
+        # Track the previous value so on_change can report it. The control may be
+        # tristate (checked / unchecked / indeterminate), so prev cannot be derived
+        # from the new value alone — and the command fires after Tk updates state.
+        self._prev_value = self.value
+
         self._attach_to_parent(layout_kw)
 
+    def _apply_value(self, v: Any) -> None:
+        """Drive the internal control to represent `v`.
+
+        Maps the public value onto the ttk widget's on/off values and the
+        indeterminate (`alternate`) state. A variable write clears `alternate`,
+        so indeterminate is set by writing the off value first and then flagging
+        the state.
+        """
+        on = self._internal.cget("onvalue")
+        off = self._internal.cget("offvalue")
+        if v is None and self._tristate:
+            # Writing the var clears `alternate`, so set the off value first and
+            # then flag the indeterminate state.
+            self._internal.set(off)
+            self._internal.state(("alternate",))
+        elif v == self._checked_value:
+            self._internal.set(on)
+        elif v == self._unchecked_value or v is None:
+            self._internal.set(off)
+        else:
+            # A value that matches neither on nor off — pass it through so the
+            # widget reflects it (best effort for custom values).
+            self._internal.set(v)
+
     # ----- Properties -----
 
     @property
@@ -123,25 +151,24 @@ class _BooleanControlBase(PublicWidgetBase):
         unchecked, or `None` when in the indeterminate state (only possible
         when `tristate=True`).
         """
-        v = self._internal.get()
-        if v == self._checked_value:
+        if self._tristate and self._internal.instate(("alternate",)):
+            return None
+        if self._internal.instate(("selected",)):
             return self._checked_value
-        if v == self._unchecked_value:
-            return self._unchecked_value
-        return None
+        return self._unchecked_value
 
     @value.setter
     def value(self, v: Any) -> None:
-        self._internal.set(v)
+        self._apply_value(v)
 
     @property
     def checked(self) -> bool:
         """Whether the control is in the checked/on state."""
-        return self._internal.get() == self._checked_value
+        return bool(self._internal.instate(("selected",)))
 
     @checked.setter
     def checked(self, v: bool) -> None:
-        self._internal.set(self._checked_value if v else self._internal.cget("offvalue"))
+        self._apply_value(self._checked_value if v else self._unchecked_value)
 
     @property
     def signal(self) -> "Signal | None":

{bootstack-0.1.4 → bootstack-0.1.5/src/bootstack.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.4
+Version: 0.1.5
 Summary: Build desktop GUI apps in pure Python and ship them as a standalone executable — built on Tk, no Tkinter boilerplate.
 Author-email: Israel Dryer <israel.dryer@gmail.com>
 License-Expression: MIT