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

{config_cli_gui-0.3.4 → config_cli_gui-0.3.6}/.github/workflows/main.yml

@@ -63,7 +63,7 @@ jobs:
       fail-fast: false
       matrix:
         python-version: [ 3.11 ]
-        os: [ ubuntu-latest, macos-latest ]
+        os: [ ubuntu-latest ]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4

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

@@ -4,6 +4,32 @@ Changelog
 
 (unreleased)
 ------------
+- Dynamically set app name for config persistence. [Paul Magister]
+- Dynamically set app name for config persistence. [Paul Magister]
+
+
+0.3.5 (2026-06-18)
+------------------
+- Docs: Update HISTORY.md for release 0.3.5. [Paul Magister]
+- Improve gui. [Paul Magister]
+- Fix gui log issue: even better fix. [Paul Magister]
+- Fix gui log issue: [Paul Magister]
+
+  Previously the logger handler attempted to call the passed object like a function; GuiLogWriter provides write(), not a call. Because emit() swallowed exceptions, you saw nothing in the GUI log.
+  Now connect_gui_logging detects objects with .write() and registers the writer.write callable with the UI handler. GuiLogHandler.emit calls that callable, which writes to the text widget and the text appears.
+- Improve config consistency: correctly consider logging parameters.
+  [Paul Magister]
+- Improve config usage consistency: allways load last config. Move
+  AppConfig into config.py since it is used in the core lib component.
+  [Paul Magister]
+- Save last opened config to start there on the next session, move theme
+  to app category. [Paul Magister]
+- Do not run tests on macos. [Paul Magister]
+
+
+0.3.4 (2026-06-18)
+------------------
+- Docs: Update HISTORY.md for release 0.3.4. [Paul Magister]
 - Bugfix: init color display properly. [Paul Magister]
 - Use ttkbootstrap gui styles. [Paul Magister]
 - Improve GUI scaling and font sizes. [Paul Magister]

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: config-cli-gui
-Version: 0.3.4
+Version: 0.3.6
 Summary: Feature-rich Python project template for config-cli-gui.
 Author: pamagister
 Requires-Python: <3.12,>=3.11

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

@@ -1,3 +1,16 @@
+app:
+  # Date format to use | type=str
+  date_format: '%Y-%m-%d'
+  # Logging level for the application | type=str | choices=['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL']
+  log_level: INFO
+  # Maximum log file size in MB before rotation | type=int
+  log_file_max_size: 2
+  # Enable logging to file | type=bool | choices=[True, False]
+  enable_file_logging: true
+  # Enable logging to console | type=bool | choices=[True, False]
+  enable_console_logging: true
+  # GUI theme setting supported by ttkbootstrap | type=str | choices=['cosmo', 'flatly', 'litera', 'minty', 'lumen', 'sandstone', 'yeti', 'pulse', 'united', 'darkly', 'superhero', 'solar', 'cyborg', 'vapor', 'simplex']
+  theme: superhero
 cli:
   # Path to input (file or folder) | type=str | [CLI]
   input: ''
@@ -9,26 +22,7 @@ cli:
   extract_waypoints: true
   # Include elevation data in waypoints | type=bool | [CLI] | choices=[True, False]
   elevation: false
-app:
-  # Date format to use | type=str
-  date_format: '%Y-%m-%d'
-  # Logging level for the application | type=str | choices=['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL']
-  log_level: INFO
-  # Maximum log file size in MB before rotation | type=int
-  log_file_max_size: 10
-  # Number of backup log files to keep | type=int
-  log_backup_count: 5
-  # Log message format style | type=str | choices=['simple', 'detailed', 'json']
-  log_format: detailed
-  # Maximum number of worker threads | type=int
-  max_workers: 4
-  # Enable logging to file | type=bool | choices=[True, False]
-  enable_file_logging: true
-  # Enable logging to console | type=bool | choices=[True, False]
-  enable_console_logging: true
 gui:
