bootstack 0.1.0a1__py3-none-any.whl

bootstack/__init__.py

@@ -0,0 +1,249 @@
+"""bootstack — a full UI framework for Python desktop apps built on Tkinter.
+
+All widgets, dialogs, style utilities, and application primitives are
+accessible directly from this namespace via lazy imports.
+
+Examples:
+    ```python
+    import bootstack as bs
+
+    app = bs.App(title="My App", themename="bootstrap-light")
+    bs.Label(app, text="Hello, world!").pack(padx=20, pady=20)
+    app.mainloop()
+    ```
+"""
+import importlib as _importlib
+from importlib.metadata import version as _pkg_version
+from typing import TYPE_CHECKING
+
+__version__ = _pkg_version("bootstack")
+
+from tkinter import (
+    BooleanVar,
+    Canvas as _tkCanvas,
+    DoubleVar,
+    Frame as _tkFrame,
+    IntVar,
+    Menu as _tkMenu,
+    PhotoImage,
+    StringVar,
+    Text as _tkText,
+    Tk as _tkTk,
+    Variable,
+)
+
+# Re-export tk widgets with original names before importing submodules
+Tk = _tkTk
+Menu = _tkMenu
+Text = _tkText
+Canvas = _tkCanvas
+TkFrame = _tkFrame  # Exported as TkFrame to avoid conflict with bs.Frame
+# Eagerly import BootstrapIcon to prevent circular import during style bootstrapping
+from ttkbootstrap_icons_bs import BootstrapIcon  # noqa: E402
+
+# Constants are available via bootstack.constants module
+# (see constants.py which re-exports from core.constants)
+
+if TYPE_CHECKING:
+    from bootstack.api.menu import MenuManager, create_menu
+    from bootstack.api.app import App, AppShell, App as Window, Toplevel, AppSettings, get_app_settings, get_current_app, Shortcuts, Shortcut, get_shortcuts
+    from bootstack.api.style import (
+        Font,
+        Style,
+        get_style,
+        get_style_builder,
+        get_theme,
+        get_theme_provider,
+        set_theme,
+        toggle_theme,
+        get_theme_color,
+        get_themes,
+    )
+    from bootstack.api.widgets import (
+        Button,
+        ButtonGroup,
+        Card,
+        CheckButton,
+        Combobox,
+        ContextMenu,
+        ContextMenuItem,
+        DateEntry,
+        Calendar,
+        DropdownButton,
+        Entry,
+        Field,
+        FieldOptions,
+        FloodGauge,
+        Form,
+        Frame,
+        GridFrame,
+        Label,
+        LabelFrame,
+        LabeledScale,
+        MenuBar,
+        MenuButton,
+        Meter,
+        SideNav,
+        SideNavItem,
+        SideNavGroup,
+        SideNavHeader,
+        SideNavSeparator,
+        Notebook,
+        NumericEntry,
+        OptionMenu,
+        PackFrame,
+        PageStack,
+        PanedWindow,
+        PasswordEntry,
+        PathEntry,
+        Progressbar,
+        RadioButton,
+        RadioGroup,
+        Scale,
+        Scrollbar,
+        ScrolledText,
+        ScrollView,
+        SelectBox,
+        Separator,
+        SideNav,
+        SpinnerEntry,
+        SizeGrip,
+        Spinbox,
+        Switch,
+        TableView,
+        TextEntry,
+        TimeEntry,
+        Toast,
+        Toolbar,
+        ToggleGroup,
+        ToolTip,
+        TreeView,
+        TK_WIDGETS,
+        TTK_WIDGETS,
+    )
+    from bootstack.api.localization import MessageCatalog, L, LV, IntlFormatter
+    from bootstack.api.utils import Image
+    from ttkbootstrap_icons_bs import BootstrapIcon
+
+
+_TK_EXPORTS = [
+    "Tk",
+    "Menu",
+    "Text",
+    "Canvas",
+    "TkFrame",
+    "Variable",
+    "StringVar",
+    "IntVar",
+    "BooleanVar",
+    "DoubleVar",
+    "PhotoImage",
+]
+
+# Single source of truth: module-to-exports mapping
+# Organized by category for clarity
+_TTK_PRIMITIVES = [
+    "Button", "CheckButton", "Combobox", "Entry", "Frame", "Label",
+    "LabelFrame", "MenuButton", "Notebook", "OptionMenu", "PanedWindow",
+    "Progressbar", "RadioButton", "Scale", "Scrollbar", "Separator",
+    "SizeGrip", "Spinbox", "TreeView",
+]
+
+_MODULE_EXPORTS = {
+    # Application & Windows (includes menu and shortcuts)
+    "bootstack.api.app": [
+        "App", "AppShell", "Toplevel", "Window", "AppSettings", "get_app_settings", "get_current_app",
+        "MenuManager", "create_menu",
+        "Shortcuts", "Shortcut", "get_shortcuts",
+    ],
+    # Style & Theming
+    "bootstack.api.style": [
+        "BootstrapIcon", "Font", "Style",
+        "get_style", "get_style_builder", "get_theme",
+        "get_theme_provider", "set_theme", "get_theme_color",
+        "toggle_theme", "get_themes",
+    ],
+    # Widgets
+    "bootstack.api.widgets": [
+        *_TTK_PRIMITIVES,
+        "Badge",
+        "ButtonGroup",
+        "Card",
+        "CheckToggle",
+        "RadioToggle",
+        "Calendar", "ContextMenu", "ContextMenuItem", "DateEntry",
+        "Accordion", "DropdownButton", "Expander", "Field", "FieldOptions", "FloodGauge", "Form",
+        "GridFrame", "LabeledScale", "MenuBar", "Meter",
+        "SideNav", "SideNavItem", "SideNavGroup",
+        "SideNavHeader", "SideNavSeparator",
+        "NumericEntry", "PackFrame", "PageStack",
+        "PasswordEntry", "PathEntry", "RadioGroup", "ScrolledText", "ScrollView", "SpinnerEntry",
+        "SelectBox", "TableView", "TextEntry", "TimeEntry", "Toast", "Toolbar", "ToggleGroup", "Switch",
+        "ToolTip", "TK_WIDGETS", "TTK_WIDGETS",
+    ],
+    # Dialogs
+    "bootstack.api.dialogs": [
+        "Dialog", "DialogButton", "FilterDialog", "FormDialog",
+        "MessageDialog", "MessageBox", "QueryDialog", "QueryBox",
+        "DateDialog", "FontDialog",
+        "ColorChooser", "ColorChooserDialog", "ColorDropperDialog",
+    ],
+    # Data Sources
+    "bootstack.api.data": [
+        "BaseDataSource", "MemoryDataSource", "SqliteDataSource",
+        "FileDataSource", "FileSourceConfig",
+        "DataSourceProtocol", "Record", "Primitive",
+    ],
+    # Internationalization
+    "bootstack.api.i18n": [
+        "MessageCatalog", "L", "LV", "IntlFormatter"
+    ],
+    # Utilities
+    "bootstack.api.utils": [
+        "Image",
+        "Signal", "TraceOperation",
+        "ValidationRule", "ValidationResult",
+        "SetVar",
+    ],
+}
+
+# Auto-generate lazy exports and categorized export lists
+_LAZY_EXPORTS = {}
+_TTK_EXPORTS = _TTK_PRIMITIVES.copy()
+_BOOTSTACK_EXPORTS = []
+
+for module, exports in _MODULE_EXPORTS.items():
+    for name in exports:
+        _LAZY_EXPORTS[name] = module
+        if name not in _TTK_EXPORTS:
+            _BOOTSTACK_EXPORTS.append(name)
+
+__all__ = [*_TK_EXPORTS, *_TTK_EXPORTS, *_BOOTSTACK_EXPORTS]
+
+def __getattr__(name):
+    """Lazily import top-level attributes to avoid circular imports and speed import."""
+    if name in _LAZY_EXPORTS:
+        module = _importlib.import_module(_LAZY_EXPORTS[name])
+        value = getattr(module, name)
+        globals()[name] = value
+        return value
+
+    raise AttributeError(f"module 'bootstack' has no attribute '{name}'")
+
+
+def __dir__():
+    return sorted(set(__all__ + list(globals().keys())))
+
+
+# Patch Tk widgets for autostyle
+from bootstack.runtime.tk_patch import install_tk_autostyle
+
+# Install enhanced events on import
+from bootstack.runtime.events import install_enhanced_events
+
+# Install visual focus
+from bootstack.runtime.visual_focus import install_visual_focus
+
+install_tk_autostyle()
+install_enhanced_events()
+install_visual_focus()

