adiumentum 0.3.1__py3-none-any.whl → 0.3.2__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):
+    @abstractmethod
     @classmethod
+    def create(cls, *args, **kwargs) -> Self:
+        """
+        Create directories first if they do not already exist.
+        """
+        ...
+
     @abstractmethod
-    def auto(cls, root_dir: Path): ...
+    @classmethod
+    def auto(cls, root_dir: Path, **kwargs) -> Self:
+        """
+        Create directories and files in the default location if they do not alreay exist.
+        """
+        ...
+
 
+    @abstractmethod
     @classmethod
+    def read(cls, config_file_path: Path) -> Self:
+        ...
+    
     @abstractmethod
-    def read(cls, config_file_path: Path) -> Self: ...
+    def write(self, config_file_path: Path) -> None:
+        ...
 
-    @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

@@ -97,13 +97,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,
@@ -275,10 +276,10 @@ class AbstractCustom(ABC):
         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.2.dist-info}/METADATA

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

{adiumentum-0.3.1.dist-info → adiumentum-0.3.2.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=0e6e9d9499d16c4bea9c32fde631aeb6c73684c2fd6e0897b3dd5d5b6e6c6eb2,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=34c2b2920e09e8e018fa8d8a2acd5ee6c3f5a0633b1f3f385c5fccdb2fcc1a4d,12678
 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.2.dist-info/WHEEL,sha256=ab6157bc637547491fb4567cd7ddf26b04d63382916ca16c29a5c8e94c9c9ef7,79
+adiumentum-0.3.2.dist-info/entry_points.txt,sha256=8d158243687a1102f915d2091f19bdc1443ec58709954317c4edff9edb9e5be8,57
+adiumentum-0.3.2.dist-info/METADATA,sha256=2d463e743f3153c2cfd1a62b0ee7467f88002fa2c3d3ada72aa2496ae5d5a7e0,1104
+adiumentum-0.3.2.dist-info/RECORD,,