-  # 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
@@ -40,21 +34,21 @@ gui:
   # Maximum number of log lines to keep in GUI | type=int
   max_log_lines: 1000
   # Point in 2D space | type=Vector
-  point2D: (7, 11)
+  point2D: (7.0, 11.0)
   # Point in 3D space | type=Vector
   point3D: (1.2, 3.4, 5.6)
 misc:
   # Example integer | type=int
   some_numeric: 42
   # Example vector 2D | type=Vector
-  some_vector2d: (1, 2)
+  some_vector2d: (1.0, 2.0)
   # Example vector 3D | type=Vector
   some_vector3d: (1.1, 2.2, 3.3)
-  # Path to the file to use | type=PosixPath
+  # Path to the file to use | type=str
   some_file: some_file.txt
   # Color setting for the application | type=Color
   some_color: '#ff0000'
   # Date setting for the application | type=datetime
-  some_date: '2025-12-31T10:30:45'
+  some_date: '2025-12-31T10:30:00'
   # Font setting for the application | type=Font
-  some_font: 'DejaVuSans.ttf, 12, #0000ff'
+  some_font: 'DejaVuSans.ttf, 12.0, #0000ff'

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

@@ -3,6 +3,17 @@
 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.
 
+## Category "app"
+
+| Name                   | Type | Description                                 | Default    | Choices                                                                                                                                               |
+|------------------------|------|---------------------------------------------|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
+| date_format            | str  | Date format to use                          | '%Y-%m-%d' | -                                                                                                                                                     |
+| log_level              | str  | Logging level for the application           | 'INFO'     | ['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL']                                                                                                     |
+| log_file_max_size      | int  | Maximum log file size in MB before rotation | 2          | -                                                                                                                                                     |
+| enable_file_logging    | bool | Enable logging to file                      | True       | [True, False]                                                                                                                                         |
+| enable_console_logging | bool | Enable logging to console                   | True       | [True, False]                                                                                                                                         |
+| theme                  | str  | GUI theme setting supported by ttkbootstrap | 'darkly'   | ['cosmo', 'flatly', 'litera', 'minty', 'lumen', 'sandstone', 'yeti', 'pulse', 'united', 'darkly', 'superhero', 'solar', 'cyborg', 'vapor', 'simplex'] |
+
 ## Category "cli"
 
 | Name              | Type | Description                                       | Default | Choices       |
@@ -13,31 +24,17 @@ The parameters in the cli category can be accessed via the command line interfac
 | extract_waypoints | bool | Extract starting points of each track as waypoint | True    | [True, False] |
 | elevation         | bool | Include elevation data in waypoints               | False   | [True, False] |
 
-## Category "app"
-
-| Name                   | Type | Description                                 | Default    | Choices                                           |
-|------------------------|------|---------------------------------------------|------------|---------------------------------------------------|
-| date_format            | str  | Date format to use                          | '%Y-%m-%d' | -                                                 |
-| log_level              | str  | Logging level for the application           | 'INFO'     | ['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'] |
-| log_file_max_size      | int  | Maximum log file size in MB before rotation | 10         | -                                                 |
-| log_backup_count       | int  | Number of backup log files to keep          | 5          | -                                                 |
-| log_format             | str  | Log message format style                    | 'detailed' | ['simple', 'detailed', 'json']                    |
-| max_workers            | int  | Maximum number of worker threads            | 4          | -                                                 |
-| enable_file_logging    | bool | Enable logging to file                      | True       | [True, False]                                     |
-| enable_console_logging | bool | Enable logging to console                   | True       | [True, False]                                     |
-
 ## Category "gui"
 
-| 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) | -                                                                                                                                                     |
+| Name              | Type   | Description                                    | Default               | Choices       |
+|-------------------|--------|------------------------------------------------|-----------------------|---------------|
+| 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.4 → config_cli_gui-0.3.6}/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.4'
-__version_tuple__ = version_tuple = (0, 3, 4)
+__version__ = version = '0.3.6'
+__version_tuple__ = version_tuple = (0, 3, 6)
 
