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

{config_cli_gui-0.3.5 → config_cli_gui-0.3.7}/HISTORY.md

@@ -4,6 +4,19 @@ Changelog
 
 (unreleased)
 ------------
+- Keep last used config file. [Paul Magister]
+
+
+0.3.6 (2026-06-24)
+------------------
+- Docs: Update HISTORY.md for release 0.3.6. [Paul Magister]
+- 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]

{config_cli_gui-0.3.5/src/config_cli_gui.egg-info → config_cli_gui-0.3.7}/PKG-INFO

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

{config_cli_gui-0.3.5 → config_cli_gui-0.3.7}/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.5'
-__version_tuple__ = version_tuple = (0, 3, 5)
+__version__ = version = '0.3.7'
+__version_tuple__ = version_tuple = (0, 3, 7)
 
-__commit_id__ = commit_id = 'g089c3018c'
+__commit_id__ = commit_id = 'g1115f5d6c'

{config_cli_gui-0.3.5 → config_cli_gui-0.3.7}/src/config_cli_gui/config.py

@@ -185,11 +185,14 @@ class ConfigManager:
         self,
         categories: tuple[ConfigCategory, ...],
         config_file: str | None = None,
+        persist_last_used: bool = True,
         **overrides: Any,
     ):
         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:
@@ -198,10 +201,23 @@ class ConfigManager:
             self.add_category(category.get_category_name(), category)
 
         if config_file:
-            self.load_from_file(config_file)
+            # Allow callers to opt-out of writing the "last used" persistence
+            # entry when loading a configuration during initialization. This
+            # is useful for GUIs or libraries that want to load a default
+            # config without marking it as the user's last-used file.
+            self.load_from_file(config_file, persist_last_used=persist_last_used)
 
         self.apply_overrides(overrides)
 
+    @staticmethod
+    def get_app_name() -> 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
@@ -229,7 +245,7 @@ class ConfigManager:
                 else:
                     setattr(category, param_name, value)
 
-    def load_from_file(self, config_file: str) -> None:
+    def load_from_file(self, config_file: str, persist_last_used: bool = True) -> None:
         """Load configuration from a YAML or JSON file."""
         path = Path(config_file)
         if not path.exists():
@@ -240,12 +256,15 @@ class ConfigManager:
 
         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
+        # application can restore the same config on next start. This can be
+        # disabled by callers (e.g. GUI startup loading a default file) by
+        # passing `persist_last_used=False`.
+        if persist_last_used:
+            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:
@@ -291,7 +310,7 @@ class ConfigManager:
 
         # Record the saved config as the last-used config as well.
         try:
-            persistence.write_last_used_config("config-cli-gui", str(path))
+            persistence.write_last_used_config(self.get_app_name(), str(path))
         except Exception:
             # Ignore persistence failures when saving
             pass
