bootstack 0.1.0a12__tar.gz → 0.1.0a13__tar.gz

{bootstack-0.1.0a12/src/bootstack.egg-info → bootstack-0.1.0a13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.0a12
+Version: 0.1.0a13
 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.
 Author-email: Israel Dryer <israel.dryer@gmail.com>
 License-Expression: MIT
@@ -35,6 +35,11 @@ Requires-Dist: pyarrow>=14; extra == "parquet"
 Provides-Extra: hdf5
 Requires-Dist: pandas>=2; extra == "hdf5"
 Requires-Dist: tables>=3.8; extra == "hdf5"
+Provides-Extra: viz
+Requires-Dist: matplotlib>=3.8; extra == "viz"
+Provides-Extra: viz-seaborn
+Requires-Dist: matplotlib>=3.8; extra == "viz-seaborn"
+Requires-Dist: seaborn>=0.13; extra == "viz-seaborn"
 Provides-Extra: docs
 Requires-Dist: sphinx>=7.2; extra == "docs"
 Requires-Dist: pydata-sphinx-theme; extra == "docs"
@@ -87,6 +92,7 @@ Most Python desktop frameworks make you fight the framework. bootstack gets out
 - **10 paired light/dark themes** — popular dev color schemes plus Bootstrap, with a runtime switcher and a custom-theme API
 - **Forms and validation** — field-level validators, inline error messages, and a `FormDialog` for quick modal forms
 - **DataSource abstraction** — one interface over SQLite, in-memory, and file backends with filtering, sorting, pagination, and CRUD
+- **Data visualization** — embed `matplotlib` (and `seaborn`) figures with `Chart`; they recolor with the theme and live-update from a `Signal` or `DataSource` (optional `viz` extra)
 - **A real CLI** — scaffold, run, add pages/views/dialogs/themes, and package for distribution
 - **PyInstaller packaging built in** — `bootstack build` produces a standalone executable; no separate toolchain required
 
@@ -226,6 +232,7 @@ app.run()
 - **Reactive signals** — observable state with subscribe/set, integrates with widgets via `signal=` / `textsignal=`
 - **Forms & validation** — `Form` with built-in field-level validators and inline error messages
 - **DataSource** — common interface over in-memory, SQLite, and file backends, with pagination, filtering, sorting, CRUD, and CSV/TSV/Excel export
+- **Data visualization** — `Chart` embeds `matplotlib`/`seaborn` figures that theme themselves and live-update from a `Signal` or `DataSource`; managed render, blitting animation, and a themed navigation toolbar (optional `viz` / `viz-seaborn` extras)
 - **Localization (i18n)** — 23 bundled message catalogs, locale-aware number/date/time formatting via Babel, runtime language switching
 - **Icons & images** — Bootstrap Icons catalog with theme-aware recoloring and caching
 - **Platform support** — DPI awareness, multi-monitor centering, mica/acrylic effects on Windows

{bootstack-0.1.0a12 → bootstack-0.1.0a13}/README.md

@@ -42,6 +42,7 @@ Most Python desktop frameworks make you fight the framework. bootstack gets out
 - **10 paired light/dark themes** — popular dev color schemes plus Bootstrap, with a runtime switcher and a custom-theme API
 - **Forms and validation** — field-level validators, inline error messages, and a `FormDialog` for quick modal forms
 - **DataSource abstraction** — one interface over SQLite, in-memory, and file backends with filtering, sorting, pagination, and CRUD
+- **Data visualization** — embed `matplotlib` (and `seaborn`) figures with `Chart`; they recolor with the theme and live-update from a `Signal` or `DataSource` (optional `viz` extra)
 - **A real CLI** — scaffold, run, add pages/views/dialogs/themes, and package for distribution
 - **PyInstaller packaging built in** — `bootstack build` produces a standalone executable; no separate toolchain required
 
@@ -181,6 +182,7 @@ app.run()
 - **Reactive signals** — observable state with subscribe/set, integrates with widgets via `signal=` / `textsignal=`
 - **Forms & validation** — `Form` with built-in field-level validators and inline error messages
 - **DataSource** — common interface over in-memory, SQLite, and file backends, with pagination, filtering, sorting, CRUD, and CSV/TSV/Excel export
+- **Data visualization** — `Chart` embeds `matplotlib`/`seaborn` figures that theme themselves and live-update from a `Signal` or `DataSource`; managed render, blitting animation, and a themed navigation toolbar (optional `viz` / `viz-seaborn` extras)
 - **Localization (i18n)** — 23 bundled message catalogs, locale-aware number/date/time formatting via Babel, runtime language switching
 - **Icons & images** — Bootstrap Icons catalog with theme-aware recoloring and caching
 - **Platform support** — DPI awareness, multi-monitor centering, mica/acrylic effects on Windows

{bootstack-0.1.0a12 → bootstack-0.1.0a13}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.1.0a12"
+version = "0.1.0a13"
 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."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -73,6 +73,15 @@ hdf5 = [
     "pandas>=2",
     "tables>=3.8",
 ]
