configobjectify 0.1.0__tar.gz

configobjectify-0.1.0/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.

configobjectify-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,82 @@
+## 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/pyproject.toml

@@ -0,0 +1,111 @@
+[build-system]
+requires = ["uv_build>=0.9.13, < 0.14.0"]
+build-backend = "uv_build"
+
+[project]
+name = "configobjectify"
+version = "0.1.0"
+description = "A lightweight Python library for converting Configuration Files into Python Objects."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "config-parsing",
+    "attribute-lookup",
+    "dot-access",
+    "config-files",
+    "config-ini",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = []
+
+[[project.authors]]
+name = "Sandeep Suryaprasad"
+
+[project.urls]
+Homepage = "https://github.com/sandeepsuryaprasad/configobjectify"
+Repository = "https://github.com/sandeepsuryaprasad/configobjectify"
+Issues = "https://github.com/sandeepsuryaprasad/configobjectify/issues"
+
+[dependency-groups]
+test = ["pytest>=8.0.0"]
+lint = ["ruff>=0.14.0"]
+
+[tool.uv.build-backend]
+module-root = "src"
+module-name = "configobjectify"
+
+[tool.ruff]
+line-length = 119
+exclude = [
+    "tests",
+    "sitepackages",
+    ".git",
+    ".github",
+    "__pycache__",
+    ".venv",
+    "build",
+    "dist",
+    ".pytest_cache",
+    ".tox",
+    ".vscode",
+    ".ruff_cache",
+    ".mypy_cache",
+    ".nox",
+    ".eggs",
+]
+
+[tool.ruff.lint]
+select = [
+    "F",
+    "N",
+    "E9",
+    "I",
+    "E501",
+    "RUF022",
+    "TID252",
+    "F841",
+    "N816",
+    "B007",
+    "D403",
+    "D101",
+    "D102",
+    "D103",
+    "D106",
+    "D201",
+    "D202",
+    "D204",
+    "D300",
+    "D404",
+    "D405",
+    "D419",
+    "E402",
+    "E401",
+    "E711",
+    "E712",
+    "E721",
+    "E722",
+    "E731",
+]
+ignore = [
+    "D100",
+    "D101",
+    "D104",
+    "D105",
+    "D107",
+    "D212",
+    "D415",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

configobjectify-0.1.0/pyproject.toml.orig

@@ -0,0 +1,106 @@
+[build-system]
+requires = ["uv_build>=0.9.13, < 0.14.0"]
+build-backend = "uv_build"
+
+[project]
+name = "configobjectify"
+version = "0.1.0"
+description = "A lightweight Python library for converting Configuration Files into Python Objects."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords =["config-parsing", "attribute-lookup", "dot-access", "config-files", "config-ini"]
+authors = [
+    {name= "Sandeep Suryaprasad"}
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/sandeepsuryaprasad/configobjectify"
+Repository = "https://github.com/sandeepsuryaprasad/configobjectify"
+Issues = "https://github.com/sandeepsuryaprasad/configobjectify/issues"
+
+[dependency-groups]
+test = ["pytest>=8.0.0"]
+lint = ["ruff>=0.14.0"]
+
+[tool.uv.build-backend]
+module-root = "src"
+module-name = "configobjectify"
+
+[tool.ruff]
+line-length = 119
+exclude = [
+    "tests",
+    "sitepackages",
+    ".git",
+    ".github",
+    "__pycache__",
+    ".venv",
+    "build",
+    "dist",
+    ".pytest_cache",
+    ".tox",
+    ".vscode",
+    ".ruff_cache",
+    ".mypy_cache",
+    ".nox",
+    ".eggs"
+    ]
+
+[tool.ruff.lint]
+select = [
+   "F",
+   "N",
+   "E9",      # Checks for common syntax errors, indendation errors
+   "I",
+   "E501",    # Checks for lines that exceed the specified maximum character length.
+   "RUF022",
+   "TID252",
+   "F841",    # Checks for the presence of unused variables in function scopes.
+   "N816",    # Checks for global variable names that follow the mixedCase convention.
+   "B007",    # Checks for unused variables in loops (e.g., for and while statements).
+   "D403",    # Checks for docstrings that do not start with a capital letter.
+   "D101",
+   "D102",    # Checks for undocumented public method definitions.
+   "D103",    # Checks for undocumented public function definitions.
+   "D106",    # Checks for undocumented public class definitions, for nested classes.
+   "D201",    # Checks for docstrings on functions that are separated by one or more blank lines from the function definition.
+   "D202",    # Checks for docstrings on functions that are separated by one or more blank lines from the function body.
+   "D204",    # Checks for class methods that are not separated from the class's docstring by a blank line.
+   "D300",    # Checks for docstrings that use '''triple single quotes''' instead of """triple double quotes""".
+   "D404",    # Checks for docstrings that start with This.
+   "D405",    # Checks for section headers in docstrings that do not begin with capital letters.
+   "D419",    # Checks for empty docstrings.
+   "E402",    # Checks for imports that are not at the top of the file.
+   "E401",    # Check for multiple imports on one line.
+   "E711",    # Checks for comparisons to None which are not using the is operator.
+   "E712",    # Checks for equality comparisons to boolean literals.
+   "E721",    # Checks for object type comparisons using == and other comparison operators.
+   "E722",    # Checks for bare except catches in try-except statements.
+   "E731",    # Checks for lambda expressions which are assigned to a variable.
+]
+
+ignore = [
+    "D100", # Missing docstring in public module
+    "D101", # Missing docstring in public class
+    "D104", # Missing docstring in public package
+    "D105", # Missing docstring in magic method
+    "D107", # Missing docstring in `__init__`
+    "D212", # Multi-line docstring summary should start at the first line
+    "D415"  # Ignore if the doc string does not end with any punctuation
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

configobjectify-0.1.0/src/configobjectify/__init__.py

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

configobjectify-0.1.0/src/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}")'