bootstack/__main__.py

@@ -0,0 +1,5 @@
+"""CLI entry point — invoked as `python -m bootstack` to launch the bootstack CLI."""
+from bootstack.cli import main
+
+if __name__ == "__main__":
+    main()

bootstack/api/__init__.py

@@ -0,0 +1,127 @@
+"""Public API surface for bootstack v2.
+
+This module centralizes re-exports so top-level imports can stay slim and
+import direction stays clear. Implementation lives in lower-layer packages.
+"""
+
+from __future__ import annotations
+
+from bootstack.api.style import (
+    BootstrapIcon,
+    Style,
+    get_style,
+    get_style_builder,
+    get_theme_provider,
+    get_theme,
+    get_theme_color,
+    set_theme,
+    toggle_theme,
+)
+from bootstack.api.widgets import (
+    Button,
+    CheckButton,
+    Combobox,
+    ContextMenu,
+    ContextMenuItem,
+    DateEntry,
+    Calendar,
+    DropdownButton,
+    Entry,
+    Field,
+    FieldOptions,
+    FloodGauge,
+    Form,
+    Frame,
+    Label,
+    LabelFrame,
+    LabeledScale,
+    MenuButton,
+    Meter,
+    Notebook,
+    NumericEntry,
+    OptionMenu,
+    PanedWindow,
+    PasswordEntry,
+    PathEntry,
+    Progressbar,
+    RadioButton,
+    Scale,
+    Scrollbar,
+    ScrollView,
+    ScrolledText,
+    SelectBox,
+    Separator,
+    SizeGrip,
+    Spinbox,
+    TableView,
+    TextEntry,
+    TimeEntry,
+    Toast,
+    ToolTip,
+    TreeView,
+    TK_WIDGETS,
+    TTK_WIDGETS,
+)
+from bootstack.runtime.app import App, App as Window
+from bootstack.runtime.toplevel import Toplevel
+from bootstack.runtime.menu import MenuManager, create_menu
+
+__all__ = [
+    "BootstrapIcon",
+    "Style",
+    "Button",
+    "CheckButton",
+    "Combobox",
+    "ContextMenu",
+    "ContextMenuItem",
+    "DateEntry",
+    "Calendar",
+    "DropdownButton",
+    "Entry",
+    "Field",
+    "FieldOptions",
+    "FloodGauge",
+    "Form",
+    "Frame",
+    "Label",
+    "LabelFrame",
+    "LabeledScale",
+    "MenuButton",
+    "Meter",
+    "Notebook",
+    "NumericEntry",
+    "OptionMenu",
+    "PanedWindow",
+    "PasswordEntry",
+    "PathEntry",
+    "Progressbar",
+    "RadioButton",
+    "Scale",
+    "Scrollbar",
+    "ScrollView",
+    "ScrolledText",
+    "SelectBox",
+    "Separator",
+    "SizeGrip",
+    "Spinbox",
+    "TableView",
+    "TextEntry",
+    "TimeEntry",
+    "Toast",
+    "ToolTip",
+    "TreeView",
+    "Toplevel",
+    "App",
+    "Window",
+    "MenuManager",
+    "get_style",
+    "get_style_builder",
+    "get_theme",
+    "set_theme",
+    "toggle_theme",
+    "get_theme_provider",
+    "get_theme_color",
+    "create_menu",
+    "TK_WIDGETS",
+    "TTK_WIDGETS",
+]

