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

{config_cli_gui-0.3.3 → config_cli_gui-0.3.5}/.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.3 → config_cli_gui-0.3.5}/HISTORY.md

@@ -4,6 +4,33 @@ Changelog
 
 (unreleased)
 ------------
+- 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]
+
+
+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.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: config-cli-gui
-Version: 0.3.3
+Version: 0.3.5
 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.5}/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 | type=str | choices=['light', 'dark', 'auto']
-  theme: light
   # 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.3 → config_cli_gui-0.3.5}/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                              | '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       |
+|-------------------|--------|------------------------------------------------|-----------------------|---------------|
+| 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.5}/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.5}/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.5'
+__version_tuple__ = version_tuple = (0, 3, 5)
 
-__commit_id__ = commit_id = 'gbc73a5894'
+__commit_id__ = commit_id = 'g089c3018c'

{config_cli_gui-0.3.3 → config_cli_gui-0.3.5}/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
@@ -63,21 +65,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 +91,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),
         },
     }
 
@@ -104,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."""
 
@@ -115,7 +189,9 @@ class ConfigManager:
     ):
         self._categories: dict[str, ConfigCategory] = {}
         self._serializer = ConfigSerializer()
+        self.app: AppConfig = AppConfig()
 
+        categories = (self.app, *categories)
         for category in categories:
             if not isinstance(category, ConfigCategory):
                 raise TypeError(f"Expected ConfigCategory instance, got {type(category)}")
@@ -163,6 +239,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("config-cli-gui", 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."""
@@ -201,6 +289,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("config-cli-gui", 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("config-cli-gui")
+        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.3 → config_cli_gui-0.3.5}/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(