-__commit_id__ = commit_id = 'gf109662f6'
+__commit_id__ = commit_id = 'g7d530e99f'

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

@@ -1,4 +1,5 @@
 import json
+import logging
 from abc import ABC, abstractmethod
 from collections.abc import Iterable
 from dataclasses import dataclass
@@ -9,6 +10,7 @@ from typing import Any
 import yaml
 from pydantic import BaseModel
 
+from config_cli_gui import persistence
 from config_cli_gui.configtypes.color import Color
 from config_cli_gui.configtypes.font import Font
 from config_cli_gui.configtypes.vector import Vector
@@ -108,6 +110,74 @@ class ConfigSerializer:
         return value
 
 
+class AppConfig(ConfigCategory):
+    """Application-specific configuration parameters (centralized).
+
+    This category was moved from example project to the core library so that
+    every project uses a consistent, non-editable application configuration
+    section. It contains general application settings such as logging and
+    theme preferences.
+    """
+
+    def get_category_name(self) -> str:
+        return "app"
+
+    date_format: ConfigParameter = ConfigParameter(
+        name="date_format",
+        value="%Y-%m-%d",
+        help="Date format to use",
+    )
+
+    log_level: ConfigParameter = ConfigParameter(
+        name="log_level",
+        value="INFO",
+        choices=["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"],
+        help="Logging level for the application",
+    )
+
+    log_file_max_size: ConfigParameter = ConfigParameter(
+        name="log_file_max_size",
+        value=2,
+        help="Maximum log file size in MB before rotation",
+    )
+
+    enable_file_logging: ConfigParameter = ConfigParameter(
+        name="enable_file_logging",
+        value=True,
+        help="Enable logging to file",
+    )
+
+    enable_console_logging: ConfigParameter = ConfigParameter(
+        name="enable_console_logging",
+        value=True,
+        help="Enable logging to console",
+    )
+
+    # ttkbootstrap.Style().theme_names()
+    theme: ConfigParameter = ConfigParameter(
+        name="theme",
+        value="darkly",
+        choices=[
+            "cosmo",
+            "flatly",
+            "litera",
+            "minty",
+            "lumen",
+            "sandstone",
+            "yeti",
+            "pulse",
+            "united",
+            "darkly",
+            "superhero",
+            "solar",
+            "cyborg",
+            "vapor",
+            "simplex",
+        ],
+        help="GUI theme setting supported by ttkbootstrap",
+    )
+
+
 class ConfigManager:
     """Manages loading, saving, and accessing configuration categories."""
 
@@ -119,7 +189,11 @@ class ConfigManager:
     ):
         self._categories: dict[str, ConfigCategory] = {}
         self._serializer = ConfigSerializer()
+        self.app: AppConfig = AppConfig()
+        # provide a default hook for application name retrieval; projects may
+        # override `get_app_name` on their concrete ConfigManager subclass.
 
+        categories = (self.app, *categories)
         for category in categories:
             if not isinstance(category, ConfigCategory):
                 raise TypeError(f"Expected ConfigCategory instance, got {type(category)}")
@@ -130,6 +204,14 @@ class ConfigManager:
 
         self.apply_overrides(overrides)
 
+    def get_app_name(self) -> str:
+        """Return the application identifier used by persistence helpers.
+
+        Projects can override this method in their concrete ConfigManager to
+        provide a different name "my-app-name"
+        """
+        return "config-cli-gui"
+
     def add_category(self, name: str, category: ConfigCategory) -> None:
         """Register a new configuration category."""
         self._categories[name] = category
@@ -167,6 +249,18 @@ class ConfigManager:
             data = yaml.safe_load(f) if path.suffix.lower() in [".yml", ".yaml"] else json.load(f)
 
         self._apply_config_data(data)