bootstack/api/app.py

@@ -0,0 +1,30 @@
+"""Public application and window API surface.
+
+Application, window management, menu, and shortcuts functionality.
+"""
+
+from __future__ import annotations
+
+from bootstack.runtime.app import App, AppSettings, Window, get_app_settings, get_current_app
+from bootstack.runtime.toplevel import Toplevel
+from bootstack.runtime.menu import MenuManager, create_menu
+from bootstack.runtime.shortcuts import Shortcuts, Shortcut, get_shortcuts
+from bootstack.widgets.composites.appshell import AppShell
+
+__all__ = [
+    # Application
+    "App",
+    "AppShell",
+    "Window",
+    "Toplevel",
+    "AppSettings",
+    "get_current_app",
+    "get_app_settings",
+    # Menu
+    "MenuManager",
+    "create_menu",
+    # Shortcuts
+    "Shortcuts",
+    "Shortcut",
+    "get_shortcuts",
+]

bootstack/api/constants.py

@@ -0,0 +1,3 @@
+"""Re-export of bootstack constants for the public API surface."""
+
+from bootstack.constants import *  # noqa: F401,F403

bootstack/api/data.py

@@ -0,0 +1,23 @@
+"""Public data source API surface.
+
+Provides unified interface for data management with multiple backend implementations.
+"""
+
+from __future__ import annotations
+
+from bootstack.datasource.base import BaseDataSource
+from bootstack.datasource.memory_source import MemoryDataSource
+from bootstack.datasource.sqlite_source import SqliteDataSource
+from bootstack.datasource.file_source import FileDataSource, FileSourceConfig
+from bootstack.datasource.types import DataSourceProtocol, Primitive, Record
+
+__all__ = [
+    "BaseDataSource",
+    "MemoryDataSource",
+    "SqliteDataSource",
+    "FileDataSource",
+    "FileSourceConfig",
+    "DataSourceProtocol",
+    "Primitive",
+    "Record",
+]

