adiumentum 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

adiumentum/paths_manager.py

@@ -1,19 +1,67 @@
-from abc import abstractmethod
+from abc import ABC, abstractmethod
 from pathlib import Path
 from typing import Self
 
+from pydantic import BaseModel
+
+
+# class PathsManager:
+#     @abstractmethod
+#     def setup(self) -> None: ...
+
+#     @classmethod
+#     @abstractmethod
+#     def auto(cls, root_dir: Path): ...
+
+#     @classmethod
+#     @abstractmethod
+#     def read(cls, config_file_path: Path) -> Self: ...
+
+#     @abstractmethod
+#     def write(self, config_file_path: Path) -> None: ...
 
-class PathsManager:
-    @abstractmethod
-    def setup(self) -> None: ...
 
+
+class PathsManager(BaseModel, ABC):
     @classmethod
     @abstractmethod
-    def auto(cls, root_dir: Path): ...
+    def create(cls, *args, **kwargs) -> Self:
+        """
+        Create directories first if they do not already exist.
+        """
+        ...
 
     @classmethod
     @abstractmethod
-    def read(cls, config_file_path: Path) -> Self: ...
+    def auto(cls, root_dir: Path, **kwargs) -> Self:
+        """
+        Create directories and files in the default location if they do not alreay exist.
+        """
+        ...
+
 
+    @classmethod
     @abstractmethod
-    def write(self, config_file_path: Path) -> None: ...
+    def read(cls, config_file_path: Path) -> Self:
+        ...
+    
+    @abstractmethod
+    def write(self, config_file_path: Path) -> None:
+        ...
+
+    @staticmethod
+    def ensure_file_exists(p: Path, content_if_empty: str = "") -> Path:
+        if not p.exists():
+            p.touch()
+            if content_if_empty:
+                p.write_text(content_if_empty)
+        return p
+
+    @staticmethod
+    def ensure_directory_exists(p: Path) -> Path:
+        for parent in p.parents:
+            if not parent.exists():
+                parent.mkdir()
+        if not p.exists():
+            p.mkdir()
+        return p

adiumentum/pydantic_extensions.py

@@ -67,7 +67,6 @@ class AbstractCustom(ABC):
         json_schema = handler.resolve_ref_schema(json_schema)
         return json_schema
 
-    @abstractmethod
     def __init__(self, *args, **kwargs) -> None:
         TypeError(f"Use `model_validate` to instantiate {self.__class__.__name__}")
 
@@ -97,13 +96,14 @@ class AbstractCustom(ABC):
         return set()
 
     @classmethod
-    @abstractmethod
-    def model_construct(cls, _fields_set: set[str] | None = None, **values: Any) -> Self: ...
+    def model_construct(cls, _fields_set: set[str] | None = None, **values: Any) -> Self:
+        raise NotImplementedError
 
-    @abstractmethod
     def model_copy(
         self, *, update: Mapping[str, Any] | None = None, deep: bool = False
-    ) -> Self: ...
+    ) -> Self:
+        return self.__class__.model_validate(self.model_dump())
+        
 
     def model_dump(
         self,
@@ -258,7 +258,6 @@ class AbstractCustom(ABC):
         return cls.post_validation_hook(validated)
 
     @classmethod
-    @abstractmethod
     def model_validate_strings(
         cls,
         obj: Any,
@@ -268,17 +267,25 @@ class AbstractCustom(ABC):
         context: Any | None = None,
         by_alias: bool | None = None,
         by_name: bool | None = None,
-    ) -> Self: ...
+    ) -> Self:
+        return cls.model_validate(
+            obj,
+            strict=strict,
+            extra=extra,
+            context=context,
+            by_alias=by_alias,
+            by_name=by_name,
+        )
 
     @property
     def __annotations__(self) -> dict[str, Any]:  # type: ignore
         return self.get_adapter().__annotations__
 
     @classmethod
