adiumentum 0.3.1__tar.gz → 0.3.3__tar.gz

{adiumentum-0.3.1 → adiumentum-0.3.3}/PKG-INFO

@@ -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 → adiumentum-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "adiumentum"
-version = "0.3.1"
+version = "0.3.3"
 description = ""
 authors = [{name = "Isaac Riley", email = "yelircaasi@proton.me"}]
 readme = "README.md"

adiumentum-0.3.3/src/adiumentum/paths_manager.py

@@ -0,0 +1,67 @@
+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(BaseModel, ABC):
+    @classmethod
+    @abstractmethod
+    def create(cls, *args, **kwargs) -> Self:
+        """
+        Create directories first if they do not already exist.
+        """
+        ...
+
+    @classmethod
+    @abstractmethod
+    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 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-0.3.1 → adiumentum-0.3.3}/src/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/src/adiumentum/paths_manager.py

@@ -1,19 +0,0 @@
-from abc import abstractmethod
-from pathlib import Path
-from typing import Self
-
-
-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: ...