bootstack/api/dialogs.py

@@ -0,0 +1,44 @@
+"""Public dialogs API surface.
+
+Bootstrap-styled dialogs for common interactions.
+"""
+
+from __future__ import annotations
+
+from bootstack.dialogs import (
+    # Base / core dialogs
+    Dialog,
+    DialogButton,
+    FilterDialog,
+    FormDialog,
+    MessageDialog,
+    QueryDialog,
+    DateDialog,
+    FontDialog,
+    # Facades
+    MessageBox,
+    QueryBox,
+    # Color tools
+    ColorChooser,
+    ColorChooserDialog,
+    ColorDropperDialog,
+)
+
+__all__ = [
+    # Base / core dialogs
+    "Dialog",
+    "DialogButton",
+    "FilterDialog",
+    "FormDialog",
+    "MessageDialog",
+    "QueryDialog",
+    "DateDialog",
+    "FontDialog",
+    # Facades
+    "MessageBox",
+    "QueryBox",
+    # Color tools
+    "ColorChooser",
+    "ColorChooserDialog",
+    "ColorDropperDialog",
+]

bootstack/api/i18n.py

@@ -0,0 +1,17 @@
+"""Public internationalization API surface.
+
+Message translation and locale-aware value formatting.
+"""
+
+from __future__ import annotations
+
+from bootstack.core.localization.msgcat import MessageCatalog
+from bootstack.core.localization.specs import L, LV
+from bootstack.core.localization.intl_format import IntlFormatter
+
+__all__ = [
+    "MessageCatalog",
+    "L",
+    "LV",
+    "IntlFormatter",
+]

bootstack/api/localization.py

@@ -0,0 +1,16 @@
+"""Localization API for bootstack.
+
+This module provides the public API for internationalization and localization,
+including message translation and locale-aware value formatting.
+"""
+
+from bootstack.core.localization.msgcat import MessageCatalog
+from bootstack.core.localization.specs import L, LV
+from bootstack.core.localization.intl_format import IntlFormatter
+
+__all__ = [
+    "MessageCatalog",
+    "L",
+    "LV",
+    "IntlFormatter"
+]

bootstack/api/menu.py

@@ -0,0 +1,7 @@
+"""Public menu-related API surface."""
+
+from __future__ import annotations
+
+from bootstack.runtime.menu import MenuManager, create_menu
+
+__all__ = ["MenuManager", "create_menu"]

bootstack/api/style.py

@@ -0,0 +1,23 @@
+"""Public style-related API surface."""
+
+from __future__ import annotations
+
+from ttkbootstrap_icons_bs import BootstrapIcon
+
+from bootstack.style.style import (Style, get_style, get_style_builder, get_theme, get_theme_color,
+                                      get_theme_provider, set_theme, toggle_theme, get_themes)
+from bootstack.style.typography import Font
+
+__all__ = [
+    "BootstrapIcon",
+    "Font",
+    "Style",
+    "get_style",
+    "get_style_builder",
+    "get_theme",
+    "set_theme",
+    "toggle_theme",
+    "get_theme_provider",
+    "get_theme_color",
+    "get_themes",
+]

bootstack/api/utils.py

@@ -0,0 +1,24 @@
+"""Public utilities API surface.
+
+Core utilities for reactive programming, validation, and extended variables.
+"""
+
+from __future__ import annotations
+
+from bootstack.core.images import Image
+from bootstack.core.signals import Signal, TraceOperation
+from bootstack.core.validation import ValidationRule, ValidationResult
+from bootstack.core.variables import SetVar
+
+__all__ = [
+    # Images
+    "Image",
+    # Signals (reactive state)
+    "Signal",
+    "TraceOperation",
+    # Validation
+    "ValidationRule",
+    "ValidationResult",
+    # Extended variables
+    "SetVar",
+]