bootstack 0.1.0a7__tar.gz → 0.1.0a9__tar.gz

{bootstack-0.1.0a7/src/bootstack.egg-info → bootstack-0.1.0a9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.0a7
+Version: 0.1.0a9
 Summary: A full UI framework for Python desktop apps built on tkinter — rich widgets, theming, and application structure out of the box.
 Author-email: Israel Dryer <israel.dryer@gmail.com>
 License-Expression: MIT

{bootstack-0.1.0a7 → bootstack-0.1.0a9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.1.0a7"
+version = "0.1.0a9"
 description = "A full UI framework for Python desktop apps built on tkinter — rich widgets, theming, and application structure out of the box."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -82,7 +82,7 @@ where = ["src"]
 ]
 
 [tool.bumpversion]
-current_version = "0.1.0a7"
+current_version = "0.1.0a9"
 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.0a7 → bootstack-0.1.0a9}/src/bootstack/datasource/README.md

@@ -333,13 +333,18 @@ class AuditedDataSource(BaseDataSource):
 - `delete_record(record_id)` - Delete record by ID
 
 #### Selection Management
+- `is_selected(record_id)` - Check whether a record is selected
 - `select_record(record_id)` - Mark record as selected
-- `unselect_record(record_id)` - Unmark record
+- `deselect_record(record_id)` - Unmark record
 - `select_all(current_page_only=False)` - Select all/page records
-- `unselect_all(current_page_only=False)` - Unselect all/page records
+- `deselect_all(current_page_only=False)` - Deselect all/page records
 - `get_selected(page=None)` - Get selected records
 - `selected_count()` - Count selected records
 
+#### Lifecycle / reorder
+- `reload()` - Re-read from source (no-op for in-memory)
+- `move_record(record_id, target_index)` - Reorder a record
+
 #### Export
 - `export_to_csv(filepath, include_all=True)` - Export to CSV
 

{bootstack-0.1.0a7 → bootstack-0.1.0a9}/src/bootstack/datasource/base.py

@@ -194,6 +194,18 @@ class BaseDataSource(ABC):
         ...
 
     # Selection Management
+    @abstractmethod
+    def is_selected(self, record_id: Any) -> bool:
+        """Check whether a record is currently selected.
+
+        Args:
+            record_id: Unique identifier of the record
+
+        Returns:
+            True if the record is selected, False otherwise (including missing records)
+        """
+        ...
+
     @abstractmethod
     def select_record(self, record_id: Any) -> bool:
         """Mark record as selected.
@@ -207,14 +219,14 @@ class BaseDataSource(ABC):
         ...
 
     @abstractmethod
-    def unselect_record(self, record_id: Any) -> bool:
+    def deselect_record(self, record_id: Any) -> bool:
         """Mark record as unselected.
 
         Args:
             record_id: Unique identifier of the record
 
         Returns:
-            True if record was unselected, False if not found
+            True if record was deselected, False if not found
         """
         ...
 
@@ -231,14 +243,14 @@ class BaseDataSource(ABC):
         ...
 
     @abstractmethod
-    def unselect_all(self, current_page_only: bool = False) -> int:
-        """Unselect all records (optionally only current page).
+    def deselect_all(self, current_page_only: bool = False) -> int:
+        """Deselect all records (optionally only current page).
 
         Args:
-            current_page_only: If True, unselect only records on current page
+            current_page_only: If True, deselect only records on current page
 
         Returns:
-            Number of records unselected
+            Number of records deselected
         """
         ...
 