-    def read(cls, read_path: Path) -> Self:
+    def read_json_file(cls, read_path: Path) -> Self:
         return cls.model_validate_json(read_path.read_text())
 
-    def write(self, write_path: Path) -> None:
+    def write_json_file(self, write_path: Path) -> None:
         write_json(cast(JSONDict, self.model_dump(mode="json")), write_path)
 
     @staticmethod

{adiumentum-0.3.1.dist-info → adiumentum-0.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: adiumentum
-Version: 0.3.1
+Version: 0.3.3
 Summary: 
 Author: Isaac Riley
 Author-email: Isaac Riley <yelircaasi@proton.me>

{adiumentum-0.3.1.dist-info → adiumentum-0.3.3.dist-info}/RECORD

@@ -13,14 +13,14 @@ adiumentum/io_utils.py,sha256=033110e6b9335ad4270cf62c86a0df53c5c43954521a814729
 adiumentum/markers.py,sha256=988f0b7ef80d61871165f30b601f05c9981cfd353c235eb314de5271e8040900,2959
 adiumentum/merge.py,sha256=b1894b08e906ead6f423dfb6d637df553eeed4f894c197f771f3569854044c32,3877
 adiumentum/numerical.py,sha256=adad3335e7220c8bf9666ce8c79f01ca4f1a0933316bb8e6fbfc0440293fbbed,704
-adiumentum/paths_manager.py,sha256=7098bf8bd71cbe93eb60eb8c145a3f02d3e3470c2f236e8bb579c08cf0db5579,403
+adiumentum/paths_manager.py,sha256=875679909583a0a89fc3213f30618c8a0b3215eec949501c4057ef19a103857d,1565
 adiumentum/performance_logging.py,sha256=bd0c42337fb5c77921700e5487d366ea103e8cd25825138962bfb44c1b54773b,1471
 adiumentum/pydantic_extensions.md,sha256=6f5fe7fc9f10e0f6a87e2861dd16d066892099542dbaca3764944c6a27635706,24936
-adiumentum/pydantic_extensions.py,sha256=8e49c80f4be42b71986ec93195172af2d83986598de3f1bffe4c64505dc03729,12599
+adiumentum/pydantic_extensions.py,sha256=1cb110bf9fd8a4834463d070fd3539a6b4e7ac9f467c27ca7cae04d2507e9ca3,12837
 adiumentum/string_utils.py,sha256=459576481a67d1f078ffcbb0606ba235d0694cb0911905174239312224953f66,5321
 adiumentum/timestamping.py,sha256=87729ac9dd7dac614fbb7bb1995e321bd860202a4c2f435e044f4af23dd545a0,556
 adiumentum/typing_utils.py,sha256=81e01e90a60fe397c5211493fb4446af5f59fbd4b364c98f377962f4bd67ff8b,3894
-adiumentum-0.3.1.dist-info/WHEEL,sha256=ab6157bc637547491fb4567cd7ddf26b04d63382916ca16c29a5c8e94c9c9ef7,79
-adiumentum-0.3.1.dist-info/entry_points.txt,sha256=8d158243687a1102f915d2091f19bdc1443ec58709954317c4edff9edb9e5be8,57
-adiumentum-0.3.1.dist-info/METADATA,sha256=ca600da9feaa1c5346895161b9cd661cf894e05b2e8b601b6e082165a32c6afc,1104
-adiumentum-0.3.1.dist-info/RECORD,,
+adiumentum-0.3.3.dist-info/WHEEL,sha256=ab6157bc637547491fb4567cd7ddf26b04d63382916ca16c29a5c8e94c9c9ef7,79
+adiumentum-0.3.3.dist-info/entry_points.txt,sha256=8d158243687a1102f915d2091f19bdc1443ec58709954317c4edff9edb9e5be8,57
+adiumentum-0.3.3.dist-info/METADATA,sha256=403790211f3cea6589e2fdc337facfb1553b26f910889b4cea6ce5e7003a43f0,1104
+adiumentum-0.3.3.dist-info/RECORD,,