././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1754502140.1263192 redu_config_manager-1.0.0/0000755000175000017500000000000015044711774014512 5ustar00codercoder././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1754488934.0 redu_config_manager-1.0.0/LICENSE0000664000175000017500000000205315044660146015515 0ustar00codercoderMIT License Copyright (c) 2025 Ridwan0110 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. ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1754502140.125319 redu_config_manager-1.0.0/PKG-INFO0000644000175000017500000000341715044711774015614 0ustar00codercoderMetadata-Version: 2.4 Name: redu-config-manager Version: 1.0.0 Summary: A simple configuration manager that reads a configuration file and provides methods to access configuration values programmatically. Home-page: https://github.com/Ridwan0110/redu_config_manager Author: Ridwan Hossain Abid Author-email: ridwan0110@hotmail.com License: MIT Keywords: configuration manager,config manager,yaml,config,settings,application configuration,python config manager Classifier: Development Status :: 5 - Production/Stable Classifier: Topic :: Software Development :: Libraries :: Python Modules Classifier: Programming Language :: Python :: 3 Classifier: Operating System :: OS Independent Classifier: License :: OSI Approved :: MIT License Requires-Python: >=3.6 Description-Content-Type: text/markdown License-File: LICENSE Requires-Dist: pyyaml<7.0.0,>=6.0.0 Requires-Dist: redu-logger@ https://python.ridwanabid.com/repository/simple/redu-logger/redu_logger-1.0.5.tar.gz Dynamic: author Dynamic: author-email Dynamic: classifier Dynamic: description Dynamic: description-content-type Dynamic: home-page Dynamic: keywords Dynamic: license Dynamic: license-file Dynamic: requires-dist Dynamic: requires-python Dynamic: summary # config_manager [![Python](https://img.shields.io/badge/python-3.6%2B-blue?logo=python)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-green)](https://opensource.org/license/mit/) [![Version](https://img.shields.io/badge/version-1.0.0-blue)](https://github.com/Ridwan0110/redu_logger/releases) [![GitHub](https://img.shields.io/badge/source-GitHub-blue?logo=github)](https://github.com/Ridwan0110/config_manager) A simple configuration manager that reads a configuration file and provides methods to access configuration values programmatically. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1754491765.0 redu_config_manager-1.0.0/README.md0000664000175000017500000000110715044665565016000 0ustar00codercoder# config_manager [![Python](https://img.shields.io/badge/python-3.6%2B-blue?logo=python)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-green)](https://opensource.org/license/mit/) [![Version](https://img.shields.io/badge/version-1.0.0-blue)](https://github.com/Ridwan0110/redu_logger/releases) [![GitHub](https://img.shields.io/badge/source-GitHub-blue?logo=github)](https://github.com/Ridwan0110/config_manager) A simple configuration manager that reads a configuration file and provides methods to access configuration values programmatically. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1754371078.0 redu_config_manager-1.0.0/pyproject.toml0000664000175000017500000000013215044312006017405 0ustar00codercoder[build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1754502140.108319 redu_config_manager-1.0.0/redu_config_manager/0000755000175000017500000000000015044711774020470 5ustar00codercoder././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1754501578.0 redu_config_manager-1.0.0/redu_config_manager/__init__.py0000644000175000017500000000015015044710712022564 0ustar00codercoderfrom .redu_config_manager import ConfigManager, __version__ __all__ = ["ConfigManager", "__version__"] ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1754491481.0 redu_config_manager-1.0.0/redu_config_manager/redu_config_manager.py0000644000175000017500000001615415044665131025022 0ustar00codercoder""" A simple configuration manager that reads a configuration file and provides methods to access configuration values programmatically. Only work with supported file formats. """ # Imports import yaml import redu_logger from pathlib import Path from typing import Union __version__ = "1.0.0" # Only these supported file formats will be parsed correctly. # Note: Adding support for more file formats is possible if the logic is implemented. supported_file_formats = ('.yaml', '.yml') class NullLogger: def info(self, *args, **kwargs): pass def warning(self, *args, **kwargs): pass def debug(self, *args, **kwargs): pass def error(self, *args, **kwargs): pass class ConfigManager: def __init__(self, config_path: Union[str, Path], ignore_file_format: bool=False, enable_logging: bool=False, logger_local_log_file_name: str = "config.log", logger_local_log_path: Union[str, Path] = "logs/config" ): """ Initialize the ConfigManager class. :param config_path: Path to the configuration file. :param ignore_file_format: If True, ignore file format checks. NOT RECCOMMENDED. :param enable_logging: If True, enable logging. Default is False. :param logger_local_log_file_name: Name of the local log file. :param logger_local_log_path: Path to the local log file directory. """ # Initialize the logger self.enable_logging = enable_logging self.logger_local_log_file_name = logger_local_log_file_name self.logger_local_log_path = str(logger_local_log_path) if enable_logging: self.logger = self._init_logger() else: self.logger = NullLogger() self.logger.info(f"Initializing ConfigManager with config_path: {config_path}") # Initialize arguments self.config_path = Path(config_path) self.ignore_file_format = ignore_file_format # Check if the file format is supported if not ignore_file_format: self.logger.info("Checking file format...") self._check_file_format() else: self.logger.warning("Ignoring file format check. This is not recommended.", True) # Log all arguments for debugging purposes self.logger.debug("ConfigManager initialized with arguments:") self.logger.info(locals()) # Load the configuration file and store it in memory self.logger.info(f"Loading configuration from {self.config_path}") self._config = None self._load_config() def __repr__(self): """ Return a string representation of the ConfigManager instance. Includes: - The path to the configuration file. - The memory address of the instance. """ self.logger.info(f"Representing ConfigManager instance at {hex(id(self))}") return f"ConfigManager(config_path={self.config_path}, address={hex(id(self))})" def _init_logger(self): """ Initialize redu_logger locally for the ConfigManager. """ # Initialize the logger logger = redu_logger.RemoteLogger( local_logging=True, remote_logging=False, is_main=True, local_log_file_name=self.logger_local_log_file_name, local_log_path=self.logger_local_log_path, local_multi_log=True ) return logger def _check_file_format(self): """ Check if the configuration file has a supported format. Raises: ValueError: If the file format is not supported and ignore_file_format is False. """ self.logger.info(f"Checking file format for {self.config_path}") if not self.config_path.suffix in supported_file_formats: raise ValueError(f"Unsupported file format: {self.config_path.suffix}. Supported formats are: {supported_file_formats}") def _load_config(self): """ Load the configuration file and store it in memory. Raises: FileNotFoundError: If the configuration file does not exist. ValueError: If there is an error loading the YAML file. """ self.logger.info(f"Loading configuration from {self.config_path}") if not self.config_path.exists(): raise FileNotFoundError(f"Config file not found: {self.config_path}") try: with open(self.config_path, "r") as f: self._config = yaml.safe_load(f) if self._config is None: self._config = {} self.logger.info("Configuration file is empty. Initializing with an empty dictionary.") self.logger.info("Configuration loaded successfully.") except yaml.YAMLError as e: self.logger.error(f"Error loading YAML file: {e}", True) raise ValueError(f"Error loading YAML file: {e}") def save_config(self): """ Save the current configuration to the file from the memory. Raises: ValueError: If there is an error saving the YAML file. """ self.logger.info(f"Saving configuration to {self.config_path}") try: with open(self.config_path, "w") as f: yaml.safe_dump(self._config, f) self.logger.info("Configuration saved successfully.") except Exception as e: self.logger.error(f"Error saving YAML file: {e}", True) raise ValueError(f"Error saving YAML file: {e}") def get_value(self, key, default=None): """ Get a configuration value by key. Get nested values using dot notation. i.e. 'nested.key'. :param key: The key to look up in the configuration. :param default: The default value to return if the key is not found. :return: The value associated with the key, or the default value if the key is not found. """ self.logger.info("Getting value for key: {key} with default: {default}") keys = key.split(".") value = self._config for k in keys: if isinstance(value, dict) and k in value: value = value[k] else: return default return value def set_value(self, key, value, save=True): """ Set a configuration value by key. Supports dot-separated keys for nested values. Creates nested dictionaries as needed. :param key: The key (dot-separated for nested) to set. :param value: The value to set. :param save: If True, save the config to file after setting. """ self.logger.info(f"Setting value for key: {key} to {value}") keys = key.split(".") config = self._config for k in keys[:-1]: if k not in config or not isinstance(config[k], dict): config[k] = {} # Create a new dictionary if the key does not exist or is not a dict config = config[k] # Update config to the nested dictionary # Set the final key to the value config[keys[-1]] = value if save: self.save_config() ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1754502140.122319 redu_config_manager-1.0.0/redu_config_manager.egg-info/0000755000175000017500000000000015044711774022162 5ustar00codercoder././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1754502140.0 redu_config_manager-1.0.0/redu_config_manager.egg-info/PKG-INFO0000644000175000017500000000341715044711774023264 0ustar00codercoderMetadata-Version: 2.4 Name: redu-config-manager Version: 1.0.0 Summary: A simple configuration manager that reads a configuration file and provides methods to access configuration values programmatically. Home-page: https://github.com/Ridwan0110/redu_config_manager Author: Ridwan Hossain Abid Author-email: ridwan0110@hotmail.com License: MIT Keywords: configuration manager,config manager,yaml,config,settings,application configuration,python config manager Classifier: Development Status :: 5 - Production/Stable Classifier: Topic :: Software Development :: Libraries :: Python Modules Classifier: Programming Language :: Python :: 3 Classifier: Operating System :: OS Independent Classifier: License :: OSI Approved :: MIT License Requires-Python: >=3.6 Description-Content-Type: text/markdown License-File: LICENSE Requires-Dist: pyyaml<7.0.0,>=6.0.0 Requires-Dist: redu-logger@ https://python.ridwanabid.com/repository/simple/redu-logger/redu_logger-1.0.5.tar.gz Dynamic: author Dynamic: author-email Dynamic: classifier Dynamic: description Dynamic: description-content-type Dynamic: home-page Dynamic: keywords Dynamic: license Dynamic: license-file Dynamic: requires-dist Dynamic: requires-python Dynamic: summary # config_manager [![Python](https://img.shields.io/badge/python-3.6%2B-blue?logo=python)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-green)](https://opensource.org/license/mit/) [![Version](https://img.shields.io/badge/version-1.0.0-blue)](https://github.com/Ridwan0110/redu_logger/releases) [![GitHub](https://img.shields.io/badge/source-GitHub-blue?logo=github)](https://github.com/Ridwan0110/config_manager) A simple configuration manager that reads a configuration file and provides methods to access configuration values programmatically. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1754502140.0 redu_config_manager-1.0.0/redu_config_manager.egg-info/SOURCES.txt0000644000175000017500000000051215044711774024044 0ustar00codercoderLICENSE README.md pyproject.toml setup.py redu_config_manager/__init__.py redu_config_manager/redu_config_manager.py redu_config_manager.egg-info/PKG-INFO redu_config_manager.egg-info/SOURCES.txt redu_config_manager.egg-info/dependency_links.txt redu_config_manager.egg-info/requires.txt redu_config_manager.egg-info/top_level.txt././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1754502140.0 redu_config_manager-1.0.0/redu_config_manager.egg-info/dependency_links.txt0000644000175000017500000000000115044711774026230 0ustar00codercoder ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1754502140.0 redu_config_manager-1.0.0/redu_config_manager.egg-info/requires.txt0000644000175000017500000000016715044711774024566 0ustar00codercoderpyyaml<7.0.0,>=6.0.0 redu-logger@ https://python.ridwanabid.com/repository/simple/redu-logger/redu_logger-1.0.5.tar.gz ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1754502140.0 redu_config_manager-1.0.0/redu_config_manager.egg-info/top_level.txt0000644000175000017500000000002415044711774024710 0ustar00codercoderredu_config_manager ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1754502140.1263192 redu_config_manager-1.0.0/setup.cfg0000644000175000017500000000004615044711774016333 0ustar00codercoder[egg_info] tag_build = tag_date = 0 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1754501578.0 redu_config_manager-1.0.0/setup.py0000644000175000017500000000243615044710712016220 0ustar00codercoderfrom setuptools import setup, find_packages try: with open("README.md", "r", encoding="utf-8") as fh: long_description = fh.read() except FileNotFoundError: long_description = "" setup( name="redu-config-manager", version="1.0.0", author="Ridwan Hossain Abid", author_email="ridwan0110@hotmail.com", url="https://github.com/Ridwan0110/redu_config_manager", license="MIT", description="A simple configuration manager that reads a configuration file and provides methods to access configuration values programmatically.", long_description=long_description, long_description_content_type="text/markdown", packages=find_packages(), install_requires=[ "pyyaml>=6.0.0,<7.0.0", "redu-logger @ https://python.ridwanabid.com/repository/simple/redu-logger/redu_logger-1.0.5.tar.gz" ], classifiers=[ "Development Status :: 5 - Production/Stable", "Topic :: Software Development :: Libraries :: Python Modules", "Programming Language :: Python :: 3", "Operating System :: OS Independent", "License :: OSI Approved :: MIT License" ], python_requires='>=3.6', keywords="configuration manager, config manager, yaml, config, settings, application configuration, python config manager", )