bootstack 0.1.0a8__tar.gz → 0.1.0a9__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.0a8
+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.0a8 → bootstack-0.1.0a9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.1.0a8"
+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.0a8"
+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.0a8 → 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.0a8 → 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.0a8 → 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.0a8 → 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.0a8 → 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.0a8 → 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.0a8 → bootstack-0.1.0a9}/src/bootstack/widgets/composites/list/listitem.py

@@ -48,14 +48,12 @@ class ListItem(CompositeFrame):
         Args:
             master: Parent widget.
             **kwargs: Additional keyword arguments:
-                focus_color (str): Color for the focus indicator. Defaults to None.
                 show_separator (bool): Show separator line below the item. Defaults to False.
                 show_chevron (bool): Show chevron indicator on the right. Defaults to False.
                 focusable (bool): Whether this item can receive keyboard focus. Defaults to True.
                 hoverable (bool): Whether this item shows hover state. Defaults to False.
                 draggable (bool): Whether this item can be dragged. Defaults to False.
                 removable (bool): Whether this item can be removed. Defaults to False.
-                selected_background (str): Background color when selected. Defaults to 'primary'.
                 selection_mode (str): Selection mode ('none', 'single', 'multi'). Defaults to 'none'.
                 show_selection_controls (bool): Show checkbox/radio button. Defaults to False.
                 select_on_click (bool): Whether clicking selects the item. Defaults to True
@@ -71,14 +69,15 @@ class ListItem(CompositeFrame):
         self._drag_state = None
 
         # configuration properties
-        self._focus_color = kwargs.pop('focus_color', None)
         self._show_separator = kwargs.pop('show_separator', False)
         self._show_chevron = kwargs.pop('show_chevron', False)
         self._focusable = kwargs.pop('focusable', True)
         self._hoverable = kwargs.pop('hoverable', False)
         self._draggable = kwargs.pop('draggable', False)
         self._removable = kwargs.pop('removable', False)
-        self._selected_background = kwargs.pop('selected_background', 'primary')
+        # Capture accent (pop) so super() doesn't get it twice, and we can pass it
+        # explicitly to super() below.
+        self._accent = kwargs.pop('accent', None) or 'primary'
         self._selection_mode = kwargs.pop('selection_mode', 'none')
         self._show_selection_controls = kwargs.pop('show_selection_controls', False)
         self._density = kwargs.pop('density', 'default')
@@ -102,9 +101,8 @@ class ListItem(CompositeFrame):
             takefocus=self._focusable,
             ttk_class='ListView.TFrame',
             padding=item_padding,
+            accent=self._accent,
             style_options=dict(
-                selected_background=self._selected_background,
-                focus_color=self._focus_color,
                 hoverable=self._hoverable,
                 density=self._density
             )
@@ -116,9 +114,8 @@ class ListItem(CompositeFrame):
             variant='list',
             ttk_class='ListView.TFrame',
             takefocus=False,
-            style_options=dict(selected_background=self._selected_background,
-                               hoverable=self._hoverable,
-                               density=self._density)
+            accent=self._accent,
+            style_options=dict(hoverable=self._hoverable, density=self._density)
         )
         self._left_frame.pack(side='left')
 
@@ -127,9 +124,8 @@ class ListItem(CompositeFrame):
             variant='list',
             ttk_class='ListView.TFrame',
             takefocus=False,
-            style_options=dict(selected_background=self._selected_background,
-                               hoverable=self._hoverable,
-                               density=self._density)
+            accent=self._accent,
+            style_options=dict(hoverable=self._hoverable, density=self._density)
         )
         self._center_frame.pack(side='left', fill='x', expand=True)
 
@@ -138,9 +134,8 @@ class ListItem(CompositeFrame):
             variant='list',
             ttk_class='ListView.TFrame',
             takefocus=False,
-            style_options=dict(selected_background=self._selected_background,
-                               hoverable=self._hoverable,
-                               density=self._density)
+            accent=self._accent,
+            style_options=dict(hoverable=self._hoverable, density=self._density)
         )
         self._right_frame.pack(side='left')
 
@@ -268,9 +263,8 @@ class ListItem(CompositeFrame):
                 variant='icon',
                 ttk_class='ListView.TLabel',
                 icon_only=True,
-                style_options=dict(selected_background=self._selected_background,
-                                   hoverable=self._hoverable,
-                                   density=self._density),
+                accent=self._accent,
+                style_options=dict(hoverable=self._hoverable, density=self._density),
                 takefocus=False,
             )
             if self._show_selection_controls:
@@ -301,9 +295,8 @@ class ListItem(CompositeFrame):
                     ttk_class='ListView.TLabel',
                     takefocus=False,
                     icon_only=True,
-                    style_options=dict(selected_background=self._selected_background,
-                                       hoverable=self._hoverable,
-                                       density=self._density),
+                    accent=self._accent,
+                    style_options=dict(hoverable=self._hoverable, density=self._density),
                 )
                 self._icon_widget.pack(side='left', padx=5)
                 self.register_composite(self._icon_widget)
@@ -332,9 +325,8 @@ class ListItem(CompositeFrame):
                     variant='list',
                     ttk_class='ListView.TLabel',
                     takefocus=False,
-                    style_options=dict(selected_background=self._selected_background,
-                                       hoverable=self._hoverable,
-                                       density=self._density),
+                    accent=self._accent,
+                    style_options=dict(hoverable=self._hoverable, density=self._density),
                 )
                 self._title_widget.pack(side='top', fill='x', anchor='w', padx=(0, 3))
                 self.register_composite(self._title_widget)
@@ -363,9 +355,8 @@ class ListItem(CompositeFrame):
                     variant='list',
                     ttk_class='ListView.TLabel',
                     takefocus=False,
-                    style_options=dict(selected_background=self._selected_background,
-                                       hoverable=self._hoverable,
-                                       density=self._density),
+                    accent=self._accent,
+                    style_options=dict(hoverable=self._hoverable, density=self._density),
                 )
                 self._text_widget.pack(side='top', fill='x', padx=(0, 3))
                 self.register_composite(self._text_widget)
@@ -405,9 +396,8 @@ class ListItem(CompositeFrame):
                     variant='list',
                     ttk_class='ListView.TLabel',
                     takefocus=False,
-                    style_options=dict(selected_background=self._selected_background,
-                                       hoverable=self._hoverable,
-                                       density=self._density),
+                    accent=self._accent,
+                    style_options=dict(hoverable=self._hoverable, density=self._density),
                 )
                 self._caption_widget.pack(side='top', fill='x', padx=(0, 3))
                 self.register_composite(self._caption_widget)
@@ -432,9 +422,8 @@ class ListItem(CompositeFrame):
                     text=text,
                     variant='list',
                     ttk_class='ListView.TLabel',
-                    style_options=dict(selected_background=self._selected_background,
-                                       hoverable=self._hoverable,
-                                       density=self._density),
+                    accent=self._accent,
+                    style_options=dict(hoverable=self._hoverable, density=self._density),
                 )
                 self._badge_widget.pack(side='right', padx=6)
                 self.register_composite(self._badge_widget)
@@ -461,9 +450,8 @@ class ListItem(CompositeFrame):
                     variant='icon',
                     ttk_class='ListView.TButton',
                     takefocus=False,
-                    style_options=dict(selected_background=self._selected_background,
-                                       hoverable=self._hoverable,
-                                       density=self._density),
+                    accent=self._accent,
+                    style_options=dict(hoverable=self._hoverable, density=self._density),
                 )
                 self._chevron_widget.pack(side='right', padx=6)
                 self.register_composite(self._chevron_widget)
@@ -489,9 +477,8 @@ class ListItem(CompositeFrame):
                     ttk_class='ListView.TButton',
                     takefocus=False,
                     command=self.remove,
-                    style_options=dict(selected_background=self._selected_background,
-                                       hoverable=self._hoverable,
-                                       density=self._density),
+                    accent=self._accent,
+                    style_options=dict(hoverable=self._hoverable, density=self._density),
                 )
                 self._remove_widget.pack(side='right', padx=6)
                 self.register_composite(self._remove_widget)
@@ -517,9 +504,8 @@ class ListItem(CompositeFrame):
                     ttk_class='ListView.TButton',
                     cursor='fleur',
                     takefocus=False,
-                    style_options=dict(selected_background=self._selected_background,
-                                       hoverable=self._hoverable,
-                                       density=self._density),
+                    accent=self._accent,
+                    style_options=dict(hoverable=self._hoverable, density=self._density),
                 )
                 self._drag_widget.pack(side='right', padx=6)
 
@@ -626,10 +612,6 @@ class ListItem(CompositeFrame):
         self._get_selection_icon()
         self._update_selection(False)
 
-    @configure_delegate('selected_background')
-    def _delegate_selected_background(self, value=None):
-        self._selected_background = value
-
     @configure_delegate('show_chevron')
     def _delegate_show_chevron(self, value=None):
         self._show_chevron = value