@@ -307,7 +326,7 @@ class ConfigManager:
         This is a convenience wrapper around persistence.read_last_used_config.
         """
         try:
-            return persistence.read_last_used_config("config-cli-gui")
+            return persistence.read_last_used_config(self.get_app_name())
         except Exception:
             return None
 

{config_cli_gui-0.3.5 → config_cli_gui-0.3.7/src/config_cli_gui.egg-info}/PKG-INFO

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

{config_cli_gui-0.3.5 → config_cli_gui-0.3.7}/src/config_cli_gui.egg-info/SOURCES.txt

@@ -58,6 +58,8 @@ src/config_cli_gui.egg-info/SOURCES.txt
 src/config_cli_gui.egg-info/dependency_links.txt
 src/config_cli_gui.egg-info/entry_points.txt
 src/config_cli_gui.egg-info/requires.txt
+src/config_cli_gui.egg-info/scm_file_list.json
+src/config_cli_gui.egg-info/scm_version.json
 src/config_cli_gui.egg-info/top_level.txt
 src/config_cli_gui/configtypes/__init__.py
 src/config_cli_gui/configtypes/color.py

config_cli_gui-0.3.7/src/config_cli_gui.egg-info/scm_file_list.json

@@ -0,0 +1,80 @@
+{
+  "files": [
+    ".pre-commit-config.yaml",
+    "README.md",
+    "uv.lock",
+    "Makefile",
+    "LICENSE",
+    "pyproject.toml",
+    "mkdocs.yml",
+    "HISTORY.md",
+    "template.yml.url",
+    "config.yaml",
+    ".gitignore",
+    ".readthedocs.yaml",
+    "scripts/show_filelist.ps1",
+    "scripts/show_tree.ps1",
+    "scripts/show_tree.py",
+    "scripts/update_readme.py",
+    "docs/.nav.yml",
+    "docs/index.md",
+    "docs/develop/contributing.md",
+    "docs/develop/make_windows.md",
+    "docs/develop/naming_convention.md",
+    "docs/funding/funding.md",
+    "docs/css/custom.css",
+    "docs/_static/img/logo.png",
+    "docs/_static/img/favicon.png",
+    "docs/_static/img/settings_dlg.png",
+    "docs/_static/img/settings_doc.png",
+    "docs/usage/config.md",
+    "docs/usage/cli.md",
+    "docs/getting-started/virtual-environment.md",
+    "docs/getting-started/install.md",
+    "src/__init__.py",
+    "src/config_cli_gui/__init__.py",
+    "src/config_cli_gui/config.py",
+    "src/config_cli_gui/docs.py",
+    "src/config_cli_gui/logging.py",
+    "src/config_cli_gui/persistence.py",
+    "src/config_cli_gui/cli.py",
+    "src/config_cli_gui/gui.py",
+    "src/config_cli_gui/configtypes/__init__.py",
+    "src/config_cli_gui/configtypes/color.py",
+    "src/config_cli_gui/configtypes/vector.py",
+    "src/config_cli_gui/configtypes/font.py",
+    "tests/__init__.py",
+    "tests/test_docs.py",
+    "tests/test_config_manager.py",
+    "tests/test_cli.py",
+    "tests/test_generic_cli.py",
+    "tests/example_project/__init__.py",
+    "tests/example_project/example.gpx",
+    "tests/example_project/__main__.py",
+    "tests/example_project/core/__init__.py",
+    "tests/example_project/core/base.py",
+    "tests/example_project/config/__init__.py",
+    "tests/example_project/config/config_example.py",
+    "tests/example_project/cli/__init__.py",
+    "tests/example_project/cli/cli_example.py",
+    "tests/example_project/cli/__main__.py",
+    "tests/example_project/gui/__init__.py",
+    "tests/example_project/gui/gui_example.py",
+    "tests/example_project/gui/__main__.py",
+    ".idea/runConfigurations/example_project_cli.xml",
+    ".idea/runConfigurations/config_generate.xml",
+    ".idea/runConfigurations/example_project_gui.xml",
+    ".github/PULL_REQUEST_TEMPLATE.md",
+    ".github/init.sh",
+    ".github/update_funding.py",
+    ".github/dependabot.yml",
+    ".github/FUNDING.yml",
+    ".github/release_message.sh",
+    ".github/actions/setup-environment/action.yml",
+    ".github/ISSUE_TEMPLATE/bug_report.md",
+    ".github/ISSUE_TEMPLATE/feature_request.md",
+    ".github/workflows/main.yml",
+    ".github/workflows/release.yml",
+    ".github/workflows/update_readme.yml"
+  ]
+}

config_cli_gui-0.3.7/src/config_cli_gui.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.3.7",
+  "distance": 0,
+  "node": "g1115f5d6c180b06de260c378d10a5ca3977c2714",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-06-24"
+}

{config_cli_gui-0.3.5 → config_cli_gui-0.3.7}/tests/example_project/cli/cli_example.py

@@ -7,11 +7,11 @@ from logging import Logger
 
 from config_cli_gui.cli import CliGenerator
 from config_cli_gui.logging import initialize_logging
-from tests.example_project.config.config_example import ProjectConfigManager
+from tests.example_project.config.config_example import ConfigParameterManager
 from tests.example_project.core.base import BaseGPXProcessor
 
 
-def validate_config(config_manager: ProjectConfigManager, logger: Logger) -> bool:
+def validate_config(config_manager: ConfigParameterManager, logger: Logger) -> bool:
     """Validate the configuration parameters.
 
     Args:
