config-cli-gui 0.2.8__tar.gz → 0.2.10__tar.gz

{config_cli_gui-0.2.8 → config_cli_gui-0.2.10}/HISTORY.md

@@ -2,8 +2,16 @@ Changelog
 =========
 
 
-(unreleased)
-------------
+0.2.9 (2025-12-03)
+------------------
+- Docs: Update HISTORY.md for release 0.2.9. [Paul Magister]
+- Spinbox for vector. [Paul Magister]
+- Better example, make get_image_font sensitive to dpi, [Paul Magister]
+
+
+0.2.8 (2025-12-02)
+------------------
+- Docs: Update HISTORY.md for release 0.2.8. [Paul Magister]
 - Refactoring: get_image_font will look for the actual font path in the
   system. [Paul Magister]
 - Font preview. [Paul Magister]

{config_cli_gui-0.2.8 → config_cli_gui-0.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: config-cli-gui
-Version: 0.2.8
+Version: 0.2.10
 Summary: Feature-rich Python project template for config-cli-gui.
 Author: pamagister
 Requires-Python: <3.12,>=3.10
@@ -81,40 +81,58 @@ Start by defining your application's configuration parameters in a central `conf
 ```python
 # my_project/config_example.py
 
+from datetime import datetime
+from pathlib import Path
+
 from config_cli_gui.config import (
     ConfigCategory,
     ConfigManager,
     ConfigParameter,
 )
+from config_cli_gui.configtypes.color import Color
+from config_cli_gui.configtypes.font import Font
+from config_cli_gui.configtypes.vector import Vector
 
 
-class CliConfig(ConfigCategory):
-    """CLI-specific configuration parameters."""
-
+class MiscConfig(ConfigCategory):
     def get_category_name(self) -> str:
-        return "cli"
-
-    # Positional argument
-    input: ConfigParameter = ConfigParameter(
-        name="input",
-        default="",
-        help="Path to input (file or folder)",
-        required=True,
+        return "misc"
+
+    some_numeric: ConfigParameter = ConfigParameter(
+        name="some_numeric",
+        value=int(42),
+        help="Example integer",
         is_cli=True,
     )
 
-    min_dist: ConfigParameter = ConfigParameter(
-        name="min_dist",
-        default=20,
-        help="Maximum distance between two waypoints",
-        is_cli=True,
+    some_vector: ConfigParameter = ConfigParameter(
+        name="some_vector",
+        value=Vector(1, 2, 3),
+        help="Example vector",
     )
 
-    extract_waypoints: ConfigParameter = ConfigParameter(
-        name="extract_waypoints",
-        default=True,
-        help="Extract starting points of each track as waypoint",
-        is_cli=True,
+    some_file: ConfigParameter = ConfigParameter(
+        name="some_file",
+        value=Path("some_file.txt"),
+        help="Path to the file to use",
+    )
+
+    some_color: ConfigParameter = ConfigParameter(
+        name="some_color",
+        value=Color(255, 0, 0),
+        help="Color setting for the application",
+    )
+
+    some_date: ConfigParameter = ConfigParameter(
+        name="some_date",
+        value=datetime.fromisoformat("2025-12-31 10:30:45"),
+        help="Date setting for the application",
+    )
+
+    some_font: ConfigParameter = ConfigParameter(
+        name="some_font",
+        value=Font("DejaVuSans.ttf", size=12, color=Color(0, 0, 255)),
+        help="Font setting for the application",
     )
 
 
@@ -126,14 +144,14 @@ class AppConfig(ConfigCategory):
 
     log_level: ConfigParameter = ConfigParameter(
         name="log_level",
-        default="INFO",
+        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",
-        default=10,
+        value=10,
         help="Maximum log file size in MB before rotation",
     )
 
@@ -141,11 +159,13 @@ class AppConfig(ConfigCategory):
 class ProjectConfigManager(ConfigManager):  # Inherit from ConfigManager
     """Main configuration manager that handles all parameter categories."""
 
-    categories = (CliConfig(), AppConfig())
-
+    app: AppConfig
+    misc: MiscConfig
+    
     def __init__(self, config_file: str | None = None, **kwargs):
         """Initialize the configuration manager with all parameter categories."""
-        super().__init__(self.categories, config_file, **kwargs)
+        categories = (MiscConfig(), AppConfig())
+        super().__init__(categories, config_file, **kwargs)
 
 
 ```

{config_cli_gui-0.2.8 → config_cli_gui-0.2.10}/config.yaml

@@ -54,4 +54,10 @@ misc:
   some_font:
   - DejaVuSans.ttf
   - 12
-  - '#0000ff'
+  - '#0000ff'
+  # Example integer | type=int
+  some_numeric: 42
+  # Example vector 2D | type=Vector
+  some_vector2d: (1, 2)
+  # Example vector 3D | type=Vector
+  some_vector3d: (1.1, 2.2, 3.3)

{config_cli_gui-0.2.8 → config_cli_gui-0.2.10}/docs/index.md

@@ -51,40 +51,58 @@ Start by defining your application's configuration parameters in a central `conf
 ```python
 # my_project/config_example.py
 
+from datetime import datetime
+from pathlib import Path
+
 from config_cli_gui.config import (
     ConfigCategory,
     ConfigManager,
     ConfigParameter,
 )
+from config_cli_gui.configtypes.color import Color
+from config_cli_gui.configtypes.font import Font
+from config_cli_gui.configtypes.vector import Vector
 
 
-class CliConfig(ConfigCategory):
-    """CLI-specific configuration parameters."""
-
+class MiscConfig(ConfigCategory):
     def get_category_name(self) -> str:
-        return "cli"
-
-    # Positional argument
-    input: ConfigParameter = ConfigParameter(
-        name="input",
-        default="",
-        help="Path to input (file or folder)",
-        required=True,
+        return "misc"
+
+    some_numeric: ConfigParameter = ConfigParameter(
+        name="some_numeric",
+        value=int(42),
+        help="Example integer",
         is_cli=True,
     )
 
-    min_dist: ConfigParameter = ConfigParameter(
-        name="min_dist",
-        default=20,
-        help="Maximum distance between two waypoints",
-        is_cli=True,
+    some_vector: ConfigParameter = ConfigParameter(
+        name="some_vector",
+        value=Vector(1, 2, 3),
+        help="Example vector",
     )
 
-    extract_waypoints: ConfigParameter = ConfigParameter(
-        name="extract_waypoints",
-        default=True,
-        help="Extract starting points of each track as waypoint",
-        is_cli=True,
+    some_file: ConfigParameter = ConfigParameter(
+        name="some_file",
+        value=Path("some_file.txt"),
+        help="Path to the file to use",
+    )
+
+    some_color: ConfigParameter = ConfigParameter(
+        name="some_color",
+        value=Color(255, 0, 0),
+        help="Color setting for the application",
+    )
+
+    some_date: ConfigParameter = ConfigParameter(
+        name="some_date",
+        value=datetime.fromisoformat("2025-12-31 10:30:45"),
+        help="Date setting for the application",
+    )
+
+    some_font: ConfigParameter = ConfigParameter(
+        name="some_font",
+        value=Font("DejaVuSans.ttf", size=12, color=Color(0, 0, 255)),
+        help="Font setting for the application",
     )
 
 
@@ -96,14 +114,14 @@ class AppConfig(ConfigCategory):
 
     log_level: ConfigParameter = ConfigParameter(
         name="log_level",
-        default="INFO",
+        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",
-        default=10,
+        value=10,
         help="Maximum log file size in MB before rotation",
     )
 
@@ -111,11 +129,13 @@ class AppConfig(ConfigCategory):
 class ProjectConfigManager(ConfigManager):  # Inherit from ConfigManager
     """Main configuration manager that handles all parameter categories."""
 
-    categories = (CliConfig(), AppConfig())
-
+    app: AppConfig
+    misc: MiscConfig
+    
     def __init__(self, config_file: str | None = None, **kwargs):
         """Initialize the configuration manager with all parameter categories."""
-        super().__init__(self.categories, config_file, **kwargs)
+        categories = (MiscConfig(), AppConfig())
+        super().__init__(categories, config_file, **kwargs)
 
 
 ```

{config_cli_gui-0.2.8 → config_cli_gui-0.2.10}/docs/usage/config.md

@@ -41,10 +41,13 @@ The parameters in the cli category can be accessed via the command line interfac
 
 ## Category "misc"
 
-| Name       | Type      | Description                       | Default                                                      | Choices |
-|------------|-----------|-----------------------------------|--------------------------------------------------------------|---------|
-| some_file  | PosixPath | Path to the file to use           | PosixPath('some_file.txt')                                   | -       |
-| some_color | Color     | Color setting for the application | Color(255, 0, 0)                                             | -       |
-| some_date  | datetime  | Date setting for the application  | datetime.datetime(2025, 12, 31, 10, 30, 45)                  | -       |
-| some_font  | Font      | Font setting for the application  | Font(type='DejaVuSans.ttf', size=12, color=Color(0, 0, 255)) | -       |
+| Name          | Type      | Description                       | Default                                                      | Choices |
+|---------------|-----------|-----------------------------------|--------------------------------------------------------------|---------|
+| some_numeric  | int       | Example integer                   | 42                                                           | -       |
+| some_vector2d | Vector    | Example vector 2D                 | Vector(1, 2)                                                 | -       |
+| some_vector3d | Vector    | Example vector 3D                 | Vector(1.1, 2.2, 3.3)                                        | -       |
+| some_file     | PosixPath | Path to the file to use           | PosixPath('some_file.txt')                                   | -       |
+| some_color    | Color     | Color setting for the application | Color(255, 0, 0)                                             | -       |
+| some_date     | datetime  | Date setting for the application  | datetime.datetime(2025, 12, 31, 10, 30, 45)                  | -       |
+| some_font     | Font      | Font setting for the application  | Font(type='DejaVuSans.ttf', size=12, color=Color(0, 0, 255)) | -       |
 

{config_cli_gui-0.2.8 → config_cli_gui-0.2.10}/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.2.8'
-__version_tuple__ = version_tuple = (0, 2, 8)
+__version__ = version = '0.2.10'
+__version_tuple__ = version_tuple = (0, 2, 10)
 
-__commit_id__ = commit_id = 'g013f3a747'
+__commit_id__ = commit_id = 'g50c7157ad'

{config_cli_gui-0.2.8 → config_cli_gui-0.2.10}/src/config_cli_gui/configtypes/font.py

@@ -54,13 +54,19 @@ class Font:
         )
         return cls(str(font_type), float(size), color)
 
