config2py 0.1.43__tar.gz → 0.1.45__tar.gz

config2py-0.1.45/.gitattributes

@@ -0,0 +1 @@
+*.ipynb linguist-documentation

config2py-0.1.45/.github/workflows/ci.yml

@@ -0,0 +1,171 @@
+name: Continuous Integration (Modern)
+on: [push, pull_request]
+
+env:
+  PROJECT_NAME: config2py
+
+jobs:
+  validation:
+    name: Validation
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Dependencies
+        uses: i2mint/wads/actions/install-deps@master
+        with:
+          dependency-files: pyproject.toml
+          extras: dev,test
+          # Fallback for projects still using setup.cfg:
+          # dependency-files: setup.cfg
+          # ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}  # Uncomment for private dependencies
+
+      - name: Format Source Code
+        uses: i2mint/wads/actions/ruff-format@master
+        with:
+          line-length: 88
+          target-path: .
+
+      - name: Lint Validation
+        uses: i2mint/wads/actions/ruff-lint@master
+        with:
+          root-dir: ${{ env.PROJECT_NAME }}
+          output-format: github
+          # Ruff will read configuration from pyproject.toml
+
+      - name: Run Tests
+        uses: i2mint/wads/actions/run-tests@master
+        with:
+          root-dir: ${{ env.PROJECT_NAME }}
+          exclude: examples,scrap
+          coverage: true
+          pytest-args: -v --tb=short
+
+  windows-validation:
+    name: Windows Tests (Informational)
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+    runs-on: windows-latest
+    continue-on-error: true  # Don't fail the entire workflow if Windows tests fail
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install Dependencies
+        uses: i2mint/wads/actions/install-deps@master
+        with:
+          dependency-files: pyproject.toml
+          extras: dev,test
+
+      - name: Run tests
+        id: test
+        continue-on-error: true
+        run: pytest
+
+      - name: Report test results
+        if: always()
+        run: |
+          if [ "${{ steps.test.outcome }}" == "failure" ]; then
+            echo "::warning::Windows tests failed but workflow continues"
+            echo "## ⚠️ Windows Tests Failed" >> $GITHUB_STEP_SUMMARY
+            echo "Tests failed on Windows but this is informational only." >> $GITHUB_STEP_SUMMARY
+          else
+            echo "## ✅ Windows Tests Passed" >> $GITHUB_STEP_SUMMARY
+          fi
+
+  publish:
+    name: Publish
+    if: "!contains(github.event.head_commit.message, '[skip ci]') && (github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main')"
+    needs: validation
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Format Source Code
+        uses: i2mint/wads/actions/ruff-format@master
+
+      - name: Update Version Number
+        id: version
+        uses: i2mint/isee/actions/bump-version-number@master
+
+      - name: Build Distribution
+        uses: i2mint/wads/actions/build-dist@master
+        with:
+          sdist: true
+          wheel: true
+        # Uncomment for private dependencies:
+        # with:
+        #   ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}
+
+      - name: Publish to PyPI
+        uses: i2mint/wads/actions/pypi-upload@master
+        with:
+          pypi-username: ${{ secrets.PYPI_USERNAME }}
+          pypi-password: ${{ secrets.PYPI_PASSWORD }}
+          skip-existing: false
+
+      - name: Track Code Metrics
+        uses: i2mint/umpyre/actions/track-metrics@master
+        continue-on-error: true  # Don't fail CI if metrics collection fails
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          config-path: .github/umpyre-config.yml  # Optional: defaults to .umpyre.yml
+
+      - name: Commit Changes
+        uses: i2mint/wads/actions/git-commit@master
+        with:
+          commit-message: "**CI** Formatted code + Updated version to ${{ env.VERSION }} [skip ci]"
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}
+          push: true
+
+      - name: Tag Repository
+        uses: i2mint/wads/actions/git-tag@master
+        with:
+          tag: ${{ env.VERSION }}
+          message: "Release version ${{ env.VERSION }}"
+          push: true
+
+
+  github-pages:
+    name: Publish GitHub Pages
+
+    permissions:
+      contents: write
+      pages: write
+      id-token: write
+
+    if: "!contains(github.event.head_commit.message, '[skip ci]') && github.ref == format('refs/heads/{0}', github.event.repository.default_branch)"
+    needs: publish
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: i2mint/epythet/actions/publish-github-pages@master
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          ignore: "tests/,scrap/,examples/"

config2py-0.1.45/.gitignore

