rkt-tool-lib 1.4.1__py3-none-any.whl → 2.0.0__py3-none-any.whl

rkt_tool_lib-2.0.0.dist-info/METADATA

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: rkt_tool_lib
+Version: 2.0.0
+Summary: RootKit custom tool Lib
+Author-email: RootKit <rootkit@rootkit-lab.org>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7

rkt_tool_lib-2.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+tool/__init__.py,sha256=oZwsPvY-eg-vtlIvJ3f6SDboDl4niL6gA-jN40Ln9Ss,34
+tool/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tool/tool.py,sha256=KmaBffj-wEUw_jdvHF4O_ewts2xlVDjm7rrEu4ZwoY4,2712
+rkt_tool_lib-2.0.0.dist-info/METADATA,sha256=BAJzGHOv6cfGSQLBfe2sVVzuPOh7NfJ0Sb6UbnqQkps,306
+rkt_tool_lib-2.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+rkt_tool_lib-2.0.0.dist-info/top_level.txt,sha256=Z5SN2a_Wr-UEOwAp1ap88PiygkuvFvTwl9QNgw7baG0,5
+rkt_tool_lib-2.0.0.dist-info/RECORD,,

{rkt_tool_lib-1.4.1.dist-info → rkt_tool_lib-2.0.0.dist-info}/WHEEL

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

tool/__init__.py

@@ -1 +1 @@
-from .Tool import Tool, Singleton
+from .tool import Singleton, Tool

tool/tool.py

@@ -0,0 +1,84 @@
+import os
+from typing import Any, Optional
+
+
+class Singleton(type):
+    """
+    The Singleton class can be implemented in different ways in Python. Some
+    possible methods include: base class, decorator, metaclass. We will use the
+    metaclass because it is best suited for this purpose.
+    """
+
+    _instances: dict[type, object] = {}
+
+    def __call__(cls, *args: Any, **kwargs: Any) -> Any:
+        """
+        Possible changes to the value of the `__init__` argument do not affect
+        the returned instance.
+        """
+        if cls not in cls._instances:
+            instance = super().__call__(*args, **kwargs)
+            cls._instances[cls] = instance
+        return cls._instances[cls]
+
+
+class Tool:
+    """
+    Utility class for file system operations.
+
+    Provides cross-platform methods for path formatting and recursive directory searching.
+    """
+
+    @staticmethod
+    def formatted_from_os(path: str) -> str:
+        """
+        Format a path string to match the current operating system's separator.
+
+        Args:
+            path (str): The path to format.
+
+        Returns:
+            str: The formatted path with correct separators and trailing separator handled.
+        """
+        if os.name == "nt":
+            sep = "\\"
+            res = f"{path.replace('/', sep)}{sep if path[-1] != sep else ''}"
+        else:
+            res = f"{path}{'/' if path[-1] != '/' else ''}"
+
+        return res
+
+    def get_cwd(self) -> str:
+        """
+        Get the current working directory, formatted for the OS.
+
+        Returns:
+            str: Absolute path of the CWD.
+        """
+        return self.formatted_from_os(os.getcwd())
+
+    def get_dir(self, folder: str, root: Optional[str] = None) -> Optional[str]:
+        """
+        Recursively search for a directory by name.
+
+        Args:
+            folder (str): The name of the directory to find.
+            root (Optional[str], optional): The root directory to start searching from.
+                                            If None, uses current working directory. Defaults to None.
+
+        Returns:
+            Optional[str]: Absolute path to the found directory, or None if not found.
+        """
+        root = self.get_cwd() if not root else self.formatted_from_os(root)
+
+        for element in os.listdir(root):
+            if os.path.isdir(f"{root}{element}") and element == folder:
+                return self.formatted_from_os(f"{root}{element}")
+
+        for element in os.listdir(root):
+            if os.path.isdir(f"{root}{element}"):
+                found = self.get_dir(folder, self.formatted_from_os(f"{root}{element}"))
+                if found:
+                    return found
+
+        return None

