rkt-config-lib 1.4.0__py3-none-any.whl → 2.0.3__py3-none-any.whl

config/__init__.py

@@ -0,0 +1 @@
+from .config import Config

config/config.py

@@ -0,0 +1,59 @@
+import os
+from typing import Any
+
+import yaml
+
+from logger import Logger
+from tool import Singleton, Tool
+
+
+class Config(metaclass=Singleton):  # type: ignore[metaclass]
+    """
+    Configuration manager wrapping PyYaml.
+
+    This class handles the loading of YAML configuration files from a specific directory.
+    It implements the Singleton pattern to ensure centralized configuration management.
+    """
+
+    __slots__ = ["_me", "_logger", "_tool", "_skills_file", "data"]
+
+    def __init__(self) -> None:
+        self._me = self.__class__.__name__
+        self._logger = Logger(caller_class=self._me)
+        self._logger.set_logger(caller_class=self._me)
+        self._tool = Tool()
+        self.data: dict[str, Any] = {}
+
+    def get_data(self, needed_file: str = "", _config_dir: str = "config", create_if_not_exist: bool = False) -> None:
+        """
+        Load configuration files from the config directory.
+
+        It scans the directory for YAML files and loads them into `self.data`.
+
+        Args:
+            needed_file (str, optional): A specific file to load. If empty, loads all YAML files in the directory.
+                                         Defaults to "".
+            _config_dir (str, optional): Name of the configuration directory. Defaults to "config".
+            create_if_not_exist (bool, optional): Create the config directory if it doesn't exist. Defaults to False.
+        """
+        config_dir = self._tool.get_dir(_config_dir)
+
+        if (not config_dir or not os.path.exists(config_dir)) and create_if_not_exist:
+            os.makedirs(_config_dir, exist_ok=True)
+            config_dir = self._tool.formatted_from_os(os.path.abspath(_config_dir))
+
+        if needed_file:
+            filename = os.path.basename(needed_file).split(".")[0]
+            with open(f"{config_dir}{needed_file}", encoding="utf8") as nf:
+                self._logger.add(level="info", caller=self._me, message=f"Load '{filename}' file ...")
+                self.data[filename] = yaml.safe_load(nf)
+        else:
+            for file in os.listdir(config_dir):
+                try:
+                    (filename, ext) = os.path.basename(file).split(".")
+                except ValueError:
+                    continue
+                if ext in ["yml", "yaml"] and filename not in self.data.keys():
+                    with open(f"{config_dir}{file}", encoding="utf8") as f:
+                        self._logger.add(level="info", caller=self._me, message=f"Load '{filename}' file ...")
+                        self.data[filename] = yaml.safe_load(f)

rkt_config_lib-2.0.3.dist-info/METADATA

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: rkt_config_lib
+Version: 2.0.3
+Summary: RootKit custom PyYaml Lib
+Author-email: RootKit <rootkit@rootkit-lab.org>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: PyYaml>=6.0.1
+Requires-Dist: rkt_tool_lib
+Requires-Dist: rkt_logger_lib
+
+# rkt_config_lib
+
+Centralized Configuration Management wrapper around PyYaml.
+
+## Features
+- **Singleton Pattern**: Ensures a single configuration state across your application.
+- **Auto-Loading**: Automatically scans and loads all YAML files in a `config/` directory.
+- **Safe Loading**: Uses `yaml.safe_load` by default to prevent arbitrary code execution vulnerabilities.
+- **Integrated Logging**: Logs loading operations via `rkt_logger_lib`.
+
+## Usage
+
+```python
+from config import Config
+
+conf = Config()
+# Loads all .yml/.yaml files from ./config/ directory
+conf.get_data()
+
+# Access data (filename becomes the key)
+my_settings = conf.data.get("settings")
+```

rkt_config_lib-2.0.3.dist-info/RECORD

@@ -0,0 +1,6 @@
+config/__init__.py,sha256=Iu75-w9_nlPmnB_qKA7nYaaaHf7xtTrDmK8N4v2WV34,27
+config/config.py,sha256=Xnza7siGOMmhBR3yAqmq042vASKzsElW97y29FOIGcI,2572
+rkt_config_lib-2.0.3.dist-info/METADATA,sha256=KBwIzrLEMFRQStSFndtbFraQgob0pZrX7o3Bpr3EnoE,1067
+rkt_config_lib-2.0.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+rkt_config_lib-2.0.3.dist-info/top_level.txt,sha256=9hK4m828QBN59kTX5IVy40cPd9zUw5QWQF2AlSrXCJ4,7
+rkt_config_lib-2.0.3.dist-info/RECORD,,

