ttkbootstrap 2.1.0__tar.gz → 2.2.0__tar.gz

{ttkbootstrap-2.1.0/src/ttkbootstrap.egg-info → ttkbootstrap-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ttkbootstrap
-Version: 2.1.0
+Version: 2.2.0
 Summary: A supercharged theme extension for tkinter that enables on-demand modern flat style themes inspired by Bootstrap.
 Author-email: Israel Dryer <israel.dryer@gmail.com>
 License-Expression: MIT AND (Apache-2.0 OR BSD-2-Clause)
@@ -66,6 +66,12 @@ tkinter's, and everything you already know about tkinter still applies.
 python -m pip install ttkbootstrap
 ```
 
+Then see it running — this opens a window with every widget and a theme picker:
+
+```bash
+ttkb demo
+```
+
 ## Quickstart
 
 ```python
@@ -115,6 +121,26 @@ app.toggle_theme()                # flip light <-> dark
 Browse them in the
 [themes gallery](https://ttkbootstrap.readthedocs.io/en/latest/themes.html).
 
+Design your own with the bundled editor — pick colors, preview them on live
+widgets, and export a `Theme(...)` snippet for your app:
+
+```bash
+ttkb creator
+```
+
+## Command line
+
+Installing ttkbootstrap installs `ttkb`:
+
+| Command | What it does |
+| --- | --- |
+| `ttkb version` | Print the installed version |
+| `ttkb demo` | Open the widget demo |
+| `ttkb convert-theme <file>` | Convert a 1.x theme file to the 2.x `Theme(...)` form |
+| `ttkb creator` | Open ttkcreator, the theme designer |
+
+See the [command-line reference](https://ttkbootstrap.readthedocs.io/en/latest/reference/cli.html).
+
 ## Documentation
 
 - **[Documentation](https://ttkbootstrap.readthedocs.io/en/latest/)** — guides, the widget catalog, and the API reference.
@@ -131,6 +157,13 @@ deprecation warning. The
 [Migrating to 2.0](https://ttkbootstrap.readthedocs.io/en/latest/user-guide/getting-started/migrating.html)
 guide sorts every change into breaking / deprecated / notable / new.
 
+Custom themes moved out of the package and into your own code. To bring one
+forward, convert the file 1.x saved:
+
+```bash
+ttkb convert-theme user.py -o brand.py
+```
+
 ## Icons
 
 ttkbootstrap ships with the full [Bootstrap Icons](https://icons.getbootstrap.com/)
@@ -142,8 +175,8 @@ ttk.Button(app, text="Settings", icon="gear-fill", bootstyle="primary")
 ```
 
 Need other icon families — Font Awesome, Material, Lucide, and more? The
-[ttkbootstrap-icons](https://github.com/israel-dryer/ttkbootstrap-icons) extension
-is still available and adds installable icon providers alongside the built-in set.
+[tkinter-icons](https://github.com/israel-dryer/tkinter-icons) extension adds
+sixteen icon sets (61,000+ icons) alongside the built-in set.
 
 ## Contributing
 

{ttkbootstrap-2.1.0 → ttkbootstrap-2.2.0}/README.md

@@ -39,6 +39,12 @@ tkinter's, and everything you already know about tkinter still applies.
 python -m pip install ttkbootstrap
 ```
 
+Then see it running — this opens a window with every widget and a theme picker:
+
+```bash
+ttkb demo
+```
+
 ## Quickstart
 
 ```python
@@ -88,6 +94,26 @@ app.toggle_theme()                # flip light <-> dark
 Browse them in the
 [themes gallery](https://ttkbootstrap.readthedocs.io/en/latest/themes.html).
 
+Design your own with the bundled editor — pick colors, preview them on live
+widgets, and export a `Theme(...)` snippet for your app:
+
+```bash
+ttkb creator
+```
+
+## Command line
+
+Installing ttkbootstrap installs `ttkb`:
+
+| Command | What it does |
+| --- | --- |
+| `ttkb version` | Print the installed version |
+| `ttkb demo` | Open the widget demo |
+| `ttkb convert-theme <file>` | Convert a 1.x theme file to the 2.x `Theme(...)` form |
+| `ttkb creator` | Open ttkcreator, the theme designer |
+
+See the [command-line reference](https://ttkbootstrap.readthedocs.io/en/latest/reference/cli.html).
+
 ## Documentation
 
 - **[Documentation](https://ttkbootstrap.readthedocs.io/en/latest/)** — guides, the widget catalog, and the API reference.
@@ -104,6 +130,13 @@ deprecation warning. The
 [Migrating to 2.0](https://ttkbootstrap.readthedocs.io/en/latest/user-guide/getting-started/migrating.html)
 guide sorts every change into breaking / deprecated / notable / new.
 
+Custom themes moved out of the package and into your own code. To bring one
+forward, convert the file 1.x saved:
+
+```bash
+ttkb convert-theme user.py -o brand.py
+```
+
 ## Icons
 
 ttkbootstrap ships with the full [Bootstrap Icons](https://icons.getbootstrap.com/)
@@ -115,8 +148,8 @@ ttk.Button(app, text="Settings", icon="gear-fill", bootstyle="primary")
 ```
 
 Need other icon families — Font Awesome, Material, Lucide, and more? The
-[ttkbootstrap-icons](https://github.com/israel-dryer/ttkbootstrap-icons) extension
-is still available and adds installable icon providers alongside the built-in set.
+[tkinter-icons](https://github.com/israel-dryer/tkinter-icons) extension adds
+sixteen icon sets (61,000+ icons) alongside the built-in set.
 
 ## Contributing
 

{ttkbootstrap-2.1.0 → ttkbootstrap-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ttkbootstrap"
-version = "2.1.0"
+version = "2.2.0"
 description = "A supercharged theme extension for tkinter that enables on-demand modern flat style themes inspired by Bootstrap."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -49,6 +49,13 @@ dependencies = ["pillow>=10,<13"]
 Homepage = "https://github.com/israel-dryer/ttkbootstrap"
 Documentation = "https://ttkbootstrap.readthedocs.io/en/latest/"
 
+[project.scripts]
+# Two names for one command: `ttkbootstrap` is guessable from the package name,
+# `ttkb` is what anyone types twice. When the scripts directory is not on PATH,
+# `python -m ttkbootstrap.cli <command>` runs the same thing.
+ttkbootstrap = "ttkbootstrap.cli:main"
+ttkb = "ttkbootstrap.cli:main"
+
 [tool.setuptools.packages.find]
 where = ["src"]
 
@@ -56,7 +63,11 @@ where = ["src"]
 # app_icons ships only the two runtime assets built by tools/make_app_ico.py
 # (the .ico for Windows, the .png for macOS/Linux). The per-size source PNGs live
 # in the repo-root assets/app_icons/ and are build inputs, not shipped.
-"ttkbootstrap" = ["themes/*.json", "assets/*", "assets/icons/*", "assets/elements/*", "assets/app_icons/ttkbootstrap.ico", "assets/app_icons/ttkbootstrap.png"]
+# py.typed and the generated __init__.pyi are listed explicitly: MANIFEST.in's
+# graft already sweeps them in, but the stub is what restores widget parameters
+# in an IDE (#1327), so a wheel that quietly ships without it is a silent
+# regression rather than a visible failure.
+"ttkbootstrap" = ["py.typed", "*.pyi", "themes/*.json", "assets/*", "assets/icons/*", "assets/elements/*", "assets/app_icons/ttkbootstrap.ico", "assets/app_icons/ttkbootstrap.png"]
 
 [tool.pytest.ini_options]
 # Only the headless suite under tests/ is collected. Interactive mainloop()

{ttkbootstrap-2.1.0 → ttkbootstrap-2.2.0}/src/ttkbootstrap/__init__.py

@@ -37,6 +37,11 @@ bootstyle)`.
 
 For more information, see: https://ttkbootstrap.readthedocs.io/
 """
+from importlib.metadata import (
+    PackageNotFoundError as _PackageNotFoundError,
+    version as _distribution_version,
+)
+
 from tkinter import (
     Menu as _tkMenu, Text as _tkText, Canvas as _tkCanvas, Tk as _tkTk,
     Frame as _tkFrame, Label as _tkLabel,
@@ -100,6 +105,20 @@ from ttkbootstrap.utils import (
     set_global_family,
 )
 
+try:
+    #: The installed distribution's version, e.g. `"2.2.0"`.
+    #
+    # Read from the installed metadata rather than written here, so
+    # `pyproject.toml` stays the one place the version literal lives. The
+    # consequence is that this reports what was *installed*: an editable install
+    # keeps whatever metadata it was built with until it is reinstalled.
+    __version__ = _distribution_version("ttkbootstrap")
+except _PackageNotFoundError:
+    # Running from a source tree that was never installed (e.g. PYTHONPATH=src)
+    # -- there is no metadata to read, and guessing one would be worse than
+    # saying so.
+    __version__ = "unknown"
+
 
 # --------------------------------------------------------------------------- #
 # Concrete ttk widget classes — the blessed `bootstyle` set.