feature: added a class 'Parser' that abstracts from data loaders and dumpers

parse.py

@@ -0,0 +1,82 @@
+from pathlib import Path
+import yaml as yams
+from configparser import ConfigParser as cfg
+from custtypes import ExecutedPath
+from re import compile as rgx, IGNORECASE
+
+class Parser:
+    def __init__(self):
+        self.__is_yaml = rgx(r"\.ya?ml$", flags=IGNORECASE).match
+        self.__is_ini = rgx(r"\.ini$", flags=IGNORECASE).match
+        self.__is_config = rgx(r"\.cfg$", flags=IGNORECASE).match
+        self.__is_json = rgx(r"\.[jb]son$", flags=IGNORECASE).match
+        self.__data = None
+        self.__content: str | None = None
+        self.__is_path: bool = False
+        # @TODO use Enum child class for below type hint instead
+        self.__method: Literal["yaml", "config"] | None = None
+        self.__file: ExecutedPath | None = None
+
+    def load(self, filepath: ExecutedPath | str, **kwargs):
+        if isinstance(filepath, ExecutedPath):
+            self.__is_path = True
+            self.__file = filepath
+            filepath = str(filepath)
+        else:
+            self.__is_path = False
+            if Path(filepath).exists():
+                self.__file = Path(filepath)
+            else:
+                self.__content = filepath
+
+        if self.__is_yaml(filepath):
+            self.__method = "yaml"
+            if len(kwargs) > 0:
+                self.__data = yams.load(filepath, Loader=yams.Loader, **kwargs)
+            else:
+                self.__data = yams.load(filepath, Loader=yams.Loader)
+        elif self.__is_config(filepath):
+            self.__method = "config"
+            self.__data = cfg()
+            if self.__is_path:
+                if len(kwargs) > 0:
+                    self.__data.read(filepath, **kwargs)
+                else:
+                    self.__data.read(filepath)
+            else:
+                if len(kwargs) > 0:
+                    self.__data.read_string(filepath, **kwargs)
+                else:
+                    self.__data.read_string(filepath, **kwargs)
+        else:
+            raise TypeError
+        
+        return self.__data
+
+    def dump(self, obj = None, **kwargs):
+        if self.__method == "yaml":
+            if obj is None:
+                obj = self.__data
+
+            if len(kwargs) > 0:
+                self.__content = yams.dump(obj, Dumper=yams.Dumper, **kwargs)
+            else:
+                self.__content = yams.dump(obj, Dumper=yams.Dumper)
+        elif self.__method == "config":
+            if obj is None:
+                if self.__is_path:
+                    return self.__file
+                else:
+                    if self.__file is None:
+                        return self.__content
+                    else:
+                        return self.__file
+            else:
+                if isinstance(obj, ConfigParser):
+                    return obj
+                else:
+                    raise TypeError
+        else:
+            raise TypeError
+
+        return self.__content