+# Visualization — embed matplotlib figures in a Chart widget.
+viz = [
+    "matplotlib>=3.8",
+]
+# Visualization with seaborn convenience layer on top of matplotlib.
+viz-seaborn = [
+    "matplotlib>=3.8",
+    "seaborn>=0.13",
+]
 docs = [
     "sphinx>=7.2",
     "pydata-sphinx-theme",
@@ -100,7 +109,7 @@ where = ["src"]
 ]
 
 [tool.bumpversion]
-current_version = "0.1.0a12"
+current_version = "0.1.0a13"
 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}",
@@ -129,9 +138,10 @@ search = "version = \"{current_version}\""
 replace = "version = \"{new_version}\""
 
 [tool.pytest.ini_options]
-testpaths = ["tests/cli", "tests/widgets/public"]
+testpaths = ["tests/cli", "tests/widgets/public", "tests/data"]
 markers = [
     "gui: requires a Tk display (deselect with -m 'not gui')",
+    "isolated: constructs its own Tk root (App/AppShell/Window kwargs); must run in a dedicated process. Run the suite via `python tests/run_gui.py`, which executes the shared-root suite once and each isolated module in its own process.",
 ]
 
 [tool.ruff.lint]

{bootstack-0.1.0a12 → bootstack-0.1.0a13}/src/bootstack/__init__.py

@@ -81,6 +81,7 @@ from bootstack.widgets.pagestack import PageStack, StackPage
 from bootstack.widgets.pathfield import PathField
 from bootstack.widgets.avatar import Avatar
 from bootstack.widgets.carousel import Carousel
+from bootstack.widgets.chart import Chart
 from bootstack.widgets.gallery import Gallery
 from bootstack.widgets.passwordfield import PasswordField
 from bootstack.widgets.picture import Picture