+        # Persist the information about the last used configuration file so the
+        # application can restore the same config on next start.
+        try:
+            persistence.write_last_used_config(self.get_app_name(), str(path))
+        except Exception:
+            # Persistence should not break normal config loading.
+            pass
+        try:
+            logging.getLogger("config_cli_gui").info(f"Loaded configuration from: {path}")
+        except Exception:
+            # Non-fatal: logging may not be configured yet.
+            pass
 
     def _apply_config_data(self, data: dict[str, Any]) -> None:
         """Apply loaded data to the configuration parameters."""
@@ -205,6 +299,28 @@ class ConfigManager:
         if file_format == "yaml":
             self._append_comments_to_yaml(path)
 
+        # Record the saved config as the last-used config as well.
+        try:
+            persistence.write_last_used_config(self.get_app_name(), str(path))
+        except Exception:
+            # Ignore persistence failures when saving
+            pass
+        try:
+            logging.getLogger("config_cli_gui").info(f"Saved configuration to: {path}")
+        except Exception:
+            # Non-fatal: logging may not be configured yet.
+            pass
+
+    def get_last_used_config(self) -> str | None:
+        """Return the last used config file path recorded by the persistence layer.
+
+        This is a convenience wrapper around persistence.read_last_used_config.
+        """
+        try:
+            return persistence.read_last_used_config(self.get_app_name())
+        except Exception:
+            return None
+
     def to_dict(self) -> dict[str, Any]:
         """Convert all configuration categories to a dictionary."""
         result: dict[str, dict[str, Any]] = {}

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

@@ -155,8 +155,12 @@ class CalendarDialog:
         button_frame = ttk.Frame(main_frame)
         button_frame.pack(fill=tk.X, pady=(10, 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)
+        ttk.Button(button_frame, text="OK", command=self._on_ok, width=10).pack(
+            side=tk.RIGHT, padx=(5, 0)
+        )
+        ttk.Button(button_frame, text="Cancel", command=self._on_cancel, width=10).pack(
+            side=tk.RIGHT
+        )
 
     def _update_calendar(self):
         """Update day spinbox based on selected month/year."""
@@ -213,7 +217,7 @@ class GenericSettingsDialog:
         config_file="config.yaml",
     ):
         self.parent = parent
-        self.config_manager = config_manager
+        self.config_manager: ConfigManager = config_manager
         self.config_file = config_file
         self.result = None
         self.widgets = {}
@@ -252,11 +256,15 @@ class GenericSettingsDialog:
         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(
+        ttk.Button(button_frame, text="Apply", command=self._on_apply, width=10).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)
+        ttk.Button(button_frame, text="OK", command=self._on_ok, width=10).pack(
+            side=tk.RIGHT, padx=(5, 0)
+        )
+        ttk.Button(button_frame, text="Cancel", command=self._on_cancel, width=10).pack(
+            side=tk.RIGHT
+        )
 
     def _create_category_tab(self, category_name: str, category):
         """Create a tab for a configuration category."""
