bootstack 0.1.3__tar.gz → 0.1.5__tar.gz

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.3
-Summary: From idea to a shipped desktop app, fast — a declarative, reactive, batteries-included Python UI framework with 60+ widgets, semantic theming, and built-in packaging.
+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
 Project-URL: Homepage, https://github.com/israel-dryer/bootstack
@@ -64,11 +64,12 @@ Dynamic: license-file
 
 > Full documentation is at **[bootstack.org](https://bootstack.org)**.
 
-### From idea to a shipped desktop app — fast.
+### Desktop apps in pure Python — Tk underneath, none of the boilerplate.
 
-bootstack gives engineers, data scientists, and hobbyists everything to build a
-polished desktop interface and package it into a standalone executable —
-declarative, reactive, and batteries-included, all in pure Python.
+bootstack is built on Tk, so the install is light, there's no Qt license, and
+your app ships as a small standalone executable. But you'll never write a
+`StringVar` or call `.pack()` — the API is its own. 60+ widgets, reactive state,
+and a CLI that scaffolds and packages the whole thing.
 
 <p align="center">
 <picture>

{bootstack-0.1.3 → bootstack-0.1.5}/README.md

@@ -11,11 +11,12 @@
 
 > Full documentation is at **[bootstack.org](https://bootstack.org)**.
 
-### From idea to a shipped desktop app — fast.
+### Desktop apps in pure Python — Tk underneath, none of the boilerplate.
 
-bootstack gives engineers, data scientists, and hobbyists everything to build a
-polished desktop interface and package it into a standalone executable —
-declarative, reactive, and batteries-included, all in pure Python.
+bootstack is built on Tk, so the install is light, there's no Qt license, and
+your app ships as a small standalone executable. But you'll never write a
+`StringVar` or call `.pack()` — the API is its own. 60+ widgets, reactive state,
+and a CLI that scaffolds and packages the whole thing.
 
 <p align="center">
 <picture>

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

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.1.3"
-description = "From idea to a shipped desktop app, fast — a declarative, reactive, batteries-included Python UI framework with 60+ widgets, semantic theming, and built-in packaging."
+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"
 license = "MIT"
@@ -114,7 +114,7 @@ where = ["src"]
 ]
 
 [tool.bumpversion]
-current_version = "0.1.3"
+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.3 → 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.3 → 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.3 → bootstack-0.1.5}/src/bootstack/widgets/select.py

@@ -9,6 +9,7 @@ from bootstack.widgets._core.events import resolve_event, register_widget_events
 from bootstack.widgets._core.options import record_to_dict
 from bootstack.events import ChangeEvent, Subscription
 from bootstack.streams import Stream
+from bootstack.validation import RuleType
 from bootstack.widgets.textfield import _INNER_ENTRY_SEQUENCES
 from bootstack.widgets.types import AccentToken, Event, Option, OptionDict, WidgetDensity
 
@@ -140,6 +141,32 @@ class Select(PublicWidgetBase):
         self._internal = _InternalSelectBox(tk_master, **internal_kwargs)
         self._attach_to_parent(layout_kw)
 
+    # ----- Validation -----
+
+    def add_validation_rule(self, rule_type: RuleType, **kwargs: Any) -> None:
+        """Add a validation rule to the field.
+
+        Rules run automatically on blur or key events depending on the rule
+        type, or manually via `validate()`. Multiple rules can be added;
+        they are evaluated in order and stop at the first failure.
+
+        Args:
+            rule_type: The kind of validation rule to apply — `'required'`,
+                `'stringLength'`, `'pattern'`, `'email'`, `'compare'`, or
+                `'custom'`.
+            **kwargs: Rule-specific options:
+
+                - `message` *(all rules)* — override the default error message.
+                - `trigger` *(all rules)* — when to run: `'always'` (key and
+                  blur), `'key'`, `'blur'`, or `'manual'`. Each rule type has
+                  its own sensible default.
+                - `min`, `max` *(stringLength)* — minimum/maximum character count.
+                - `pattern` *(pattern)* — regex string the value must match.
+                - `other_field` *(compare)* — field whose value must match.
+                - `func` *(custom)* — callable `(value) -> bool`.
+        """
+        self._internal.add_validation_rule(rule_type, **kwargs)
+
     # ----- Event routing -----
 
     def _entry_widget(self) -> tkinter.Misc:

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.3
-Summary: From idea to a shipped desktop app, fast — a declarative, reactive, batteries-included Python UI framework with 60+ widgets, semantic theming, and built-in packaging.
+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
 Project-URL: Homepage, https://github.com/israel-dryer/bootstack
@@ -64,11 +64,12 @@ Dynamic: license-file
 
 > Full documentation is at **[bootstack.org](https://bootstack.org)**.
 
-### From idea to a shipped desktop app — fast.
+### Desktop apps in pure Python — Tk underneath, none of the boilerplate.
 
-bootstack gives engineers, data scientists, and hobbyists everything to build a
-polished desktop interface and package it into a standalone executable —
-declarative, reactive, and batteries-included, all in pure Python.
+bootstack is built on Tk, so the install is light, there's no Qt license, and
+your app ships as a small standalone executable. But you'll never write a
+`StringVar` or call `.pack()` — the API is its own. 60+ widgets, reactive state,
+and a CLI that scaffolds and packages the whole thing.
 
 <p align="center">
 <picture>