@@ -29,7 +29,7 @@ def validate_config(config_manager: ProjectConfigManager, logger: Logger) -> boo
     return True
 
 
-def run_main_processing(_config: ProjectConfigManager, logger: Logger) -> int:
+def run_main_processing(_config: ConfigParameterManager, logger: Logger) -> int:
     """Main processing function that gets called by the CLI generator.
 
     Args:
@@ -71,7 +71,7 @@ def run_main_processing(_config: ProjectConfigManager, logger: Logger) -> int:
 def main():
     """Main entry point for the CLI application."""
     # Create the base configuration manager
-    config_manager = ProjectConfigManager()
+    config_manager = ConfigParameterManager()
 
     # Initialize logging and get a logger
     logger_manager = initialize_logging(

{config_cli_gui-0.3.5 → config_cli_gui-0.3.7}/tests/example_project/config/config_example.py

@@ -164,7 +164,7 @@ class MiscConfig(ConfigCategory):
     )
 
 
-class ProjectConfigManager(ConfigManager):  # Inherit from ConfigManager
+class ConfigParameterManager(ConfigManager):  # Inherit from ConfigManager
     """Main configuration manager that handles all parameter categories."""
 
     cli: CliConfig
@@ -176,13 +176,22 @@ class ProjectConfigManager(ConfigManager):  # Inherit from ConfigManager
         categories = (CliConfig(), GuiConfig(), MiscConfig())
         super().__init__(categories, config_file, **kwargs)
 
+    @staticmethod
+    def get_app_name() -> str:
+        """Return the application identifier for this example project.
+
+        This overrides the library default so that example files use
+        "example-app" as their persistence directory/name.
+        """
+        return "example-app"
+
 
 def main():
     """Main function to generate config file and documentation."""
     default_config: str = "config.yaml"
     default_cli_doc: str = "docs/usage/cli.md"
     default_config_doc: str = "docs/usage/config.md"
-    _config = ProjectConfigManager()
+    _config = ConfigParameterManager()
     doc_gen = DocumentationGenerator(_config)
     doc_gen.generate_default_config_file(output_file=default_config)
     print(f"Generated: {default_config}")

{config_cli_gui-0.3.5 → config_cli_gui-0.3.7}/tests/example_project/gui/gui_example.py

@@ -27,7 +27,7 @@ from config_cli_gui.logging import (
     initialize_logging,
 )
 from config_cli_gui.persistence import read_last_used_config
-from tests.example_project.config.config_example import ProjectConfigManager
+from tests.example_project.config.config_example import ConfigParameterManager
 from tests.example_project.core.base import BaseGPXProcessor
 
 
@@ -118,7 +118,21 @@ class MainGui:
         self.root.geometry("1200x600")  # Increased width for new layout
 
         # Initialize configuration
-        self._config = ProjectConfigManager("config.yaml")
+        # Prefer the user's last used configuration if present; otherwise
+        # load a local default config.yaml without marking it as "last used"
+        # (so we don't overwrite the user's actual last-used file).
+        try:
+            last = read_last_used_config(ConfigParameterManager.get_app_name())
+        except Exception:
+            last = None
+
+        if last and Path(last).exists():
+            self._config = ConfigParameterManager(last)
+        elif Path("config.yaml").exists():
+            # Load default config but do not persist it as the "last used"
+            self._config = ConfigParameterManager("config.yaml", persist_last_used=False)
+        else:
+            self._config = ConfigParameterManager()
 
         # Initialize logging system using individual AppConfig values
         self.logger_manager = initialize_logging(
@@ -278,7 +292,8 @@ class MainGui:
         # File menu
         file_menu = tk.Menu(menubar, tearoff=0)
         menubar.add_cascade(label="File", menu=file_menu)
-        file_menu.add_command(label="Open...", command=self._open_files)
+        file_menu.add_command(label="Select config file", command=self._select_config)
+        file_menu.add_command(label="Open gpx files...", command=self._open_files)
         file_menu.add_separator()
 
         # Create Run menu options dynamically
@@ -379,6 +394,25 @@ class MainGui:
             self.logger.error(f"Could not open file {file_path}: {e}")
             messagebox.showerror("Error", f"Could not open file {file_path}: {e}")
 
+    def _select_config(self):
+        """Open file dialog to select and load a new config file."""
+        config_file = filedialog.askopenfilename(
+            title="Select config file",
+            filetypes=[("YAML files", "*.yaml"), ("All files", "*.*")],
+        )
+        if not config_file:
+            self.logger.debug("No config file selected.")
+            return
+
+        self.logger.info(f"Loading new configuration from: {config_file}")
+        try:
+            # When user explicitly selects a config file, we load it and
+            # allow the manager to persist it as the new last-used file.
+            self._config = ConfigParameterManager(config_file)
+        except Exception as e:
+            self.logger.error(f"Failed to load config file: {e}", exc_info=True)
+            messagebox.showerror("Config Error", f"Failed to load configuration: {e}")
+
     def _open_files(self):
         """Open file dialog and add files to list."""
         files = filedialog.askopenfilenames(
@@ -558,11 +592,11 @@ def main():
 
     # Try to restore the last used configuration file so the GUI can start
     # with the user's preferred theme and settings.
-    last = read_last_used_config("config-cli-gui")
+    last = read_last_used_config(ConfigParameterManager.get_app_name())
     if last and Path(last).exists():
-        _config = ProjectConfigManager(last)
+        _config = ConfigParameterManager(last)
     else:
-        _config = ProjectConfigManager()
+        _config = ConfigParameterManager()
 
     theme_choice = _config.app.theme.value
 

{config_cli_gui-0.3.5 → config_cli_gui-0.3.7}/tests/test_cli.py

@@ -4,7 +4,7 @@ from unittest.mock import mock_open, patch
 import pytest
 
 from config_cli_gui.cli import CliGenerator
-from tests.example_project.config.config_example import ProjectConfigManager
+from tests.example_project.config.config_example import ConfigParameterManager
 
 # ----------------------------------------------------------------------
 # Mock config.yaml content
@@ -29,7 +29,7 @@ cli:
 # ----------------------------------------------------------------------
 @pytest.fixture
 def config_manager():
-    return ProjectConfigManager()
+    return ConfigParameterManager()
 
 
 @pytest.fixture

{config_cli_gui-0.3.5 → config_cli_gui-0.3.7}/tests/test_generic_cli.py

@@ -9,7 +9,7 @@ import unittest
 from pathlib import Path
 
 from config_cli_gui.docs import DocumentationGenerator
-from tests.example_project.config.config_example import ProjectConfigManager
+from tests.example_project.config.config_example import ConfigParameterManager
 
 
 class TestGenericCLI(unittest.TestCase):
@@ -25,7 +25,7 @@ class TestGenericCLI(unittest.TestCase):
         self.dummy_input.write_text("dummy input content")
 
         # Default config for testing
-        self.configManager = ProjectConfigManager()
+        self.configManager = ConfigParameterManager()
         self.default_cli_config = self.configManager.to_dict()["cli"]
 
     def tearDown(self):
@@ -65,13 +65,13 @@ class TestGenericCLI(unittest.TestCase):
         non_existent_file = self.temp_path / "does_not_exist.yaml"
 
         with self.assertRaises(FileNotFoundError):
-            ProjectConfigManager(config_file=str(non_existent_file))
+            ConfigParameterManager(config_file=str(non_existent_file))
 
     def test_generate_default_config_file(self):
         """Test generation of default configuration file."""
         output_file = self.temp_path / "default_config.yaml"
 
-        config_manager = ProjectConfigManager()
+        config_manager = ConfigParameterManager()
         docGen = DocumentationGenerator(config_manager)
         docGen.generate_default_config_file(str(output_file))
 
@@ -102,7 +102,7 @@ class TestGenericCLI(unittest.TestCase):
         """Test generation of CLI markdown documentation."""
         output_file = self.temp_path / "cli_doc_test.md"
 
-        config_manager = ProjectConfigManager()
+        config_manager = ConfigParameterManager()
         docGen = DocumentationGenerator(config_manager)
         docGen.generate_cli_markdown_doc(str(output_file))