-    def get_image_font(self) -> ImageFont.FreeTypeFont:
-        """Return a PIL FreeTypeFont, with fallback to default."""
+    def get_image_font(self, dpi=25.4) -> ImageFont.FreeTypeFont:
+        """
+        Return a PIL FreeTypeFont, with fallback to default.
+
+        :param dpi: if dpi is provided, the font size is re-calculated on base of the dpi
+        :return:
+        """
         try:
             if self.name in self.font_names:
                 idx = self.font_names.index(self.name)
                 path = self.font_files_sorted[idx]
-                return ImageFont.truetype(path, int(self.size))
+                size = self.size * dpi / 25.4
+                return ImageFont.truetype(path, size)
         except Exception as e:
             print(f"Fehler beim Laden der Schrift '{self.name}': {e}")
 

{config_cli_gui-0.2.8 → config_cli_gui-0.2.10}/src/config_cli_gui/gui.py

@@ -526,13 +526,27 @@ class GenericSettingsDialog:
         """Create vector editor widget."""
         frame = ttk.Frame(parent)
 
-        vector_value = param.value if isinstance(param.value, Vector) else Vector()
-        var = tk.StringVar(value=vector_value.to_str().strip("()[]"))
-        entry = ttk.Entry(frame, textvariable=var)
-        entry.pack(side=tk.LEFT, fill=tk.X, expand=True)
+        vector_value = param.value if isinstance(param.value, Vector) else Vector(0, 0)
+
+        components = vector_value.to_list()
+
+        frame.vars = []
+        for value in components:
+            var = tk.DoubleVar(value=value)
+            spinbox = ttk.Spinbox(
+                frame,
+                from_=-999999.0,
+                to=999999.0,
+                increment=1.0,
+                textvariable=var,
+                width=8,
+            )
+            spinbox.pack(side=tk.LEFT, padx=(0, 5))
+            frame.vars.append(var)
+
+        if frame.winfo_children():
+            frame.entry_widget = frame.winfo_children()[0]
 