@@ -288,6 +300,30 @@ class BaseDataSource(ABC):
         """
         ...
 
+    # Lifecycle / reorder — concrete defaults; subclasses may override
+    def reload(self) -> None:
+        """Re-read data from the underlying source.
+
+        Default is a no-op suitable for in-memory implementations.
+        File- and database-backed sources should override to re-query.
+        """
+        return None
+
+    def move_record(self, record_id: Any, target_index: int) -> bool:
+        """Reorder a record to a new position.
+
+        Default returns False (not supported). Subclasses that maintain
+        an explicit ordering should override.
+
+        Args:
+            record_id: Unique identifier of the record to move
+            target_index: Zero-based destination index (clamped to valid range)
+
+        Returns:
+            True if the record was moved, False if not supported or not found
+        """
+        return False
+
     # ========== SHARED UTILITY METHODS ==========
 
     @staticmethod

{bootstack-0.1.0a7 → bootstack-0.1.0a9}/src/bootstack/datasource/memory_source.py

@@ -108,18 +108,29 @@ class MemoryDataSource(BaseDataSource):
                 r.setdefault("selected", 0)
 
     def _ensure_id(self) -> None:
-        """Ensure all records have unique integer IDs."""
-        used = set()
+        """Ensure all records have unique integer IDs.
+
+        Records whose `id` is already an int and not a duplicate are
+        preserved as-is. Records with missing, non-integer, or duplicate
+        IDs get a freshly-allocated integer ID.
+        """
+        used: set[int] = set()
+        needs_id: list[Dict[str, Any]] = []
         max_id = 0
         for r in self._data:
-            if "id" in r and isinstance(r["id"], int):
-                used.add(r["id"])
-                max_id = max(max_id, r["id"])
-        for r in self._data:
-            if "id" not in r or not isinstance(r["id"], int) or r["id"] in used:
+            rid = r.get("id")
+            if isinstance(rid, int) and rid not in used:
+                used.add(rid)
+                if rid > max_id:
+                    max_id = rid
+            else:
+                needs_id.append(r)
+        for r in needs_id:
+            max_id += 1
+            while max_id in used:
                 max_id += 1
-                r["id"] = max_id
-                used.add(max_id)
+            r["id"] = max_id
+            used.add(max_id)
         self._rebuild_id_index()
 
     @staticmethod
@@ -389,11 +400,18 @@ class MemoryDataSource(BaseDataSource):
         self._rebuild_id_index()
         return True
 
+    def is_selected(self, record_id: Any) -> bool:
+        """Check whether a record is currently selected."""
+        idx = self._id_index.get(record_id)
+        if idx is None:
+            return False
+        return bool(self._data[idx].get("selected", 0))
+
     def select_record(self, record_id: Any) -> bool:
         """Mark record as selected."""
         return self._set_selected_flag(record_id, 1)
 
-    def unselect_record(self, record_id: Any) -> bool:
+    def deselect_record(self, record_id: Any) -> bool:
         """Mark record as unselected."""
         return self._set_selected_flag(record_id, 0)
 
@@ -417,8 +435,8 @@ class MemoryDataSource(BaseDataSource):
                     count += 1
             return count
 
-    def unselect_all(self, current_page_only: bool = False) -> int:
-        """Unselect all records (optionally only current page)."""
+    def deselect_all(self, current_page_only: bool = False) -> int:
+        """Deselect all records (optionally only current page)."""
         self._ensure_selected_column()
         if current_page_only:
             ids = [r["id"] for r in self.get_page()]
@@ -437,6 +455,30 @@ class MemoryDataSource(BaseDataSource):
                     count += 1
             return count
 
+    def move_record(self, record_id: Any, target_index: int) -> bool:
+        """Reorder a record within the in-memory list."""
+        if not self._data:
+            return False
+
+        source_index = self._id_index.get(record_id)
+        if source_index is None:
+            return False
+
+        clamped_target = max(0, min(int(target_index), len(self._data) - 1))
+        if source_index == clamped_target:
+            return False
+
+        record = self._data.pop(source_index)
+        if clamped_target > source_index:
+            clamped_target -= 1
+        self._data.insert(clamped_target, record)
+
+        start = min(source_index, clamped_target)
+        end = max(source_index, clamped_target) + 1
+        for i in range(start, end):
+            self._id_index[self._data[i]["id"]] = i
+        return True
+
     def _set_selected_flag(self, record_id: Any, flag: int) -> bool:
         """Set selection flag for record by ID."""
         self._ensure_selected_column()

{bootstack-0.1.0a7 → bootstack-0.1.0a9}/src/bootstack/datasource/sqlite_source.py

@@ -330,11 +330,23 @@ class SqliteDataSource(BaseDataSource):
 
     # === SELECTION ====
 
+    def is_selected(self, record_id: Any) -> bool:
+        """Check whether a record is currently selected."""
+        if _ROW_SEL not in self._columns:
+            return False
+        row = self.conn.execute(
+            f"SELECT {_ROW_SEL} FROM {self._table} WHERE {_ROW_ID} = ?",
+            (record_id,),
+        ).fetchone()
+        if row is None:
+            return False
+        return bool(row[0])
+
     def select_record(self, record_id: Any) -> bool:
         """Mark record as selected."""
         return self._set_selected_flag(record_id, 1)
 
-    def unselect_record(self, record_id: Any) -> bool:
+    def deselect_record(self, record_id: Any) -> bool:
         """Mark record as unselected."""
         return self._set_selected_flag(record_id, 0)
 
@@ -355,8 +367,8 @@ class SqliteDataSource(BaseDataSource):
                 cur = self.conn.execute(f"UPDATE {self._table} SET {_ROW_SEL} = 1")
                 return cur.rowcount
 
-    def unselect_all(self, current_page_only: bool = False) -> int:
-        """Unselect all records (optionally only current page)."""
+    def deselect_all(self, current_page_only: bool = False) -> int:
+        """Deselect all records (optionally only current page)."""
         self._ensure_selected_column()
         if current_page_only:
             ids = [row[_ROW_ID] for row in self.get_page()]

{bootstack-0.1.0a7 → bootstack-0.1.0a9}/src/bootstack/datasource/types.py

@@ -7,9 +7,10 @@ The DataSourceProtocol provides a unified interface for:
     - Data loading and configuration (set_data, set_filter, set_sort)
     - Pagination (get_page, next_page, prev_page, has_next_page)
     - CRUD operations (create, read, update, delete)
-    - Selection management (select/unselect records)
+    - Selection management (is_selected, select/deselect records)
     - Data export (CSV export)
     - Index-based access (get_page_from_index)
+    - Lifecycle and reorder (reload, move_record)
 
 All datasource implementations should conform to this protocol to ensure
 compatibility with datasource-aware widgets and utilities.
@@ -172,6 +173,17 @@ class DataSourceProtocol(Protocol):
         ...
 
     # ---------- selection ----------
+    def is_selected(self, record_id: Any) -> bool:
+        """Check whether a record is currently selected.
+
+        Args:
+            record_id: Unique identifier of the record
+
+        Returns:
+            True if the record is selected, False otherwise (including missing records)
+        """
+        ...
+
     def select_record(self, record_id: Any) -> bool:
         """Mark record as selected.
 