{rkt_config_lib-1.4.0.dist-info → rkt_config_lib-2.0.3.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

rkt_config_lib-2.0.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+config

rkt_config_lib/Config.py

@@ -1,53 +0,0 @@
-import os
-import yaml
-
-try:
-    from rkt_logger_lib.Logger import Logger
-except ImportError:
-    from rkt_lib_toolkit.rkt_logger_lib.Logger import Logger
-
-try:
-    from rkt_tool_lib.Tool import Tool, Singleton
-except ImportError:
-    from rkt_lib_toolkit.rkt_tool_lib.Tool import Tool, Singleton
-
-
-class Config(metaclass=Singleton):
-    """
-    Basic PyYaml wrapper
-    add custom logger, list of file need to be load
-
-    """
-    __slots__ = ["_me", "_logger", "_tool", "_skills_file", "data"]
-
-    def __init__(self) -> None:
-        self._me = self.__class__.__name__
-        self._logger = Logger(caller_class=self._me)
-        self._logger.set_logger(caller_class=self._me)
-        self._tool = Tool()
-        self.data = {}
-
-    def get_data(self, needed_file: str = "", _config_dir: str = "config", create_if_not_exist: bool = False) -> None:
-        """
-        Load all file in 'config_dir' and get data in dict formatted as : {"basename_1": <VALUE_1>, ...}
-        """
-        config_dir = self._tool.get_dir(_config_dir)
-
-        if (not config_dir or not os.path.exists(config_dir)) and create_if_not_exist:
-            os.makedirs(_config_dir, exist_ok=True)
-
-        if needed_file:
-            filename = os.path.basename(needed_file).split(".")[0]
-            with open(f"{config_dir}{needed_file}", "r", encoding='utf8') as nf:
-                self._logger.add(level="info", caller=self._me, message=f"Load '{filename}' file ...")
-                self.data[filename] = yaml.load(nf, Loader=yaml.FullLoader)
-        else:
-            for file in os.listdir(config_dir):
-                try:
-                    (filename, ext) = os.path.basename(file).split(".")
-                except ValueError:
-                    continue
-                if ext in ["yml", "yaml"] and filename not in self.data.keys():
-                    with open(f"{config_dir}{file}", "r", encoding='utf8') as f:
-                        self._logger.add(level="info", caller=self._me, message=f"Load '{filename}' file ...")
-                        self.data[filename] = yaml.load(f, Loader=yaml.FullLoader)

rkt_config_lib/__init__.py

@@ -1 +0,0 @@
-from .Config import Config

rkt_config_lib-1.4.0.dist-info/LICENSE

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2016 Dabo Ross
-
-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.

rkt_config_lib-1.4.0.dist-info/METADATA

@@ -1,104 +0,0 @@
-Metadata-Version: 2.2
-Name: rkt_config_lib
-Version: 1.4.0
-Summary: RootKit custom PyYaml Lib
-Author: RootKit
-Author-email: rootkit@rootkit-lab.org
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: End Users/Desktop
-Classifier: Intended Audience :: Information Technology
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Natural Language :: French
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Topic :: Utilities
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: PyYaml
-Requires-Dist: rkt_tool_lib
-Requires-Dist: rkt_logger_lib
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# rkt_config_lib - Python library
-
-![Package Version](https://badgen.net/badge/Package%20Version/latest%20-%201.3.0/green?scale=1.2)
-
-![quality](https://sonarqube.tprc.ovh/api/project_badges/measure?project=python_rkt_lib_toolkit_AXqQ32evGCA0VuRY8SuD&metric=alert_status)
-![reliability_rating](https://sonarqube.tprc.ovh/api/project_badges/measure?project=python_rkt_lib_toolkit_AXqQ32evGCA0VuRY8SuD&metric=reliability_rating)
-![security_rating](https://sonarqube.tprc.ovh/api/project_badges/measure?project=python_rkt_lib_toolkit_AXqQ32evGCA0VuRY8SuD&metric=security_rating)
-![vulnerabilities](https://sonarqube.tprc.ovh/api/project_badges/measure?project=python_rkt_lib_toolkit_AXqQ32evGCA0VuRY8SuD&metric=vulnerabilities)
-![coverage](https://sonarqube.tprc.ovh/api/project_badges/measure?project=python_rkt_lib_toolkit_AXqQ32evGCA0VuRY8SuD&metric=coverage)
-![maintainability](https://sonarqube.tprc.ovh/api/project_badges/measure?project=python_rkt_lib_toolkit_AXqQ32evGCA0VuRY8SuD&metric=sqale_rating)
-
-This Python library is based only on built-in Python libraries and one (1) non-build-in library : [PyYaml](https://pypi.org/project/PyYAML/)
-
-##### Python Version 3.7.2
-##### PyYaml Version 5.4.1 (Released Jan 20, 2021)
-
-----
-
-## What is Python?
-Python is an interpreted high-level general-purpose programming language. Python's design philosophy emphasizes code readability with its notable use of significant indentation. Its language constructs as well as its object-oriented approach aim to help programmers write clear, logical code for small and large-scale projects.
-
-[source](https://en.wikipedia.org/wiki/Python_(programming_language))
-## What is PyYaml?
-YAML is a data serialization format designed for human readability and interaction with scripting languages. PyYAML is a YAML parser and emitter for Python.
-
-PyYAML features a complete YAML 1.1 parser, Unicode support, pickle support, capable extension API, and sensible error messages. PyYAML supports standard YAML tags and provides Python-specific tags that allow to represent an arbitrary Python object.
-
-PyYAML is applicable for a broad range of tasks from complex configuration files to object serialization and persistence.
-
-[source](https://pypi.org/project/PyYAML/)
-## Libraries
-* Config: overlay of PyYaml library (read-only), use Tool and Logger library (rkt_tool_lib, rkt_logger_lib)
-
-## Use it
-### Install
-```bash
- (venv) my_project> pip install rkt_config_lib [--index-url https://gitlab.tprc.ovh/api/v4/groups/python/-/packages/pypi]
-```
-### Example
-```python
-from rkt_config_lib import Config
-
-c = Config()
-
-# by default search folder named "config" in root project folder
-# for load all yaml files
-c.get_data()
-
-print(f"{c.data}")
-```
-
-### Output (as file, sdtout or both)
-```log
-03/03/2022 16:44:09 :: [Logger] :: INFO :: Create logger for 'Config'
-03/03/2022 16:44:09 :: [Logger] :: INFO :: add 'StreamHandler' in 'Config' logger
-03/03/2022 16:44:09 :: [Logger] :: INFO :: add 'FileHandler' in 'Config' logger
-03/03/2022 16:44:09 :: [Config] :: INFO :: Load 'database' file ...
-```
-```
-{'database': {'connect_id': {'dbms': 'mariadb'}}}
-  ^^^^^^^^    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-   |                       |
-   |                      data: file content
- file name without extension
-```
-
-## Contributing
-
-If you find this library useful here's how you can help:
-
-- Send a merge request with your kickass new features and bug fixes
-- Help new users with [issues](https://gitlab.tprc.ovh/python/rkt_lib_toolkit/-/issues) they may encounter
-- Support the development of this library and star this repo!

rkt_config_lib-1.4.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-rkt_config_lib/Config.py,sha256=ypDnZEWDrl8wOFn1yfXjTOvw3OV6Lz4k4KzVxTOWYks,2098
-rkt_config_lib/__init__.py,sha256=dgAqGP8sTB2ZsUt6k9MYpd3Kscb8fgZKVF_V-UCD7b4,27
-rkt_config_lib-1.4.0.dist-info/LICENSE,sha256=cJOcDuuCS3-_wqJQeJzXupPQBeTXBxQR858ECRPkXkw,1097
-rkt_config_lib-1.4.0.dist-info/METADATA,sha256=nPDKhDkAbFda8zOnLsnTZVqGH1Z39VkbERjoRMNoV34,4550
-rkt_config_lib-1.4.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-rkt_config_lib-1.4.0.dist-info/top_level.txt,sha256=gVNNYSVkxR-HO_zOynapeEAmZpco7DioxliVdgpMRfU,15
-rkt_config_lib-1.4.0.dist-info/RECORD,,

rkt_config_lib-1.4.0.dist-info/top_level.txt

@@ -1 +0,0 @@
-rkt_config_lib