configobjectify 0.1.0__py3-none-any.whl

configobjectify/__init__.py

@@ -0,0 +1,6 @@
+from importlib.metadata import version
+from .config import Config
+
+__version__ = version("configobjectify")
+
+__all__ = ["Config", "__version__"]

configobjectify/config.py

@@ -0,0 +1,88 @@
+from pathlib import Path
+from configparser import ConfigParser, SectionProxy
+from typing import Optional
+
+
+class Config:
+    def __init__(self, filepath: str | Path, section: str):
+        self.section: str = section.upper()
+        self.config_file = self._get_config_file(filepath)
+        self._parser: ConfigParser = self._get_parser()
+        self._data: SectionProxy = self._parse_to_dict
+        self._attr: Optional[str] = None
+
+    def _get_config_file(self, filename: str | Path) -> Path:
+        """Validate the configuration file path and return it as a Path object.
+
+        Args:
+        filename: Path to the configuration file.
+
+        Returns:
+        A Path object representing the validated INI file.
+
+        Raises:
+        FileNotFoundError: If the path does not point to an existing file.
+        ValueError: If the file does not have an .ini extension.
+        """
+        path = Path(filename)
+        if not path.is_file():
+            raise FileNotFoundError(f"{filename!r} not found")
+        if path.suffix.lower() != ".ini":
+            raise ValueError(f"Invalid file extension: {path.suffix!r}")
+        return path
+
+    def _get_parser(self) -> ConfigParser:
+        """Return a configured `ConfigParser` instance.
+        The parser reads configuration data from `valid.ini`.
+        """
+        parser = ConfigParser()
+        parser.read(self.config_file)
+        return parser
+
+    @property
+    def _parse_to_dict(self) -> SectionProxy:
+        """Return the selected configuration section as a dictionary.
+        Each configuration key in the selected section is stored as a
+        key-value pair in the returned dictionary.
+
+        Returns:
+            A dictionary containing the configuration values for the
+            selected section.
+
+        Raises:
+            KeyError: If the selected section does not exist.
+        """
+        if not self._parser.has_section(self.section):
+            raise KeyError(f"Invalid section {self.section!r}")
+        return self._parser[self.section]
+
+    @property
+    def value(self) -> str:
+        """Return the value of the most recently accessed configuration key.
+        Returns:
+            The configuration value associated with the accessed key,
+            or an empty string if the key does not exist.
+        """
+        return self._data.get(self._attr, "")
+
+    def __getattr__(self, name):
+        """Capture access to an undefined attribute.
+        The attribute name is stored internally and the current
+        `Config` instance is returned, allowing configuration values
+        to be accessed through expressions such as `config.device_name.value`.
+
+        Args:
+            name: Name of the configuration attribute being accessed.
+
+        Returns:
+            The current `Config` instance.
+        """
+        self._attr = name
+        return self
+
+    def __repr__(self):
+        """Return the string representation of the configuration object.
+        Returns:
+            A string containing the selected configuration section.
+        """
+        return f'Config("{self.section}")'

configobjectify-0.1.0.dist-info/METADATA

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: configobjectify
+Version: 0.1.0
+Summary: A lightweight Python library for converting Configuration Files into Python Objects.
+Keywords: config-parsing,attribute-lookup,dot-access,config-files,config-ini
+Author: Sandeep Suryaprasad
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/sandeepsuryaprasad/configobjectify
+Project-URL: Repository, https://github.com/sandeepsuryaprasad/configobjectify
+Project-URL: Issues, https://github.com/sandeepsuryaprasad/configobjectify/issues
+Description-Content-Type: text/markdown
+
+## configobjectify
+
+[![CI](https://github.com/sandeepsuryaprasad/configobjectify/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/sandeepsuryaprasad/configbjectify/actions/workflows/ci.yml)
+[![Development Status](https://img.shields.io/pypi/status/configobjectify)](https://pypi.org/project/configobjectify/)
+[![Python versions](https://img.shields.io/pypi/pyversions/configobjectify?label=Python)](https://pypi.org/project/configobjectify/)
+
+A lightweight Python library that provides an object-oriented 
+interface for accessing values from INI configuration files. Instead of retrieving 
+values using dictionary-style or section-based lookups, you can access configuration 
+keys through dot notation.
+
+## Installation
+```console
+pip install configobjectify
+```
+
+## Usage
+Consider the following `config.ini` file,
+```console
+[APPLE]
+device_name = iPhone
+model = iPhone 17
+os_version = 26.0
+
+[ANDROID]
+device_name = Pixel
+model = Pixel 10
+os_version = 16
+```
+
+```console
+>>> from configobjectify import Config
+>>> config = Config("config.ini", "APPLE")
+>>> config.device_name.value
+'iPhone'
+>>> config.model.value
+'iPhone 17'
+>>> config.os_version.value
+'26.0'
+```
+### Selecting a different section
+```console
+>>> config = Config("config.ini", "ANDROID")
+>>> config.device_name.value
+'Pixel'
+>>> config.model.value
+'Pixel 10'
+>>> config.os_version.value
+'16.0'
+```
+NOTE: Section names are normalized to uppercase by the library before lookup.
+
+### Handling missing configuration keys
+```console
+>>> config = Config("config.ini", "APPLE")
+>>> config.country_of_origin.value
+>>> ''
+```
+
+### Installed version
+To get to know the version of `configobjectify`,
+```console
+>>> import configobjectify
+>>> print(configobjectify.__version__)
+```
+or
+```console
+>>> from configobjectify import __version__
+>>> print(__version__)
+```
+
+### Requirements
+* Python 3.12 or later
+
+### Contributing
+Contributions, bug reports, and feature suggestions are welcome. Please open an issue to 
+discuss a proposed change before submitting a pull request.
+
+### License
+
+This package is distributed under the terms of [MIT](https://github.com/sandeepsuryaprasad/configobjectify/blob/main/LICENSE) license
+

configobjectify-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+configobjectify/__init__.py,sha256=hgMn80XcbK4ROwVVV-Ii-2F5-NwCEsIq5tHa4kxUGlQ,144
+configobjectify/config.py,sha256=unHtvOSBUBvrfCdl5cgY3LfFp36xTQO3F5PeG7dcAGc,3099
+configobjectify-0.1.0.dist-info/licenses/LICENSE,sha256=_d_Gwo-7FYsk-c6_vlvLIZTRy9byE2RSBxaCq_MUV4M,1076
+configobjectify-0.1.0.dist-info/WHEEL,sha256=3NO1oYsF7mANFUWVdyEQLM-zmecczWWEmmF5rEbXrWk,80
+configobjectify-0.1.0.dist-info/METADATA,sha256=iwmw7M5ZanWCthkF3J60OIgJXi69aBP7cqJAfY29itA,3076
+configobjectify-0.1.0.dist-info/RECORD,,

configobjectify-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.13.6
+Root-Is-Purelib: true
+Tag: py3-none-any

configobjectify-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sandeep Suryaprasad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.