@@ -183,14 +195,14 @@ class DataSourceProtocol(Protocol):
         """
         ...
 
-    def unselect_record(self, record_id: Any) -> bool:
+    def deselect_record(self, record_id: Any) -> bool:
         """Mark record as unselected.
 
         Args:
             record_id: Unique identifier of the record
 
         Returns:
-            True if record was unselected, False if not found
+            True if record was deselected, False if not found
         """
         ...
 
@@ -205,14 +217,14 @@ class DataSourceProtocol(Protocol):
         """
         ...
 
-    def unselect_all(self, current_page_only: bool = False) -> int:
-        """Unselect all records (optionally only current page).
+    def deselect_all(self, current_page_only: bool = False) -> int:
+        """Deselect all records (optionally only current page).
 
         Args:
-            current_page_only: If True, unselect only records on current page
+            current_page_only: If True, deselect only records on current page
 
         Returns:
-            Number of records unselected
+            Number of records deselected
         """
         ...
 
@@ -235,6 +247,27 @@ class DataSourceProtocol(Protocol):
         """
         ...
 
+    # ---------- lifecycle / reorder ----------
+    def reload(self) -> None:
+        """Re-read data from the underlying source.
+
+        For in-memory implementations this is typically a no-op. For
+        file- or database-backed sources, this re-queries or re-reads.
+        """
+        ...
+
+    def move_record(self, record_id: Any, target_index: int) -> bool:
+        """Reorder a record to a new position.
+
+        Args:
+            record_id: Unique identifier of the record to move
+            target_index: Zero-based destination index (clamped to valid range)
+
+        Returns:
+            True if the record was moved, False if not supported or not found
+        """
+        ...
+
     # ---------- export ----------
     def export_to_csv(self, filepath: str, include_all: bool = True) -> None:
         """Export records to CSV file.

bootstack-0.1.0a9/src/bootstack/style/builders/checkbutton.py

@@ -0,0 +1,125 @@
+"""Checkbutton widget style builders.
+
+This module contains style builders for ttk.Checkbutton widgets and variants.
+"""
+
+from __future__ import annotations
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+from bootstack.style.element import Element, ElementImage
+from bootstack.style.utility import create_transparent_image, recolor_element_image
+from bootstack.style.builders.utils import icon_size, resolve_icon_spec
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TCheckbutton')
+def build_checkbutton_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = 'primary', **options):
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+
+    background = b.color(surface_token)
+    background_hover = b.active(background)
+    foreground = b.on_color(background)
+    foreground_disabled = b.disabled('text', background)
+
+    normal = b.color(accent_token)
+    pressed = b.pressed(normal)
+    hovered = b.active(normal)
+    border = b.border(background)
+    focus = hovered
+    focus_ring = b.focus_ring(normal, background)
+    disabled = b.disabled()
+
+    show_indicator = options.get('show_indicator', True)
+
+    if show_indicator:
+        spacer_img = create_transparent_image(6, 1)
+        b.create_style_element_image(ElementImage(f'{ttk_style}.spacer', spacer_img, sticky="ew"))
+
+        normal_checked_img = recolor_element_image('checkbox_checked', background, normal, background)
+        normal_unchecked_img = recolor_element_image('checkbox_unchecked', background, border, background)
+        normal_indeterminate_img = recolor_element_image('checkbox_indeterminate', background, normal, background)
+
+        hovered_checked_img = recolor_element_image('checkbox_checked', background, hovered, background)
+        hovered_unchecked_img = recolor_element_image('checkbox_unchecked', background_hover, border, background)
+        hovered_indeterminate_img = recolor_element_image('checkbox_indeterminate', background, hovered, background)
+
+        pressed_checked_img = recolor_element_image('checkbox_checked', background, pressed, background)
+        pressed_unchecked_img = recolor_element_image('checkbox_unchecked', background_hover, pressed, background)
+        pressed_indeterminate_img = recolor_element_image('checkbox_indeterminate', background, pressed, background)
+
+        focus_checked_img = recolor_element_image('checkbox_checked', background, focus, focus_ring)
+        focus_unchecked_img = recolor_element_image('checkbox_unchecked', background_hover, focus, focus_ring)
+        focus_indeterminate_img = recolor_element_image('checkbox_indeterminate', background, focus, focus_ring)
+
+        disabled_checked_img = recolor_element_image('checkbox_checked', disabled, foreground_disabled, background)
+        disabled_unchecked_img = recolor_element_image(
+            'checkbox_unchecked', foreground_disabled, foreground_disabled, background)
+        disabled_indeterminate_img = recolor_element_image(
+            'checkbox_indeterminate', disabled, foreground_disabled, background)
+
+        b.create_style_element_image(
+            ElementImage(f'{ttk_style}.indicator', normal_unchecked_img.image, sticky="ns").state_specs(
+                [
+                    # Disabled states
+                    ('disabled alternate !selected', disabled_indeterminate_img.image),
+                    ('disabled selected', disabled_checked_img.image),
+                    ('disabled !selected !alternate', disabled_unchecked_img.image),
+
+                    # Focused states
+                    ('focus alternate !selected', focus_indeterminate_img.image),
+                    ('focus selected', focus_checked_img.image),
+                    ('focus !selected !alternate', focus_unchecked_img.image),
+
+                    # Pressed states
+                    ('pressed alternate !selected', pressed_indeterminate_img.image),
+                    ('pressed selected', pressed_checked_img.image),
+                    ('pressed !selected !alternate', pressed_unchecked_img.image),
+
+                    # Hover states
+                    ('hover alternate !selected', hovered_indeterminate_img.image),
+                    ('hover selected', hovered_checked_img.image),
+                    ('hover !selected !alternate', hovered_unchecked_img.image),
+
+                    # Normal base states
+                    ('alternate !selected', normal_indeterminate_img.image),
+                    ('selected', normal_checked_img.image),
+                    ('!selected !alternate', normal_unchecked_img.image),
+                ]
+            ))
+
+    # Label-area icon: stateful, independent of show_indicator.
+    # Accent color when selected, foreground when unselected.
+    icon_images = []
+    icon_spec_raw = resolve_icon_spec(options)
+    if icon_spec_raw is not None:
+        icon_spec = b.normalize_icon_spec(icon_spec_raw, icon_size(False, 'default'))
+        fg_spec = [
+            ('disabled', foreground_disabled),
+            ('selected !disabled', normal),
+            ('', foreground),
+        ]
+        icon_images = b.map_stateful_icons(icon_spec, fg_spec)
+
+    layout_children = []
+    if show_indicator:
+        layout_children += [
+            Element(f'{ttk_style}.indicator', side="left", sticky=""),
+            Element(f'{ttk_style}.spacer', side="left"),
+        ]
+    layout_children.append(Element('Checkbutton.label', side="left", sticky="nsew"))
+
+    b.create_style_layout(
+        ttk_style, Element('Checkbutton.padding', sticky="nsew").children(layout_children)
+    )
+
+    b.configure_style(ttk_style, background=background, foreground=foreground, font="body")
+
+    map_kwargs = {
+        'background': [],
+        'foreground': [('disabled', foreground_disabled), ('', foreground)],
+    }
+    if icon_images:
+        map_kwargs['image'] = icon_images
+        if not options.get('icon_only', False):
+            map_kwargs['compound'] = 'left'
+    b.map_style(ttk_style, **map_kwargs)

{bootstack-0.1.0a7 → bootstack-0.1.0a9}/src/bootstack/style/builders/listview.py

@@ -77,8 +77,8 @@ def build_list_item_style(
     active_img = recolor_element_image(image_key, active, border_normal, active)
     selected_img = recolor_element_image(image_key, selected, border_normal, indicator)
 
-    focus_img = recolor_element_image(image_key, active, border_normal, indicator)
-    focus_pressed_img = recolor_element_image(image_key, pressed, border_normal, indicator)
+    focus_img = recolor_element_image(image_key, active, border_normal, active)
+    focus_pressed_img = recolor_element_image(image_key, pressed, border_normal, pressed)
 
     image_state_specs = [
         ('selected', selected_img.image),
@@ -173,13 +173,12 @@ def _list_icon_size(b: BootstyleBuilderTTk, density: str) -> int:
 def build_list_icon(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
     hoverable = options.get('hoverable', True)
     surface_token = options.get('surface', 'content')
-    select_background_token = options.get('selected_background', 'primary')
     density = normalize_button_density(options.get('density', 'default'))
 
     background = b.color(surface_token)
     active = b.elevate(background, 1)
     pressed = b.pressed(background)
-    selected = b.subtle(select_background_token, background)
+    selected = b.subtle(accent or 'primary', background)
     on_background = b.on_color(background)
     on_selected = b.on_color(selected)
     on_disabled = b.disabled('text', background)
@@ -236,19 +235,17 @@ def build_list_item_label(b: BootstyleBuilderTTk, ttk_style: str, accent: str =
 
     Style Options
     * surface
-    * selected_background
     * hoverable
     * foreground
     """
     hoverable = options.get('hoverable', True)
     surface_token = options.get('surface', 'content')