-        frame.var = var
-        frame.entry_widget = entry
         return frame
 
     def _create_datetime_widget(self, parent, param: ConfigParameter):
@@ -613,14 +627,16 @@ class GenericSettingsDialog:
                 if isinstance(param_value, Font):
                     selected_font_name = widget.font_type_var.get()
                     font_type = selected_font_name
-                    if selected_font_name in widget.font_names:
-                        font_type = widget.font_files[widget.font_names.index(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
@@ -641,8 +657,6 @@ class GenericSettingsDialog:
                     import json
 
                     overrides[key] = json.loads(value)
-                elif type(param_value) == Vector:
-                    overrides[key] = Vector.from_str(value)
                 elif type(param_value) == int:
                     overrides[key] = int(value)
                 elif type(param_value) == float:

{config_cli_gui-0.2.8 → config_cli_gui-0.2.10}/src/config_cli_gui.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: config-cli-gui
-Version: 0.2.8
+Version: 0.2.10
 Summary: Feature-rich Python project template for config-cli-gui.
 Author: pamagister
 Requires-Python: <3.12,>=3.10
@@ -81,40 +81,58 @@ Start by defining your application's configuration parameters in a central `conf
 ```python
 # my_project/config_example.py
 
+from datetime import datetime
+from pathlib import Path
+
 from config_cli_gui.config import (
     ConfigCategory,
     ConfigManager,
     ConfigParameter,
 )
+from config_cli_gui.configtypes.color import Color
+from config_cli_gui.configtypes.font import Font
+from config_cli_gui.configtypes.vector import Vector
 
 
-class CliConfig(ConfigCategory):
-    """CLI-specific configuration parameters."""
-
+class MiscConfig(ConfigCategory):
     def get_category_name(self) -> str:
-        return "cli"
-
-    # Positional argument
-    input: ConfigParameter = ConfigParameter(
-        name="input",
-        default="",
-        help="Path to input (file or folder)",
-        required=True,
+        return "misc"
+
+    some_numeric: ConfigParameter = ConfigParameter(
+        name="some_numeric",
+        value=int(42),
+        help="Example integer",
         is_cli=True,
     )
 
-    min_dist: ConfigParameter = ConfigParameter(
-        name="min_dist",
-        default=20,
-        help="Maximum distance between two waypoints",
-        is_cli=True,
+    some_vector: ConfigParameter = ConfigParameter(
+        name="some_vector",
+        value=Vector(1, 2, 3),
+        help="Example vector",
     )
 
-    extract_waypoints: ConfigParameter = ConfigParameter(
-        name="extract_waypoints",
-        default=True,
-        help="Extract starting points of each track as waypoint",
-        is_cli=True,
+    some_file: ConfigParameter = ConfigParameter(
+        name="some_file",
+        value=Path("some_file.txt"),
+        help="Path to the file to use",
+    )
+
+    some_color: ConfigParameter = ConfigParameter(
+        name="some_color",
+        value=Color(255, 0, 0),
+        help="Color setting for the application",
+    )
+
+    some_date: ConfigParameter = ConfigParameter(
+        name="some_date",
+        value=datetime.fromisoformat("2025-12-31 10:30:45"),
+        help="Date setting for the application",
+    )
+
+    some_font: ConfigParameter = ConfigParameter(
+        name="some_font",
+        value=Font("DejaVuSans.ttf", size=12, color=Color(0, 0, 255)),
+        help="Font setting for the application",
     )
 
 
@@ -126,14 +144,14 @@ class AppConfig(ConfigCategory):
 
     log_level: ConfigParameter = ConfigParameter(
         name="log_level",
-        default="INFO",
+        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",
-        default=10,
+        value=10,
         help="Maximum log file size in MB before rotation",
     )
 
@@ -141,11 +159,13 @@ class AppConfig(ConfigCategory):
 class ProjectConfigManager(ConfigManager):  # Inherit from ConfigManager
     """Main configuration manager that handles all parameter categories."""
 
-    categories = (CliConfig(), AppConfig())
-
+    app: AppConfig
+    misc: MiscConfig
+    
     def __init__(self, config_file: str | None = None, **kwargs):
         """Initialize the configuration manager with all parameter categories."""
-        super().__init__(self.categories, config_file, **kwargs)
+        categories = (MiscConfig(), AppConfig())
+        super().__init__(categories, config_file, **kwargs)
 
 
 ```

{config_cli_gui-0.2.8 → config_cli_gui-0.2.10}/tests/example_project/config/config_example.py

@@ -181,6 +181,24 @@ class MiscConfig(ConfigCategory):
     def get_category_name(self) -> str:
         return "misc"
 
+    some_numeric: ConfigParameter = ConfigParameter(
+        name="some_numeric",
+        value=42,
+        help="Example integer",
+    )
+
+    some_vector2d: ConfigParameter = ConfigParameter(
+        name="some_vector2d",
+        value=Vector(1, 2),
+        help="Example vector 2D",
+    )
+
+    some_vector3d: ConfigParameter = ConfigParameter(
+        name="some_vector3d",
+        value=Vector(1.1, 2.2, 3.3),
+        help="Example vector 3D",
+    )
+
     some_file: ConfigParameter = ConfigParameter(
         name="some_file",
         value=Path("some_file.txt"),