rkt_tool_lib-1.4.1.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_tool_lib-1.4.1.dist-info/METADATA

@@ -1,81 +0,0 @@
-Metadata-Version: 2.1
-Name: rkt-tool-lib
-Version: 1.4.1
-Summary: RootKit custom tool 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
-
-# rkt_tool_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)
-
-##### Python minimal Version 3.7
-
-----
-
-## 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))
-
-## Libraries
-* Tool: toolbox library with, you can automatically format the path in your code without worrying about the platform hosting your script
-
-## Use it
-### Install
-```bash
- (venv) my_project> pip install rkt_tool_lib [--index-url https://gitlab.tprc.ovh/api/v4/groups/python/-/packages/pypi]
-```
-
-### Example
-
-```python
-from rkt_tool_lib import Tool
-
-t = Tool()
-
-print(t.get_cwd())
-print(t.get_dir('db'))
-
-
-```
-
-### Output (as file, sdtout or both)
-windows
-```log
-C:\Users\Me\Documents\path\to\my\project\
-C:\Users\Me\Documents\path\to\my\project\db\
-```
-linux:
-```log
-/home/me/path/to/my/project/
-/home/me/path/to/my/project/db/
-```
-
-## 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_tool_lib-1.4.1.dist-info/RECORD

@@ -1,7 +0,0 @@
-tool/Tool.py,sha256=1wZs4KSffNCbarqdry1d5jLpHjGd-IbUaehMk9SUFe0,1635
-tool/__init__.py,sha256=ZBbSM-vq6CjkI93WRe0-GZ71qXo8WwHmHuZSy79EKXk,34
-rkt_tool_lib-1.4.1.dist-info/LICENSE,sha256=cJOcDuuCS3-_wqJQeJzXupPQBeTXBxQR858ECRPkXkw,1097
-rkt_tool_lib-1.4.1.dist-info/METADATA,sha256=Ap9SBDWptBsdO1DO4HqUZn3iGDtqLg1UIOEW606IuNg,3114
-rkt_tool_lib-1.4.1.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
-rkt_tool_lib-1.4.1.dist-info/top_level.txt,sha256=Z5SN2a_Wr-UEOwAp1ap88PiygkuvFvTwl9QNgw7baG0,5
-rkt_tool_lib-1.4.1.dist-info/RECORD,,

tool/Tool.py

@@ -1,53 +0,0 @@
-import os
-from typing import Optional
-
-
-class Singleton(type):
-    """
-    The Singleton class can be implemented in different ways in Python. Some
-    possible methods include: base class, decorator, metaclass. We will use the
-    metaclass because it is best suited for this purpose.
-    """
-
-    _instances = {}
-
-    def __call__(cls, *args, **kwargs):
-        """
-        Possible changes to the value of the `__init__` argument do not affect
-        the returned instance.
-        """
-        if cls not in cls._instances:
-            instance = super().__call__(*args, **kwargs)
-            cls._instances[cls] = instance
-        return cls._instances[cls]
-
-
-class Tool:
-
-    @staticmethod
-    def formatted_from_os(path) -> str:
-        if os.name == "nt":
-            sep = "\\"
-            res = f'{path.replace("/", sep)}{sep if path[-1] != sep else ""}'
-        else:
-            res = f'{path}{"/" if path[-1] != "/" else ""}'
-
-        return res
-
-    def get_cwd(self) -> str:
-        return self.formatted_from_os(os.getcwd())
-
-    def get_dir(self, folder, root: Optional[str] = None) -> Optional[str]:
-        root = self.get_cwd() if not root else self.formatted_from_os(root)
-
-        for element in os.listdir(root):
-            if os.path.isdir(f"{root}{element}") and element == folder:
-                return self.formatted_from_os(f"{root}{element}")
-
-        for element in os.listdir(root):
-            if os.path.isdir(f"{root}{element}"):
-                found = self.get_dir(folder, self.formatted_from_os(f"{root}{element}"))
-                if found:
-                    return found
-
-        return None