-    select_background_token = options.get('selected_background', 'primary')
     foreground_token = options.get('foreground', None)
 
     background = b.color(surface_token)
     active = b.elevate(background, 1)
     pressed = b.pressed(background)
-    selected = b.subtle(select_background_token, background)
+    selected = b.subtle(accent or 'primary', background)
     on_selected = b.on_color(selected)
     on_background = b.color(foreground_token) if foreground_token else b.on_color(background)
 

bootstack-0.1.0a9/src/bootstack/style/builders/radiobutton.py

@@ -0,0 +1,97 @@
+"""Radio Button widget style builders.
+
+This module contains style builders for ttk.Radiobutton widgets and variants.
+"""
+
+from __future__ import annotations
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+from bootstack.style.element import Element, ElementImage
+from bootstack.style.utility import create_transparent_image, recolor_element_image
+from bootstack.style.builders.utils import icon_size, resolve_icon_spec
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TRadiobutton')
+def build_radiobutton_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = 'primary', **options):
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+
+    background = b.color(surface_token)
+    background_hover = b.active(background)
+    foreground = b.on_color(background)
+    foreground_disabled = b.disabled('text', background)
+
+    normal = b.color(accent_token)
+    hovered = b.active(normal)
+    border = b.border(background)
+    focus = hovered
+    focus_ring = b.focus_ring(normal, background)
+
+    show_indicator = options.get('show_indicator', True)
+
+    if show_indicator:
+        spacer_img = create_transparent_image(6, 1)
+        b.create_style_element_image(ElementImage(f'{ttk_style}.spacer', spacer_img, sticky="ew"))
+
+        normal_checked_img = recolor_element_image('radio_selected', background, normal, background)
+        normal_unchecked_img = recolor_element_image('radio_unselected', background, border, background)
+
+        focus_checked_img = recolor_element_image('radio_selected', background, focus, focus_ring)
+        focus_unchecked_img = recolor_element_image('radio_unselected', background_hover, focus, focus_ring)
+
+        disabled_checked_img = recolor_element_image('radio_selected', background, foreground_disabled, background)
+        disabled_unchecked_img = recolor_element_image('radio_unselected', background, foreground_disabled, background)
+
+        b.create_style_element_image(
+            ElementImage(f'{ttk_style}.indicator', normal_unchecked_img.image, sticky="ns", padding=b.scale(4)).state_specs(
+                [
+                    # Disabled states
+                    ('disabled selected', disabled_checked_img.image),
+                    ('disabled !selected !alternate', disabled_unchecked_img.image),
+
+                    # Focused states
+                    ('focus selected', focus_checked_img.image),
+                    ('focus !selected !alternate', focus_unchecked_img.image),
+
+                    # Normal base states
+                    ('selected', normal_checked_img.image),
+                    ('!selected !alternate', normal_unchecked_img.image),
+                ]
+            ))
+
+    # Label-area icon: stateful, independent of show_indicator.
+    # Accent color when selected, foreground when unselected.
+    icon_images = []
+    icon_spec_raw = resolve_icon_spec(options)
+    if icon_spec_raw is not None:
+        icon_spec = b.normalize_icon_spec(icon_spec_raw, icon_size(False, 'default'))
+        fg_spec = [
+            ('disabled', foreground_disabled),
+            ('selected !disabled', normal),
+            ('', foreground),
+        ]
+        icon_images = b.map_stateful_icons(icon_spec, fg_spec)
+
+    layout_children = []
+    if show_indicator:
+        layout_children += [
+            Element(f'{ttk_style}.indicator', side="left", sticky=""),
+            Element(f'{ttk_style}.spacer', side="left"),
+        ]
+    layout_children.append(Element('Radiobutton.label', side="left", sticky="nsew"))
+
+    b.create_style_layout(
+        ttk_style, Element('Radiobutton.padding', sticky="nsew").children(layout_children)
+    )
+
+    b.configure_style(ttk_style, background=background, foreground=foreground, font="body")
+
+    map_kwargs = {
+        'background': [],
+        'foreground': [('disabled', foreground_disabled), ('', foreground)],
+    }
+    if icon_images:
+        map_kwargs['image'] = icon_images
+        if not options.get('icon_only', False):
+            map_kwargs['compound'] = 'left'
+    b.map_style(ttk_style, **map_kwargs)