config-cli-gui 0.3.3__tar.gz → 0.3.4__tar.gz

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/HISTORY.md

@@ -4,6 +4,14 @@ Changelog
 
 (unreleased)
 ------------
+- Bugfix: init color display properly. [Paul Magister]
+- Use ttkbootstrap gui styles. [Paul Magister]
+- Improve GUI scaling and font sizes. [Paul Magister]
+
+
+0.3.3 (2026-06-13)
+------------------
+- Docs: Update HISTORY.md for release 0.3.3. [Paul Magister]
 - Update to minimum python 3.11. [Paul Magister]
 
 

{config_cli_gui-0.3.3/src/config_cli_gui.egg-info → config_cli_gui-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: config-cli-gui
-Version: 0.3.3
+Version: 0.3.4
 Summary: Feature-rich Python project template for config-cli-gui.
 Author: pamagister
 Requires-Python: <3.12,>=3.11
@@ -9,6 +9,7 @@ License-File: LICENSE
 Requires-Dist: pydantic>=2.11.7
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: pillow>=12.0.0
+Requires-Dist: ttkbootstrap>=1.20.3
 Provides-Extra: dev
 Requires-Dist: pytest>=8.4.0; extra == "dev"
 Requires-Dist: pytest-mock>=3.14.1; extra == "dev"

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/config.yaml

@@ -27,8 +27,8 @@ app:
   # Enable logging to console | type=bool | choices=[True, False]
   enable_console_logging: true
 gui:
-  # GUI theme setting | type=str | choices=['light', 'dark', 'auto']
-  theme: light
+  # GUI theme setting suppoerted by ttkbootstrap | type=str | choices=['cosmo', 'flatly', 'litera', 'minty', 'lumen', 'sandstone', 'yeti', 'pulse', 'united', 'darkly', 'superhero', 'solar', 'cyborg', 'vapor', 'simplex']
+  theme: darkly
   # Default window width | type=int
   window_width: 800
   # Default window height | type=int

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/docs/usage/config.md

@@ -28,16 +28,16 @@ The parameters in the cli category can be accessed via the command line interfac
 
 ## Category "gui"
 
-| Name              | Type   | Description                                    | Default               | Choices                   |
-|-------------------|--------|------------------------------------------------|-----------------------|---------------------------|
-| theme             | str    | GUI theme setting                              | 'light'               | ['light', 'dark', 'auto'] |
-| window_width      | int    | Default window width                           | 800                   | -                         |
-| window_height     | int    | Default window height                          | 600                   | -                         |
-| log_window_height | int    | Height of the log window in pixels             | 200                   | -                         |
-| auto_scroll_log   | bool   | Automatically scroll to the newest log entries | True                  | [True, False]             |
-| max_log_lines     | int    | Maximum number of log lines to keep in GUI     | 1000                  | -                         |
-| point2D           | Vector | Point in 2D space                              | Vector(7, 11)         | -                         |
-| point3D           | Vector | Point in 3D space                              | Vector(1.2, 3.4, 5.6) | -                         |
+| Name              | Type   | Description                                    | Default               | Choices                                                                                                                                               |
+|-------------------|--------|------------------------------------------------|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
+| theme             | str    | GUI theme setting suppoerted by ttkbootstrap   | 'darkly'              | ['cosmo', 'flatly', 'litera', 'minty', 'lumen', 'sandstone', 'yeti', 'pulse', 'united', 'darkly', 'superhero', 'solar', 'cyborg', 'vapor', 'simplex'] |
+| window_width      | int    | Default window width                           | 800                   | -                                                                                                                                                     |
+| window_height     | int    | Default window height                          | 600                   | -                                                                                                                                                     |
+| log_window_height | int    | Height of the log window in pixels             | 200                   | -                                                                                                                                                     |
+| auto_scroll_log   | bool   | Automatically scroll to the newest log entries | True                  | [True, False]                                                                                                                                         |
+| max_log_lines     | int    | Maximum number of log lines to keep in GUI     | 1000                  | -                                                                                                                                                     |
+| point2D           | Vector | Point in 2D space                              | Vector(7, 11)         | -                                                                                                                                                     |
+| point3D           | Vector | Point in 3D space                              | Vector(1.2, 3.4, 5.6) | -                                                                                                                                                     |
 
 ## Category "misc"
 

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/pyproject.toml

@@ -11,6 +11,7 @@ dependencies = [
     "pydantic>=2.11.7",
     "pyyaml>=6.0.2",
     "pillow>=12.0.0",
+    "ttkbootstrap>=1.20.3",
 ]
 
 # Dev dependencies as optional dependencies

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/src/config_cli_gui/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.3.3'
-__version_tuple__ = version_tuple = (0, 3, 3)
+__version__ = version = '0.3.4'
+__version_tuple__ = version_tuple = (0, 3, 4)
 
-__commit_id__ = commit_id = 'gbc73a5894'
+__commit_id__ = commit_id = 'gf109662f6'

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/src/config_cli_gui/config.py

@@ -63,21 +63,25 @@ class ConfigSerializer:
     TYPE_MAPPING = {
         Font: {
             "to_serializable": lambda v: v.to_str(),
-            "from_serializable": lambda v: Font.from_list(v)
-            if isinstance(v, list)
-            else Font.from_str(v),
+            "from_serializable": lambda v: (
+                Font.from_list(v) if isinstance(v, list) else Font.from_str(v)
+            ),
         },
         Color: {
             "to_serializable": lambda v: v.to_hex(),
-            "from_serializable": lambda v: Color.from_list(v)
-            if isinstance(v, list)
-            else (Color.from_hex(v) if isinstance(v, str) else v),
+            "from_serializable": lambda v: (
+                Color.from_list(v)
+                if isinstance(v, list)
+                else (Color.from_hex(v) if isinstance(v, str) else v)
+            ),
         },
         Vector: {
             "to_serializable": lambda v: v.to_str(),
-            "from_serializable": lambda v: Vector.from_list(v)
-            if isinstance(v, list)
-            else (Vector.from_str(v) if isinstance(v, str) else v),
+            "from_serializable": lambda v: (
+                Vector.from_list(v)
+                if isinstance(v, list)
+                else (Vector.from_str(v) if isinstance(v, str) else v)
+            ),
         },
         Path: {
             "to_serializable": lambda v: str(v.as_posix()),
@@ -85,7 +89,7 @@ class ConfigSerializer:
         },
         datetime: {
             "to_serializable": lambda v: v.isoformat(),
-            "from_serializable": lambda v: datetime.fromisoformat(v) if isinstance(v, str) else v,
+            "from_serializable": lambda v: (datetime.fromisoformat(v) if isinstance(v, str) else v),
         },
     }
 

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/src/config_cli_gui/docs.py

@@ -16,13 +16,15 @@ class DocumentationGenerator:
         def pad(s, width):
             return s + " " * (width - len(s))
 
-        markdown_content = dedent("""
+        markdown_content = dedent(
+            """
             # Configuration Parameters
 
             These parameters are available to configure the behavior of your application.
             The parameters in the cli category can be accessed via the command line interface.
 
-            """).lstrip()
+            """
+        ).lstrip()
 
         for category_name, category in self.config_manager._categories.items():
             markdown_content += f'## Category "{category_name}"\n\n'
@@ -165,13 +167,15 @@ class DocumentationGenerator:
                 continue
             example_value = param.choices[0] if param.choices else param.value
             examples.append(
-                dedent(f"""
+                dedent(
+                    f"""
                 ### {i}. With {param.name} parameter
 
                 ```bash
                 python -m {app_name} --{param.name} {example_value} {required_arg}
                 ```
-                """)
+                """
+                )
             )
 
         markdown = dedent(

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/src/config_cli_gui/gui.py

@@ -8,6 +8,7 @@ from datetime import datetime
 from pathlib import Path
 from tkinter import colorchooser, filedialog, messagebox, ttk
 
+import ttkbootstrap
 from PIL import Image, ImageDraw, ImageTk
 
 from config_cli_gui.config import (
@@ -205,7 +206,11 @@ class GenericSettingsDialog:
     """Generic settings dialog for ConfigManager."""
 
     def __init__(
-        self, parent, config_manager: ConfigManager, title="Settings", config_file="config.yaml"
+        self,
+        parent: ttkbootstrap.Window | tk.Tk,
+        config_manager: ConfigManager,
+        title="Settings",
+        config_file="config.yaml",
     ):
         self.parent = parent
         self.config_manager = config_manager
@@ -246,6 +251,10 @@ class GenericSettingsDialog:
         button_frame = ttk.Frame(main_frame)
         button_frame.pack(fill=tk.X, pady=(10, 0))
 
+        # Apply: apply current settings (in-memory) but keep dialog open
+        ttk.Button(button_frame, text="Apply", command=self._on_apply).pack(
+            side=tk.RIGHT, padx=(5, 0)
+        )
         ttk.Button(button_frame, text="OK", command=self._on_ok).pack(side=tk.RIGHT, padx=(5, 0))
         ttk.Button(button_frame, text="Cancel", command=self._on_cancel).pack(side=tk.RIGHT)
 
@@ -429,6 +438,7 @@ class GenericSettingsDialog:
 
         pick_btn = ttk.Button(frame, text="Pick", command=pick_color)
         pick_btn.pack(side=tk.LEFT, padx=(5, 0))
+        color_display.config(bg=color_value.to_hex())
 
         def on_color_change(*args):
             try:
@@ -450,7 +460,11 @@ class GenericSettingsDialog:
         # Font type
         font_type_var = tk.StringVar(value=os.path.basename(font_value.name))
         font_type_combo = ttk.Combobox(
-            frame, textvariable=font_type_var, values=Font.font_names, state="readonly", width=25
+            frame,
+            textvariable=font_type_var,
+            values=Font.font_names,
+            state="readonly",
+            width=25,
         )
         font_type_combo.pack(side=tk.LEFT, padx=(0, 5))
 
@@ -463,6 +477,7 @@ class GenericSettingsDialog:
         color_var = tk.StringVar(value=font_value.color.to_hex())
         color_display = tk.Label(frame, width=8, bg=font_value.color.to_hex())
         color_display.pack(side=tk.LEFT, padx=(8, 2))
+        color_display.config(bg=font_value.color.to_hex())
 
         def pick_color():
             color = colorchooser.askcolor(color=color_var.get())
@@ -503,7 +518,11 @@ class GenericSettingsDialog:
             text = "Sample"
 
             draw.text(
-                (img_width / 2, img_height / 2), text, fill=font_color_hex, font=font, anchor="mm"
+                (img_width / 2, img_height / 2),
+                text,
+                fill=font_color_hex,
+                font=font,
+                anchor="mm",
             )
 
             photo = ImageTk.PhotoImage(img)
@@ -617,66 +636,81 @@ class GenericSettingsDialog:
     def _on_ok(self):
         """Handle OK button click."""
         try:
-            # Update configuration with widget values
-            overrides = {}
-            for key, widget in self.widgets.items():
-                category_name, param_name = key.split("__", 1)
-                category = self.config_manager.get_category(category_name)
-                param_value = getattr(category, param_name).value
-
-                if isinstance(param_value, Font):
-                    selected_font_name = widget.font_type_var.get()
-                    font_type = selected_font_name
-                    font_size = widget.font_size_var.get()
-                    font_color = Color.from_hex(widget.color_var.get())
-                    overrides[key] = Font(font_type, font_size, font_color)
-                    continue
-
-                if isinstance(param_value, Vector):
-                    components = [v.get() for v in widget.vars]
-                    overrides[key] = Vector.from_list(components)
-                    continue
-
-                value = widget.var.get()
-
-                # Convert value to appropriate type
-                if type(param_value) == bool:
-                    overrides[key] = value
-                elif type(param_value) == Path:
-                    overrides[key] = Path(value)
-                elif type(param_value) == Color:
-                    overrides[key] = Color.from_hex(value)
-                elif type(param_value) == datetime:
-                    overrides[key] = datetime.strptime(value, "%Y-%m-%d %H:%M")
-                elif type(param_value) in (list, tuple):
-                    # Parse comma-separated values
-                    items = [item.strip() for item in value.split(",") if item.strip()]
-                    overrides[key] = type(param_value)(items)
-                elif type(param_value) == dict:
-                    # Parse JSON format
-                    import json
-
-                    overrides[key] = json.loads(value)
-                elif type(param_value) == int:
-                    overrides[key] = int(value)
-                elif type(param_value) == float:
-                    overrides[key] = float(value)
-                else:
-                    overrides[key] = value
-
-            # Apply overrides to config manager
-            self.config_manager.apply_overrides(overrides)
-
-            # Save to file
-            self.config_manager.save_to_file(self.config_file)
-
-            self.result = "ok"
+            self.__persist_settings()
             self.dialog.destroy()
 
         except Exception as e:
             messagebox.showerror("Error", f"Failed to save configuration: {e}")
 
+    def __persist_settings(self):
+        # Update configuration with widget values
+        overrides = {}
+        for key, widget in self.widgets.items():
+            category_name, param_name = key.split("__", 1)
+            category = self.config_manager.get_category(category_name)
+            param_value = getattr(category, param_name).value
+
+            if isinstance(param_value, Font):
+                selected_font_name = widget.font_type_var.get()
+                font_type = selected_font_name
+                font_size = widget.font_size_var.get()
+                font_color = Color.from_hex(widget.color_var.get())
+                overrides[key] = Font(font_type, font_size, font_color)
+                continue
+
+            if isinstance(param_value, Vector):
+                components = [v.get() for v in widget.vars]
+                overrides[key] = Vector.from_list(components)
+                continue
+
+            value = widget.var.get()
+
+            # Convert value to appropriate type
+            if type(param_value) == bool:
+                overrides[key] = value
+            elif type(param_value) == Path:
+                overrides[key] = Path(value)
+            elif type(param_value) == Color:
+                overrides[key] = Color.from_hex(value)
+            elif type(param_value) == datetime:
+                overrides[key] = datetime.strptime(value, "%Y-%m-%d %H:%M")
+            elif type(param_value) in (list, tuple):
+                # Parse comma-separated values
+                items = [item.strip() for item in value.split(",") if item.strip()]
+                overrides[key] = type(param_value)(items)
+            elif type(param_value) == dict:
+                # Parse JSON format
+                import json
+
+                overrides[key] = json.loads(value)
+            elif type(param_value) == int:
+                overrides[key] = int(value)
+            elif type(param_value) == float:
+                overrides[key] = float(value)
+            else:
+                overrides[key] = value
+
+        # Apply overrides to config manager (in-memory)
+        self.config_manager.apply_overrides(overrides)
+
+        # Persist to file
+        self.config_manager.save_to_file(self.config_file)
+
+        self.result = "ok"
+
     def _on_cancel(self):
         """Handle Cancel button click."""
         self.result = "cancel"
         self.dialog.destroy()
+
+    def _on_apply(self):
+        """Apply current settings without closing the dialog.
+
+        This applies the widget values to the in-memory configuration and
+        applies the theme change live if the GUI theme parameter is present.
+        """
+        try:
+            self.__persist_settings()
+
+        except Exception as e:
+            messagebox.showerror("Error", f"Failed to save configuration: {e}")

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4/src/config_cli_gui.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: config-cli-gui
-Version: 0.3.3
+Version: 0.3.4
 Summary: Feature-rich Python project template for config-cli-gui.
 Author: pamagister
 Requires-Python: <3.12,>=3.11
@@ -9,6 +9,7 @@ License-File: LICENSE
 Requires-Dist: pydantic>=2.11.7
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: pillow>=12.0.0
+Requires-Dist: ttkbootstrap>=1.20.3
 Provides-Extra: dev
 Requires-Dist: pytest>=8.4.0; extra == "dev"
 Requires-Dist: pytest-mock>=3.14.1; extra == "dev"

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/src/config_cli_gui.egg-info/requires.txt

@@ -1,6 +1,7 @@
 pydantic>=2.11.7
 pyyaml>=6.0.2
 pillow>=12.0.0
+ttkbootstrap>=1.20.3
 
 [dev]
 pytest>=8.4.0

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/tests/example_project/config/config_example.py

@@ -8,6 +8,7 @@ and documentation from the parameter definitions.
 from datetime import datetime
 from pathlib import Path
 
+# import ttkbootstrap
 from config_cli_gui.config import (
     ConfigCategory,
     ConfigManager,
@@ -127,11 +128,28 @@ class GuiConfig(ConfigCategory):
     def get_category_name(self) -> str:
         return "gui"
 
+    # ttkbootstrap.Style().theme_names()
     theme: ConfigParameter = ConfigParameter(
         name="theme",
-        value="light",
-        choices=["light", "dark", "auto"],
-        help="GUI theme setting",
+        value="darkly",
+        choices=[
+            "cosmo",
+            "flatly",
+            "litera",
+            "minty",
+            "lumen",
+            "sandstone",
+            "yeti",
+            "pulse",
+            "united",
+            "darkly",
+            "superhero",
+            "solar",
+            "cyborg",
+            "vapor",
+            "simplex",
+        ],
+        help="GUI theme setting suppoerted by ttkbootstrap",
     )
 
     window_width: ConfigParameter = ConfigParameter(

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/tests/example_project/gui/gui_example.py

@@ -15,7 +15,9 @@ import traceback
 import webbrowser
 from functools import partial
 from pathlib import Path
-from tkinter import filedialog, messagebox, ttk
+from tkinter import filedialog, font, messagebox, ttk
+
+import ttkbootstrap
 
 from config_cli_gui.gui import SettingsDialogGenerator
 from config_cli_gui.logging import (
@@ -526,7 +528,19 @@ class MainGui:
 
 def main():
     """Main entry point for the GUI application."""
-    root = tk.Tk()
+
+    # Determine theme from configuration (fall back to sandstone on error)
+
+    _config = ProjectConfigManager("config.yaml")
+    theme_choice = _config.gui.theme.value
+
+    root: ttkbootstrap.Window = ttkbootstrap.Window(themename=theme_choice)
+
+    font.nametofont("TkDefaultFont").configure(size=11)
+    font.nametofont("TkTextFont").configure(size=11)
+    font.nametofont("TkMenuFont").configure(size=11)
+    font.nametofont("TkHeadingFont").configure(size=11)
+
     try:
         MainGui(root)
         root.mainloop()

{config_cli_gui-0.3.3 → config_cli_gui-0.3.4}/uv.lock

@@ -87,6 +87,7 @@ dependencies = [
     { name = "pillow" },
     { name = "pydantic" },
     { name = "pyyaml" },
+    { name = "ttkbootstrap" },
 ]
 
 [package.optional-dependencies]
@@ -130,6 +131,7 @@ requires-dist = [
     { name = "pytest-mock", marker = "extra == 'dev'", specifier = ">=3.14.1" },
     { name = "pyyaml", specifier = ">=6.0.2" },
     { name = "ruff", marker = "extra == 'dev'", specifier = ">=0.11.13" },
+    { name = "ttkbootstrap", specifier = ">=1.20.3" },
 ]
 provides-extras = ["dev", "docs"]
 
@@ -799,6 +801,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/77/b8/0135fadc89e73be292b473cb820b4f5a08197779206b33191e801feeae40/tomli-2.3.0-py3-none-any.whl", hash = "sha256:e95b1af3c5b07d9e643909b5abbec77cd9f1217e6d0bca72b0234736b9fb1f1b", size = 14408, upload-time = "2025-10-08T22:01:46.04Z" },
 ]
 
+[[package]]
+name = "ttkbootstrap"
+version = "1.20.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pillow" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/bd/88/bb1535edbd12e7b60223bee86241368b5d27043c001ef81d620ae8a56faf/ttkbootstrap-1.20.3.tar.gz", hash = "sha256:3350b80f79b0454c12558a7174c4bc4bd47905758843c3e8b0fbb19a0286fb69", size = 176262, upload-time = "2026-05-07T03:09:26.443Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/13/48/a5fd0d5d360e363f9bb289bef29b66103fd4ae1be1e3b6896a01b6e0f993/ttkbootstrap-1.20.3-py3-none-any.whl", hash = "sha256:95a05a4a663e3047be54edc220aa59c494a54f5c617a72a2c59a4bf634b97a5a", size = 191453, upload-time = "2026-05-07T03:09:24.935Z" },
+]
+
 [[package]]
 name = "typing-extensions"
 version = "4.15.0"