bootstack 0.1.0a1__tar.gz

bootstack-0.1.0a1/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2021 - 2026 Israel Dryer
+Portions copyright (c) 2021 - 2026 Israel Dryer and ttkbootstrap contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bootstack-0.1.0a1/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE
+include README.md
+
+graft src/bootstack
+
+global-exclude *.py[cod] __pycache__/* .DS_Store

bootstack-0.1.0a1/NOTICE

@@ -0,0 +1,10 @@
+bootstack
+Copyright (c) 2021 - 2026 Israel Dryer
+
+This project is derived from ttkbootstrap
+(https://github.com/israel-dryer/ttkbootstrap),
+Copyright (c) 2021 - 2026 Israel Dryer and ttkbootstrap contributors,
+licensed under the MIT License.
+
+The original ttkbootstrap license and copyright notice are preserved above
+in compliance with the MIT License terms.

bootstack-0.1.0a1/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: bootstack
+Version: 0.1.0a1
+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
+Project-URL: Homepage, https://github.com/israel-dryer/bootstack
+Project-URL: Documentation, https://bootstack.org/
+Keywords: tkinter,ttk,gui,desktop,python3,ui,widgets,theming,cross-platform,modern,framework,application-framework,desktop-ui,python-gui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: X11 Applications :: GTK
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: pillow<=12,>=10
+Requires-Dist: ttkbootstrap-icons>=4
+Requires-Dist: ttkbootstrap-icons-bs>=1
+Requires-Dist: typing-extensions>=4.10
+Requires-Dist: Babel>=2.12
+Requires-Dist: python-dateutil>=2.9
+Requires-Dist: dateparser>=1.1
+Requires-Dist: pywinstyles>=1.8; sys_platform == "win32"
+Requires-Dist: screeninfo>=0.8
+Dynamic: license-file
+
+![bootstack](assets/banner-readme.png)
+
+![](https://img.shields.io/github/release/israel-dryer/bootstack.svg)
+[![Downloads](https://pepy.tech/badge/bootstack)](https://pepy.tech/project/bootstack)
+[![Downloads](https://pepy.tech/badge/bootstack/month)](https://pepy.tech/project/bootstack)
+![](https://img.shields.io/github/issues/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/issues-closed/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/license/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/stars/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/forks/israel-dryer/bootstack.svg)
+
+
+**bootstack** is a batteries-included desktop application framework for Python, built on Tk. It grew out of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) — which brought Bootstrap-style theming to ttk widgets — and bundles the layers you'd expect from a modern framework around it: app scaffolding, layout containers, semantic styling, reactive signals, forms and validation, i18n, a data layer, and a CLI for scaffolding and packaging.
+
+The aim is to take you from `pip install` to a working, themed application without wiring those pieces together yourself or dropping down to raw Tk geometry calls.
+
+> **Active alpha.** APIs may change before the first stable release.
+> See the [documentation](https://bootstack.org) for guides and the API reference.
+
+## Installation
+
+Requires Python 3.12+.
+
+```bash
+pip install bootstack
+```
+
+## Quick Start
+
+```python
+import bootstack as bs
+
+app = bs.App(title="Hello bootstack", theme="bootstrap-light")
+
+bs.Label(app, text="Hello from bootstack!").pack(pady=10)
+bs.Button(app, text="Primary", accent="primary").pack(pady=5)
+bs.Button(app, text="Success", accent="success").pack(pady=5)
+bs.Button(app, text="Danger Outline", accent="danger", variant="outline").pack(pady=5)
+
+app.mainloop()
+```
+
+For navigation-based apps, use `AppShell` — it gives you a toolbar, sidebar, and page stack in one call:
+
+```python
+import bootstack as bs
+
+shell = bs.AppShell(title="My App", size=(1000, 650))
+
+home = shell.add_page("home", text="Home", icon="house")
+bs.Label(home, text="Welcome!").pack(padx=20, pady=20)
+
+docs = shell.add_page("docs", text="Documents", icon="file-earmark-text")
+bs.Label(docs, text="Your documents.").pack(padx=20, pady=20)
+
+shell.mainloop()
+```
+
+## How it works
+
+### Layout containers
+
+`PackFrame` and `GridFrame` let you describe a layout once instead of repeating geometry calls on each child:
+
+```python
+form = bs.GridFrame(app, columns=["auto", 1], gap=(12, 6), padding=12)
+form.pack(fill="both", expand=True)
+
+form.add(bs.Label(form, text="Name"))
+form.add(bs.Entry(form))
+form.add(bs.Label(form, text="Email"))
+form.add(bs.Entry(form))
+form.add(bs.Button(form, text="Submit", accent="primary"), columnspan=2)
+```
+
+### Semantic styling
+
+Widgets take an `accent` (color intent) and `variant` (visual weight) instead of hard-coded colors, so the same code looks right across themes and light/dark modes:
+
+```python
+bs.Button(app, text="Save", accent="primary")                       # solid (default)
+bs.Button(app, text="Cancel", accent="secondary", variant="outline")
+bs.Button(app, text="Learn more", accent="info", variant="link")
+bs.Label(app, text="Heading", font="heading-lg")
+```
+
+### Signals (optional)
+
+Plain callbacks work fine for most things. When state needs to flow between widgets, signals give you a small subscribe/get/set primitive:
+
+```python
+counter = bs.Signal(0)
+
+label = bs.Label(app)
+counter.subscribe(lambda v: label.configure(text=f"Count: {v}"))
+
+bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
+```
+
+## Features
+
+- **Application scaffolding** — `App` for blank windows, `AppShell` for toolbar + sidebar + page-stack apps, frameless windows with custom chrome
+- **60+ widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
+- **9 dialogs** — Message, Query, ColorChooser, ColorDropper, DateDialog, FontDialog, FilterDialog, FormDialog, plus a `Dialog` base
+- **Layout containers** — `PackFrame` and `GridFrame` for declarative layouts; `ScrollView`, `PanedWindow`, `Accordion`, `Card`, `Expander`
+- **Design system** — semantic `accent` colors (primary, secondary, success, danger, warning, info) and `variant` tokens (solid, outline, ghost, link, text), consistent across widgets
+- **Built-in themes** — paired light/dark variants (amber, aurora, bootstrap, classic, docs, forest, ocean, rose) with runtime theme switching and a custom-theme API
+- **Reactive signals** — observable state with subscribe/get/set, integrates with widgets via `signal=` / `textvariable=`
+- **Forms & validation** — `Form` and `Field` with built-in validators
+- **DataSource** — common interface over in-memory, SQLite, and file backends, with pagination, filtering, sorting, CRUD, and CSV export
+- **Localization (i18n)** — 23 bundled message catalogs, locale-aware number/date/time formatting via Babel, runtime language switching
+- **Icons & images** — icon handling with theme-aware recoloring, DPI scaling, and caching
+- **Platform support** — DPI awareness, multi-monitor centering, mica/acrylic effects on Windows
+- **CLI (`bootstack`)** — project scaffolding, run, add components, theme/i18n setup, doctor, build/package
+
+## Widget Categories
+
+| Category | Widgets |
+|----------|---------|
+| **Actions** | Button, ButtonGroup, MenuButton, DropdownButton, ContextMenu |
+| **Inputs** | TextEntry, PasswordEntry, PathEntry, NumericEntry, SpinnerEntry, Scale, ScrolledText, DateEntry, TimeEntry |
+| **Selection** | CheckButton, CheckToggle, RadioButton, RadioToggle, RadioGroup, ToggleGroup, OptionMenu, SelectBox, Calendar, Switch |
+| **Data Display** | Label, Badge, ListView, TreeView, TableView, Progressbar, Meter, FloodGauge |
+| **Layout** | Frame, PackFrame, GridFrame, LabelFrame, PanedWindow, ScrollView, Accordion, Card, Expander, Separator, SizeGrip |
+| **Navigation** | AppShell, Toolbar, SideNav, Tabs, PageStack |
+| **Dialogs** | MessageDialog, QueryDialog, ColorChooser, ColorDropper, DateDialog, FontDialog, FilterDialog, FormDialog |
+| **Overlays** | Toast, Tooltip |
+| **Forms** | Form, Field (with validation) |
+
+## CLI
+
+bootstack ships with an optional CLI for scaffolding, running, and packaging applications:
+
+```bash
+bootstack start MyApp                       # Create a new project (basic template)
+bootstack start MyApp --template appshell   # ...or with sidebar navigation
+bootstack run                               # Run the app defined in the project config
+bootstack add page Dashboard                # Add a new page (appshell)
+bootstack add view Settings                 # Add a new view (basic)
+bootstack add dialog Preferences            # Add a new dialog
+bootstack add theme my-brand                # Scaffold a custom theme
+bootstack add i18n --languages en es fr     # Add i18n support
+bootstack list themes                       # List available themes
+bootstack doctor                            # Diagnose project & environment
+bootstack build                             # Package for distribution
+```
+
+## Documentation
+
+- **Documentation**: https://bootstack.org
+- **Getting Started**: https://bootstack.org/getting-started/
+- **Guides**: https://bootstack.org/guides/
+- **Widgets**: https://bootstack.org/widgets/
+
+## Links
+
+- **GitHub**: https://github.com/israel-dryer/bootstack
+- **Icons**: https://github.com/israel-dryer/ttkbootstrap-icons
+
+## Acknowledgements
+
+bootstack is derived from [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) and continues that project's mission. See [`NOTICE`](NOTICE) for license attribution.

bootstack-0.1.0a1/README.md

@@ -0,0 +1,162 @@
+![bootstack](assets/banner-readme.png)
+
+![](https://img.shields.io/github/release/israel-dryer/bootstack.svg)
+[![Downloads](https://pepy.tech/badge/bootstack)](https://pepy.tech/project/bootstack)
+[![Downloads](https://pepy.tech/badge/bootstack/month)](https://pepy.tech/project/bootstack)
+![](https://img.shields.io/github/issues/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/issues-closed/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/license/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/stars/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/forks/israel-dryer/bootstack.svg)
+
+
+**bootstack** is a batteries-included desktop application framework for Python, built on Tk. It grew out of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) — which brought Bootstrap-style theming to ttk widgets — and bundles the layers you'd expect from a modern framework around it: app scaffolding, layout containers, semantic styling, reactive signals, forms and validation, i18n, a data layer, and a CLI for scaffolding and packaging.
+
+The aim is to take you from `pip install` to a working, themed application without wiring those pieces together yourself or dropping down to raw Tk geometry calls.
+
+> **Active alpha.** APIs may change before the first stable release.
+> See the [documentation](https://bootstack.org) for guides and the API reference.
+
+## Installation
+
+Requires Python 3.12+.
+
+```bash
+pip install bootstack
+```
+
+## Quick Start
+
+```python
+import bootstack as bs
+
+app = bs.App(title="Hello bootstack", theme="bootstrap-light")
+
+bs.Label(app, text="Hello from bootstack!").pack(pady=10)
+bs.Button(app, text="Primary", accent="primary").pack(pady=5)
+bs.Button(app, text="Success", accent="success").pack(pady=5)
+bs.Button(app, text="Danger Outline", accent="danger", variant="outline").pack(pady=5)
+
+app.mainloop()
+```
+
+For navigation-based apps, use `AppShell` — it gives you a toolbar, sidebar, and page stack in one call:
+
+```python
+import bootstack as bs
+
+shell = bs.AppShell(title="My App", size=(1000, 650))
+
+home = shell.add_page("home", text="Home", icon="house")
+bs.Label(home, text="Welcome!").pack(padx=20, pady=20)
+
+docs = shell.add_page("docs", text="Documents", icon="file-earmark-text")
+bs.Label(docs, text="Your documents.").pack(padx=20, pady=20)
+
+shell.mainloop()
+```
+
+## How it works
+
+### Layout containers
+
+`PackFrame` and `GridFrame` let you describe a layout once instead of repeating geometry calls on each child:
+
+```python
+form = bs.GridFrame(app, columns=["auto", 1], gap=(12, 6), padding=12)
+form.pack(fill="both", expand=True)
+
+form.add(bs.Label(form, text="Name"))
+form.add(bs.Entry(form))
+form.add(bs.Label(form, text="Email"))
+form.add(bs.Entry(form))
+form.add(bs.Button(form, text="Submit", accent="primary"), columnspan=2)
+```
+
+### Semantic styling
+
+Widgets take an `accent` (color intent) and `variant` (visual weight) instead of hard-coded colors, so the same code looks right across themes and light/dark modes:
+
+```python
+bs.Button(app, text="Save", accent="primary")                       # solid (default)
+bs.Button(app, text="Cancel", accent="secondary", variant="outline")
+bs.Button(app, text="Learn more", accent="info", variant="link")
+bs.Label(app, text="Heading", font="heading-lg")
+```
+
+### Signals (optional)
+
+Plain callbacks work fine for most things. When state needs to flow between widgets, signals give you a small subscribe/get/set primitive:
+
+```python
+counter = bs.Signal(0)
+
+label = bs.Label(app)
+counter.subscribe(lambda v: label.configure(text=f"Count: {v}"))
+
+bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
+```
+
+## Features
+
+- **Application scaffolding** — `App` for blank windows, `AppShell` for toolbar + sidebar + page-stack apps, frameless windows with custom chrome
+- **60+ widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
+- **9 dialogs** — Message, Query, ColorChooser, ColorDropper, DateDialog, FontDialog, FilterDialog, FormDialog, plus a `Dialog` base
+- **Layout containers** — `PackFrame` and `GridFrame` for declarative layouts; `ScrollView`, `PanedWindow`, `Accordion`, `Card`, `Expander`
+- **Design system** — semantic `accent` colors (primary, secondary, success, danger, warning, info) and `variant` tokens (solid, outline, ghost, link, text), consistent across widgets
+- **Built-in themes** — paired light/dark variants (amber, aurora, bootstrap, classic, docs, forest, ocean, rose) with runtime theme switching and a custom-theme API
+- **Reactive signals** — observable state with subscribe/get/set, integrates with widgets via `signal=` / `textvariable=`
+- **Forms & validation** — `Form` and `Field` with built-in validators
+- **DataSource** — common interface over in-memory, SQLite, and file backends, with pagination, filtering, sorting, CRUD, and CSV export
+- **Localization (i18n)** — 23 bundled message catalogs, locale-aware number/date/time formatting via Babel, runtime language switching
+- **Icons & images** — icon handling with theme-aware recoloring, DPI scaling, and caching
+- **Platform support** — DPI awareness, multi-monitor centering, mica/acrylic effects on Windows
+- **CLI (`bootstack`)** — project scaffolding, run, add components, theme/i18n setup, doctor, build/package
+
+## Widget Categories
+
+| Category | Widgets |
+|----------|---------|
+| **Actions** | Button, ButtonGroup, MenuButton, DropdownButton, ContextMenu |
+| **Inputs** | TextEntry, PasswordEntry, PathEntry, NumericEntry, SpinnerEntry, Scale, ScrolledText, DateEntry, TimeEntry |
+| **Selection** | CheckButton, CheckToggle, RadioButton, RadioToggle, RadioGroup, ToggleGroup, OptionMenu, SelectBox, Calendar, Switch |
+| **Data Display** | Label, Badge, ListView, TreeView, TableView, Progressbar, Meter, FloodGauge |
+| **Layout** | Frame, PackFrame, GridFrame, LabelFrame, PanedWindow, ScrollView, Accordion, Card, Expander, Separator, SizeGrip |
+| **Navigation** | AppShell, Toolbar, SideNav, Tabs, PageStack |
+| **Dialogs** | MessageDialog, QueryDialog, ColorChooser, ColorDropper, DateDialog, FontDialog, FilterDialog, FormDialog |
+| **Overlays** | Toast, Tooltip |
+| **Forms** | Form, Field (with validation) |
+
+## CLI
+
+bootstack ships with an optional CLI for scaffolding, running, and packaging applications:
+
+```bash
+bootstack start MyApp                       # Create a new project (basic template)
+bootstack start MyApp --template appshell   # ...or with sidebar navigation
+bootstack run                               # Run the app defined in the project config
+bootstack add page Dashboard                # Add a new page (appshell)
+bootstack add view Settings                 # Add a new view (basic)
+bootstack add dialog Preferences            # Add a new dialog
+bootstack add theme my-brand                # Scaffold a custom theme
+bootstack add i18n --languages en es fr     # Add i18n support
+bootstack list themes                       # List available themes
+bootstack doctor                            # Diagnose project & environment
+bootstack build                             # Package for distribution
+```
+
+## Documentation
+
+- **Documentation**: https://bootstack.org
+- **Getting Started**: https://bootstack.org/getting-started/
+- **Guides**: https://bootstack.org/guides/
+- **Widgets**: https://bootstack.org/widgets/
+
+## Links
+
+- **GitHub**: https://github.com/israel-dryer/bootstack
+- **Icons**: https://github.com/israel-dryer/ttkbootstrap-icons
+
+## Acknowledgements
+
+bootstack is derived from [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) and continues that project's mission. See [`NOTICE`](NOTICE) for license attribution.

bootstack-0.1.0a1/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bootstack"
+version = "0.1.0a1"
+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"
+license = "MIT"
+authors = [
+    { name = "Israel Dryer", email = "israel.dryer@gmail.com" }
+]
+keywords = [
+    "tkinter",
+    "ttk",
+    "gui",
+    "desktop",
+    "python3",
+    "ui",
+    "widgets",
+    "theming",
+    "cross-platform",
+    "modern",
+    "framework",
+    "application-framework",
+    "desktop-ui",
+    "python-gui"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Win32 (MS Windows)",
+    "Environment :: X11 Applications :: GTK",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: User Interfaces",
+    "Operating System :: OS Independent",
+]
+
+dependencies = [
+    "pillow>=10,<=12",
+    "ttkbootstrap-icons>=4",
+    "ttkbootstrap-icons-bs>=1",
+
+    # Backported typing primitives (Self, Unpack, ParamSpec, etc.)
+    "typing-extensions>=4.10",
+
+    # Runtime localization/formatting stack
+    "Babel>=2.12",
+    "python-dateutil>=2.9",
+    "dateparser>=1.1",
+
+    # Windows-specific: modern window effects (mica, acrylic, etc.)
+    "pywinstyles>=1.8; sys_platform == 'win32'",
+
+    # Multi-monitor support for proper window centering
+    "screeninfo>=0.8",
+]
+
+[project.optional-dependencies]
+
+[project.urls]
+Homepage = "https://github.com/israel-dryer/bootstack"
+Documentation = "https://bootstack.org/"
+
+[project.scripts]
+bootstack = "bootstack.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"bootstack" = [
+    "themes/*.json",
+    "assets/*",
+    # ship compiled gettext catalogs within the package
+    "assets/locales/**/LC_MESSAGES/*.mo",
+]

bootstack-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+