@@ -0,0 +1,119 @@
+docs/*
+docsrc/*
+wads_configs.json
+data/wads_configs.json
+wads/data/wads_configs.json
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+
+.DS_Store
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+_build
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# PyCharm
+.idea
+
+# Notebook playground
+vf.ipynb

{config2py-0.1.43 → config2py-0.1.45}/PKG-INFO

@@ -1,16 +1,22 @@
 Metadata-Version: 2.4
 Name: config2py
-Version: 0.1.43
+Version: 0.1.45
 Summary: Simplified reading and writing configurations from various sources and formats
-Home-page: https://github.com/i2mint/config2py
-License: apache-2.0
-Platform: any
-Description-Content-Type: text/markdown
+Project-URL: Homepage, https://github.com/i2mint/config2py
+License: Apache-2.0
 License-File: LICENSE
+Requires-Python: >=3.10
 Requires-Dist: dol
 Requires-Dist: i2
-Requires-Dist: importlib_resources; python_version < "3.9"
-Dynamic: license-file
+Requires-Dist: importlib-resources; python_version < '3.9'
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: sphinx-rtd-theme>=1.0; extra == 'docs'
+Requires-Dist: sphinx>=6.0; extra == 'docs'
+Description-Content-Type: text/markdown
 
 # config2py
 

{config2py-0.1.43 → config2py-0.1.45}/config2py/s_configparser.py

@@ -218,7 +218,6 @@ class ConfigStore(ConfigParserStore):
         target_kind=None,
         **more_config_parser_kwargs,
     ):
-
         super().__init__(
             defaults, dict_type, allow_no_value, **more_config_parser_kwargs
         )

{config2py-0.1.43 → config2py-0.1.45}/config2py/sync_store.py

@@ -266,21 +266,38 @@ class FileStore(SyncStore):
         dumper: Optional custom dumper (auto-detected from extension if not provided)
         mode: File read mode ('r' for text, 'rb' for binary)
         dump_kwargs: Additional kwargs for dumper
+        create_file_content: Optional factory callable that returns initial dict content
+            for missing files. If None, FileNotFoundError is raised for missing files.
+        create_key_path_content: Optional factory callable that returns initial content
+            for missing key_path. If None, KeyError is raised for missing key paths.
 
     Example:
         >>> import tempfile
+        >>> import os
+        >>>
+        >>> # Basic usage with existing file
         >>> with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as f:
         ...     _ = f.write('{"section": {"key": "value"}}')
         ...     temp_file = f.name
         >>>
-        >>> # Work with nested section
         >>> section = FileStore(temp_file, key_path='section')
         >>> section['key']
         'value'
         >>> section['new'] = 'data'
-        >>>
-        >>> import os
         >>> os.unlink(temp_file)
+        >>>
+        >>> # Auto-create missing file and key_path
+        >>> with tempfile.TemporaryDirectory() as tmpdir:
+        ...     new_file = os.path.join(tmpdir, 'config.json')
+        ...     store = FileStore(
+        ...         new_file,
+        ...         key_path='servers',
+        ...         create_file_content=lambda: {},
+        ...         create_key_path_content=lambda: {}
+        ...     )
+        ...     store['myserver'] = {'command': 'python'}
+        ...     'myserver' in store
+        True
     """
 
     def __init__(
@@ -292,11 +309,15 @@ class FileStore(SyncStore):
         dumper: Optional[Callable[[dict], str]] = None,
         mode: str = "r",
         dump_kwargs: Optional[dict] = None,
+        create_file_content: Optional[Callable[[], dict]] = None,
+        create_key_path_content: Optional[Callable[[], Any]] = None,
     ):
         self.filepath = Path(filepath).expanduser()
         self.key_path = _normalize_key_path(key_path)
         self.mode = mode
         self.dump_kwargs = dump_kwargs or {}
+        self.create_file_content = create_file_content
+        self.create_key_path_content = create_key_path_content
 
         # Auto-detect format if not provided
         if loader is None or dumper is None:
@@ -318,10 +339,43 @@ class FileStore(SyncStore):
 
     def _load_from_file(self) -> dict:
         """Read and parse file, returning the section specified by key_path."""
-        with open(self.filepath, self.mode) as f:
-            content = f.read()
-        data = self._file_loader(content)
-        return _get_nested(data, self.key_path)
+        # Handle missing file
+        if not self.filepath.exists():
+            if self.create_file_content is None:
+                raise FileNotFoundError(f"File not found: {self.filepath}")
+
+            # Create file with initial content
+            initial_data = self.create_file_content()
+            self.filepath.parent.mkdir(parents=True, exist_ok=True)
+            content = self._file_dumper(initial_data, **self.dump_kwargs)
+            write_mode = "w" if "b" not in self.mode else "wb"
+            with open(self.filepath, write_mode) as f:
+                f.write(content)
+            data = initial_data
+        else:
+            # Load existing file
+            with open(self.filepath, self.mode) as f:
+                content = f.read()
+            data = self._file_loader(content)
+
+        # Handle missing key_path
+        try:
+            return _get_nested(data, self.key_path)
+        except (KeyError, TypeError):
+            if self.create_key_path_content is None:
+                raise KeyError(f"Key path not found: {self.key_path}")
+
+            # Create key_path with initial content
+            initial_content = self.create_key_path_content()
+            full_data = _set_nested(data, self.key_path, initial_content)
+
+            # Write back to file
+            content = self._file_dumper(full_data, **self.dump_kwargs)
+            write_mode = "w" if "b" not in self.mode else "wb"
+            with open(self.filepath, write_mode) as f:
+                f.write(content)
+
+            return initial_content
 
     def _dump_to_file(self, section_data: dict) -> None:
         """Write data to file, updating only the section specified by key_path."""

{config2py-0.1.43 → config2py-0.1.45}/config2py/tools.py

@@ -209,7 +209,6 @@ def source_config_params(*config_params):
     """
 
     def wrapper(func):
-
         sig = Sig(func)
 
         @sig.add_params(["_config_getter"])

config2py-0.1.45/config_store_test.ini

@@ -0,0 +1,4 @@
+[nothing]
+like = that
+ever = happened
+