@@ -297,13 +305,13 @@ class GenericSettingsDialog:
                 continue
             """
 
-            # Create label
-            label = ttk.Label(parent, text=f"{param.name}:")
-            label.grid(row=row, column=0, sticky="w", padx=5, pady=2)
+            # Create label (fixed width for alignment)
+            label = ttk.Label(parent, text=f"{param.name}:", width=28, anchor="w")
+            label.grid(row=row, column=0, sticky="w", padx=5, pady=4)
 
             # Create appropriate widget based on parameter type
             widget = self._create_parameter_widget(parent, param)
-            widget.grid(row=row, column=1, sticky="ew", padx=5, pady=2)
+            widget.grid(row=row, column=1, sticky="ew", padx=5, pady=4)
 
             # Add tooltip
             ToolTip(label, param.help)
@@ -407,10 +415,10 @@ class GenericSettingsDialog:
             if path:
                 var.set(path)
 
-        browse_btn = ttk.Button(frame, text="File", command=browse_file)
+        browse_btn = ttk.Button(frame, text="File", command=browse_file, width=10)
         browse_btn.pack(side=tk.RIGHT, padx=(5, 0))
 
-        browse_btn = ttk.Button(frame, text="Directory", command=browse_dir)
+        browse_btn = ttk.Button(frame, text="Directory", command=browse_dir, width=10)
         browse_btn.pack(side=tk.RIGHT, padx=(5, 0))
 
         frame.var = var
@@ -436,7 +444,7 @@ class GenericSettingsDialog:
                 var.set(color[1])
                 color_display.config(bg=color[1])
 
-        pick_btn = ttk.Button(frame, text="Pick", command=pick_color)
+        pick_btn = ttk.Button(frame, text="Pick", command=pick_color, width=10)
         pick_btn.pack(side=tk.LEFT, padx=(5, 0))
         color_display.config(bg=color_value.to_hex())
 
@@ -485,7 +493,7 @@ class GenericSettingsDialog:
                 color_var.set(color[1])
                 color_display.config(bg=color[1])
 
-        pick_btn = ttk.Button(frame, text="Pick Color", command=pick_color)
+        pick_btn = ttk.Button(frame, text="Pick Color", command=pick_color, width=10)
         pick_btn.pack(side=tk.LEFT, padx=(5, 0))
 
         def on_color_change(*args):
@@ -531,7 +539,7 @@ class GenericSettingsDialog:
             img_label.image = photo
             img_label.pack()
 
-        preview_btn = ttk.Button(frame, text="Preview", command=show_preview)
+        preview_btn = ttk.Button(frame, text="Preview", command=show_preview, width=10)
         preview_btn.pack(side=tk.LEFT, padx=(5, 0))
 
         # Store variables in the frame for later access
@@ -584,7 +592,7 @@ class GenericSettingsDialog:
             if dialog.result:
                 var.set(dialog.result.strftime("%Y-%m-%d %H:%M"))
 
-        cal_btn = ttk.Button(frame, text="Calendar", command=pick_datetime)
+        cal_btn = ttk.Button(frame, text="Calendar", command=pick_datetime, width=10)
         cal_btn.pack(side=tk.RIGHT, padx=(5, 0))
 
         frame.var = var
@@ -636,7 +644,17 @@ class GenericSettingsDialog:
     def _on_ok(self):
         """Handle OK button click."""
         try:
+            # Remember old theme to detect changes
+            try:
+                old_theme = self.config_manager.app.theme.value
+            except Exception:
+                old_theme = None
+
             self.__persist_settings()
+
+            # Apply GUI updates (theme change etc.) after persisting
+            self._apply_gui_updates(old_theme)
+
             self.dialog.destroy()
 
         except Exception as e:
@@ -698,6 +716,30 @@ class GenericSettingsDialog:
 
         self.result = "ok"
 
+    def _apply_gui_updates(self, old_theme=None):
+        """Apply GUI-level updates that should happen after settings are persisted.
+
+        Currently this changes the ttkbootstrap theme if it was modified. The
+        logic is centralized here so it can be called from both Apply and OK
+        handlers.
+        """
+        try:
+            new_theme = None
+            try:
+                new_theme = self.config_manager.app.theme.value
+            except Exception:
+                new_theme = None
+
+            if new_theme and new_theme != old_theme:
+                try:
+                    ttkbootstrap.Style().theme_use(new_theme)
+                except Exception:
+                    # Best-effort; don't crash the settings dialog if theme switch fails
+                    pass
+        except Exception:
+            # Swallow any unexpected errors to keep UI responsive
+            pass
+
     def _on_cancel(self):
         """Handle Cancel button click."""
         self.result = "cancel"
@@ -710,7 +752,14 @@ class GenericSettingsDialog:
         applies the theme change live if the GUI theme parameter is present.
         """
         try:
+            # Remember current theme, persist settings and apply GUI updates
+            try:
+                old_theme = self.config_manager.app.theme.value
+            except Exception:
+                old_theme = None
+
             self.__persist_settings()
+            self._apply_gui_updates(old_theme)
 
         except Exception as e:
             messagebox.showerror("Error", f"Failed to save configuration: {e}")