@@ -143,7 +144,7 @@ __all__ = [
     # Data display
     "Label", "Badge", "ProgressBar", "Gauge", "ListView", "DataTable", "Tree", "TreeNode",
     # Media
-    "Picture", "Gallery", "Carousel", "Avatar",
+    "Picture", "Gallery", "Carousel", "Avatar", "Chart",
     # Navigation
     "PageStack", "StackPage", "Tabs", "TabPage",
     # Overlays

{bootstack-0.1.0a12 → bootstack-0.1.0a13}/src/bootstack/_runtime/app.py

@@ -675,6 +675,32 @@ class App(BaseWindow, WidgetCapabilitiesMixin, tkinter.Tk):
             except tkinter.TclError:
                 pass
         clear_current_app(self)
+        # Drop every process-wide cache that holds a Tk object bound to THIS
+        # root's interpreter — the Style singleton, the named/derived font
+        # caches, the nine-patch PhotoImage cache, and the visual-focus root
+        # ref. This must happen *before* super().destroy(): those cached
+        # PhotoImage/TkFont objects run `image delete`/`font delete` in their
+        # finalizers, and if they outlive the interpreter that owns them the
+        # call lands on a foreign/dead interpreter — a native crash in ttk
+        # element_create on the *next* root (the C layer, so Python can't catch
+        # it). Releasing + gc.collect() while this root is still alive lets the
+        # finalizers run cleanly. Only when no other App is live (single-App is
+        # the norm; this also lets the GUI test suite run module-after-module in
+        # one process, and fixes reopen-an-app-after-close in production).
+        if not has_current_app():
+            try:
+                import gc
+                from bootstack.style.style import reset_style
+                from bootstack.style.typography import Typography
+                from bootstack._core.images import _ImageService
+                from bootstack._runtime.visual_focus import reset_visual_focus_root
+                reset_style()
+                Typography.reset()
+                _ImageService.clear_cache()
+                reset_visual_focus_root()
+                gc.collect()
+            except Exception:
+                pass
         super().destroy()
 
     # ----- Window state persistence ------------------------------------------

{bootstack-0.1.0a12 → bootstack-0.1.0a13}/src/bootstack/_runtime/visual_focus.py

@@ -205,6 +205,17 @@ def uninstall_visual_focus() -> None:
     _installed = False
 
 
+def reset_visual_focus_root() -> None:
+    """Forget the cached root reference without un-patching `bind_all`.
+
+    `_root_ref` is captured lazily from the first root that binds. After that
+    root is destroyed the reference is stale; clearing it lets the next root
+    re-bind. The `bind_all` patch (installed once at import) stays in place.
+    """
+    global _root_ref
+    _root_ref = None
+
+
 def is_keyboard_focus(widget: tk.Misc) -> bool:
     """Check if a widget currently has keyboard-initiated focus.
 
@@ -224,5 +235,6 @@ def is_keyboard_focus(widget: tk.Misc) -> bool:
 __all__ = [
     'install_visual_focus',
     'uninstall_visual_focus',
+    'reset_visual_focus_root',
     'is_keyboard_focus',
 ]

{bootstack-0.1.0a12 → bootstack-0.1.0a13}/src/bootstack/style/style.py

@@ -453,6 +453,21 @@ def get_style(master: Master = None) -> Style:
         return Style(master)
 
 
+def reset_style() -> None:
+    """Drop the process-wide Style singleton.
+
+    The Style singleton is a `ttk.Style` bound to the Tk root that created it.
+    Once that root is destroyed its interpreter is gone, so the singleton can no
+    longer be used — a fresh App must rebuild Style against the new root. Call
+    this after destroying the root (App.destroy does) so the next
+    `get_style()`/`Style()` constructs cleanly instead of reusing a dead
+    instance (whose `theme_use` would fail, e.g. "named font body does not
+    already exist").
+    """
+    global _style_instance
+    _style_instance = None
+
+
 def get_style_builder() -> StyleBuilderTtk:
     """Return the style builder for the currently active theme.
 

{bootstack-0.1.0a12 → bootstack-0.1.0a13}/src/bootstack/style/typography.py

@@ -168,6 +168,21 @@ class Typography:
         cls._ensure_named_token_fonts()
         cls._override_tk_fonts()
 
+    @classmethod
+    def reset(cls) -> None:
+        """Forget the Tk-bound named-font cache and root reference.
+
+        The cached named fonts (`body`, `heading-lg`, ...) and the derived
+        fonts (`body[bold]`, ...) are `TkFont`s bound to the root that created
+        them; once that root is destroyed they are stale, and their finalizers
+        would later run against a foreign interpreter. Clearing them lets the
+        next `initialize()` rebuild against a fresh root. Called from
+        App.destroy so a subsequent App starts clean.
+        """
+        cls._root = None
+        cls._named_fonts = {}
+        _DERIVED_FONTS.clear()
+
     @classmethod
     def use_fonts(cls, fonts: FontTokens) -> None:
         cls._fonts = fonts

{bootstack-0.1.0a12 → bootstack-0.1.0a13}/src/bootstack/widgets/__init__.py

@@ -39,6 +39,7 @@ _EXPORTS: dict[str, str] = {
     "Label": "label", "Badge": "label", "Picture": "picture", "Gallery": "gallery",
     "Carousel": "carousel", "Avatar": "avatar", "ProgressBar": "progressbar",
     "Gauge": "gauge", "ListView": "listview", "DataTable": "datatable", "Tree": "tree",
+    "Chart": "chart",
     # Navigation
     "PageStack": "pagestack", "StackPage": "pagestack",
     "Tabs": "tabs", "TabPage": "tabs",