config-cli-gui 0.3.0__tar.gz → 0.3.1__tar.gz

{config_cli_gui-0.3.0 → config_cli_gui-0.3.1}/HISTORY.md

@@ -4,6 +4,15 @@ Changelog
 
 (unreleased)
 ------------
+- Fix typings, improve cli test. [Paul Magister]
+- Update README.md from docs/index.md. [github-actions]
+- Improve doc. [Paul Magister]
+- Search for some more paths in windows. [Paul Magister]
+
+
+0.3.0 (2025-12-03)
+------------------
+- Docs: Update HISTORY.md for release 0.3.0. [Paul Magister]
 - Docs: Update HISTORY.md for release 0.2.9. [Paul Magister]
 - Refactoring: config parameters will stay ordered like in the config.
   [Paul Magister]

{config_cli_gui-0.3.0 → config_cli_gui-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: config-cli-gui
-Version: 0.3.0
+Version: 0.3.1
 Summary: Feature-rich Python project template for config-cli-gui.
 Author: pamagister
 Requires-Python: <3.12,>=3.10
@@ -63,11 +63,33 @@ pip install config-cli-gui
 ## ✨ Features
 
   * **Single Source of Truth**: Define all your application parameters in one place using simple, dataclass-like structures based on Pydantic's `BaseModel`. This ensures consistency and reduces errors across your application.
+
+    ```yaml
+    gui:
+      # GUI theme setting | type=str | choices=['light', 'dark', 'auto']
+      theme: light
+    misc:
+      # Example integer | type=int
+      some_numeric: 42
+      # Path to the file to use | type=PosixPath
+      some_file: some_file.txt
+      # Color setting for the application | type=Color
+      some_color: '#ff0000'
+      # Font setting for the application | type=Font
+      some_font: 'DejaVuSans.ttf, 12, #0000ff'
+    ```
+
   * **Categorized Configuration**: Organize your parameters into logical categories (e.g., `cli`, `app`, `gui`) for better structure and maintainability.
   * **Dynamic CLI Generation**: Automatically generate `argparse`-compatible command-line arguments directly from your defined configuration parameters, including help texts, types, and choices.
   * **Config File Management**: Easily load and save configurations from/to YAML or JSON files, allowing users to customize default settings.
   * **GUI Settings Dialogs**: Dynamically create Tkinter-based settings dialogs for your application, allowing users to intuitively modify configuration parameters via a graphical interface.
+
+    ![settings_dlg.png](_static/img/settings_dlg.png)
+ 
   * **Documentation Generation**: Generate detailed Markdown documentation for both your CLI options and all configuration parameters, keeping your user guides always up-to-date with your codebase.
+
+    ![settings_doc.png](_static/img/settings_doc.png)
+
   * **Override System**: Supports robust overriding of configuration values via configuration files and command-line arguments, with clear precedence.
 
 ---

{config_cli_gui-0.3.0 → config_cli_gui-0.3.1}/README.md

@@ -35,11 +35,33 @@ pip install config-cli-gui
 ## ✨ Features
 
   * **Single Source of Truth**: Define all your application parameters in one place using simple, dataclass-like structures based on Pydantic's `BaseModel`. This ensures consistency and reduces errors across your application.
+
+    ```yaml
+    gui:
+      # GUI theme setting | type=str | choices=['light', 'dark', 'auto']
+      theme: light
+    misc:
+      # Example integer | type=int
+      some_numeric: 42
+      # Path to the file to use | type=PosixPath
+      some_file: some_file.txt
+      # Color setting for the application | type=Color
+      some_color: '#ff0000'
+      # Font setting for the application | type=Font
+      some_font: 'DejaVuSans.ttf, 12, #0000ff'
+    ```
+
   * **Categorized Configuration**: Organize your parameters into logical categories (e.g., `cli`, `app`, `gui`) for better structure and maintainability.
   * **Dynamic CLI Generation**: Automatically generate `argparse`-compatible command-line arguments directly from your defined configuration parameters, including help texts, types, and choices.
   * **Config File Management**: Easily load and save configurations from/to YAML or JSON files, allowing users to customize default settings.
   * **GUI Settings Dialogs**: Dynamically create Tkinter-based settings dialogs for your application, allowing users to intuitively modify configuration parameters via a graphical interface.
+
+    ![settings_dlg.png](_static/img/settings_dlg.png)
+ 
   * **Documentation Generation**: Generate detailed Markdown documentation for both your CLI options and all configuration parameters, keeping your user guides always up-to-date with your codebase.
+
+    ![settings_doc.png](_static/img/settings_doc.png)
+
   * **Override System**: Supports robust overriding of configuration values via configuration files and command-line arguments, with clear precedence.
 
 ---

{config_cli_gui-0.3.0 → config_cli_gui-0.3.1}/docs/index.md

@@ -33,11 +33,33 @@ pip install config-cli-gui
 ## ✨ Features
 
   * **Single Source of Truth**: Define all your application parameters in one place using simple, dataclass-like structures based on Pydantic's `BaseModel`. This ensures consistency and reduces errors across your application.
+
+    ```yaml
+    gui:
+      # GUI theme setting | type=str | choices=['light', 'dark', 'auto']
+      theme: light
+    misc:
+      # Example integer | type=int
+      some_numeric: 42
+      # Path to the file to use | type=PosixPath
+      some_file: some_file.txt
+      # Color setting for the application | type=Color
+      some_color: '#ff0000'
+      # Font setting for the application | type=Font
+      some_font: 'DejaVuSans.ttf, 12, #0000ff'
+    ```
+
   * **Categorized Configuration**: Organize your parameters into logical categories (e.g., `cli`, `app`, `gui`) for better structure and maintainability.
   * **Dynamic CLI Generation**: Automatically generate `argparse`-compatible command-line arguments directly from your defined configuration parameters, including help texts, types, and choices.
   * **Config File Management**: Easily load and save configurations from/to YAML or JSON files, allowing users to customize default settings.
   * **GUI Settings Dialogs**: Dynamically create Tkinter-based settings dialogs for your application, allowing users to intuitively modify configuration parameters via a graphical interface.
+
+    ![settings_dlg.png](_static/img/settings_dlg.png)
+ 
   * **Documentation Generation**: Generate detailed Markdown documentation for both your CLI options and all configuration parameters, keeping your user guides always up-to-date with your codebase.
+
+    ![settings_doc.png](_static/img/settings_doc.png)
+
   * **Override System**: Supports robust overriding of configuration values via configuration files and command-line arguments, with clear precedence.
 
 ---

{config_cli_gui-0.3.0 → config_cli_gui-0.3.1}/src/config_cli_gui/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.3.0'
-__version_tuple__ = version_tuple = (0, 3, 0)
+__version__ = version = '0.3.1'
+__version_tuple__ = version_tuple = (0, 3, 1)
 
-__commit_id__ = commit_id = 'g10ea5e914'
+__commit_id__ = commit_id = 'g32c96636f'

{config_cli_gui-0.3.0 → config_cli_gui-0.3.1}/src/config_cli_gui/cli.py

@@ -62,7 +62,7 @@ class CliGenerator:
                 continue
 
             # OPTIONAL FLAG
-            kwargs = {
+            kwargs: dict[str, Any] = {
                 "help": f"{p.help} (default: {p.value})",
                 "default": argparse.SUPPRESS,
             }
@@ -117,7 +117,7 @@ class CliGenerator:
 
         # Load config_file only ONCE
         config = ConfigManager(
-            categories=tuple(self.config_manager._categories.values()),
+            categories=self.config_manager.get_categories(),
             config_file=getattr(args, "config", None),
         )
 

{config_cli_gui-0.3.0 → config_cli_gui-0.3.1}/src/config_cli_gui/config.py

@@ -1,5 +1,6 @@
 import json
 from abc import ABC, abstractmethod
+from collections.abc import Iterable
 from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
@@ -134,6 +135,10 @@ class ConfigManager:
         """Retrieve a category by name."""
         return self._categories.get(name)
 
+    def get_categories(self) -> tuple[ConfigCategory, ...]:
+        values: Iterable[ConfigCategory] = self._categories.values()
+        return tuple(values)
+
     def apply_overrides(self, overrides: dict[str, Any]) -> None:
         """Apply keyword overrides in the format `category__param=value`."""
         for key, value in overrides.items():

{config_cli_gui-0.3.0 → config_cli_gui-0.3.1}/src/config_cli_gui/configtypes/font.py

@@ -8,22 +8,36 @@ from config_cli_gui.configtypes.color import Color
 
 
 def list_system_fonts() -> list[str]:
+    # Common font directories on Linux, macOS, Windows
     font_dirs = [
+        # Linux
         "/usr/share/fonts",
         "/usr/local/share/fonts",
         str(Path.home() / ".fonts"),
+        str(Path.home() / ".local/share/fonts"),
+        # macOS system + user
         "/Library/Fonts",
         "/System/Library/Fonts",
+        str(Path.home() / "Library/Fonts"),
+        "/Network/Library/Fonts",
+        # Windows system + user-scoped installed fonts
         "C:/Windows/Fonts",
+        str(Path(os.environ.get("LOCALAPPDATA", "") + "/Microsoft/Windows/Fonts")),
     ]
 
     fonts: list[str] = []
+    seen = set()  # Prevent duplicates
+
     for d in font_dirs:
-        if os.path.isdir(d):
+        if d and os.path.isdir(d):
             for root, _, files in os.walk(d):
                 for f in files:
-                    if f.lower().endswith((".ttf", ".otf")):
-                        fonts.append(os.path.join(root, f))
+                    if f.lower().endswith((".ttf", ".otf", ".ttc", ".woff", ".woff2")):
+                        full = os.path.join(root, f)
+                        if full not in seen:
+                            seen.add(full)
+                            fonts.append(full)
+
     return fonts
 
 
@@ -95,17 +109,22 @@ class Font:
         :param dpi: if dpi is provided, the font size is re-calculated on base of the dpi
         :return:
         """
+        size = self.size * dpi / 25.4
         try:
             if self.name in self.font_names:
                 idx = self.font_names.index(self.name)
                 path = self.font_files_sorted[idx]
-                size = self.size * dpi / 25.4
-                return ImageFont.truetype(path, size)
+                return ImageFont.truetype(font=path, size=size)
         except Exception as e:
-            print(f"Fehler beim Laden der Schrift '{self.name}': {e}")
-
-        print("Fallback: Nutze Default-Font.")
-        return ImageFont.load_default()
+            print(f"Error loading font '{self.name}': {e}")
+            fallback_font = "Arial.ttf"
+            try:
+                return ImageFont.truetype(font=fallback_font, size=size)
+            except Exception as e:
+                print(f"Error loading default fallback font '{fallback_font}': {e}")
+
+        print("Fallback: use Default-Font.")
+        return ImageFont.load_default(size=size)
 
     def __repr__(self) -> str:
         return f"Font(type='{self.name}', size={self.size}, color={self.color!r})"

{config_cli_gui-0.3.0 → config_cli_gui-0.3.1}/src/config_cli_gui.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: config-cli-gui
-Version: 0.3.0
+Version: 0.3.1
 Summary: Feature-rich Python project template for config-cli-gui.
 Author: pamagister
 Requires-Python: <3.12,>=3.10
@@ -63,11 +63,33 @@ pip install config-cli-gui
 ## ✨ Features
 
   * **Single Source of Truth**: Define all your application parameters in one place using simple, dataclass-like structures based on Pydantic's `BaseModel`. This ensures consistency and reduces errors across your application.
+
+    ```yaml
+    gui:
+      # GUI theme setting | type=str | choices=['light', 'dark', 'auto']
+      theme: light
+    misc:
+      # Example integer | type=int
+      some_numeric: 42
+      # Path to the file to use | type=PosixPath
+      some_file: some_file.txt
+      # Color setting for the application | type=Color
+      some_color: '#ff0000'
+      # Font setting for the application | type=Font
+      some_font: 'DejaVuSans.ttf, 12, #0000ff'
+    ```
+
   * **Categorized Configuration**: Organize your parameters into logical categories (e.g., `cli`, `app`, `gui`) for better structure and maintainability.
   * **Dynamic CLI Generation**: Automatically generate `argparse`-compatible command-line arguments directly from your defined configuration parameters, including help texts, types, and choices.
   * **Config File Management**: Easily load and save configurations from/to YAML or JSON files, allowing users to customize default settings.
   * **GUI Settings Dialogs**: Dynamically create Tkinter-based settings dialogs for your application, allowing users to intuitively modify configuration parameters via a graphical interface.
+
+    ![settings_dlg.png](_static/img/settings_dlg.png)
+ 
   * **Documentation Generation**: Generate detailed Markdown documentation for both your CLI options and all configuration parameters, keeping your user guides always up-to-date with your codebase.
+
+    ![settings_doc.png](_static/img/settings_doc.png)
+
   * **Override System**: Supports robust overriding of configuration values via configuration files and command-line arguments, with clear precedence.
 
 ---

{config_cli_gui-0.3.0 → config_cli_gui-0.3.1}/src/config_cli_gui.egg-info/SOURCES.txt

@@ -29,6 +29,8 @@ docs/.nav.yml
 docs/index.md
 docs/_static/img/favicon.png
 docs/_static/img/logo.png
+docs/_static/img/settings_dlg.png
+docs/_static/img/settings_doc.png
 docs/css/custom.css
 docs/develop/contributing.md
 docs/develop/make_windows.md

{config_cli_gui-0.3.0 → config_cli_gui-0.3.1}/tests/test_cli.py

@@ -155,3 +155,21 @@ def test_cli_overrides_applied_correctly(cli_gen):
     assert overrides["cli__min_dist"] == "55" or overrides["cli__min_dist"] == 55
     assert overrides["cli__output"] == "out.gpx"
     assert overrides["cli__input"] == "tests/input.gpx"
+
+
+def test_verbosity_arguments(cli_gen):
+    # Test --verbose
+    argv_verbose = ["prog", "--verbose", "tests/input.gpx"]
+    with patch.object(sys, "argv", argv_verbose):
+        parser_verbose = cli_gen.create_argument_parser()
+        args_verbose = parser_verbose.parse_args()
+        overrides_verbose = cli_gen.create_config_overrides(args_verbose)
+    assert overrides_verbose["app__log_level"] == "DEBUG"
+
+    # Test --quiet
+    argv_quiet = ["prog", "--quiet", "tests/input.gpx"]
+    with patch.object(sys, "argv", argv_quiet):
+        parser_quiet = cli_gen.create_argument_parser()
+        args_quiet = parser_quiet.parse_args()
+        overrides_quiet = cli_gen.create_config_overrides(args_quiet)
+    assert overrides_quiet["app__log_level"] == "WARNING"