ramifice 0.3.19__py3-none-any.whl → 0.3.21__py3-none-any.whl

ramifice/decorators.py

@@ -12,6 +12,7 @@ from .hooks import HooksMixin
 from .indexing import IndexMixin
 from .model import Model
 from .paladins import CheckMixin, QPaladinsMixin, ValidationMixin  # type: ignore[attr-defined]
+from .pseudo_model import PseudoModel
 from .store import REGEX
 
 
@@ -55,7 +56,10 @@ def model(
                 raise PanicError(msg)
 
         attrs = {key: val for key, val in cls.__dict__.items()}
-        attrs["__dict__"] = Model.__dict__["__dict__"]
+        if is_migrate_model:
+            attrs["__dict__"] = Model.__dict__["__dict__"]
+        else:
+            attrs["__dict__"] = PseudoModel.__dict__["__dict__"]
         metadata = {
             "service_name": service_name,
             "fixture_name": fixture_name,
@@ -65,7 +69,10 @@ def model(
             "is_update_doc": is_update_doc if is_migrate_model else False,
             "is_delete_doc": is_delete_doc if is_migrate_model else False,
         }
-        attrs["META"] = {**metadata, **caching(cls, service_name)}
+        attrs["META"] = {
+            **metadata,
+            **caching(cls, service_name, is_migrate_model),
+        }
 
         if is_migrate_model:
             return type(
@@ -84,7 +91,7 @@ def model(
             return type(
                 cls.__name__,
                 (
-                    Model,
+                    PseudoModel,
                     ValidationMixin,
                     CheckMixin,
                     AddValidMixin,
@@ -95,7 +102,7 @@ def model(
     return decorator
 
 
-def caching(cls: Any, service_name: str) -> dict[str, Any]:
+def caching(cls: Any, service_name: str, is_migrate_model: bool) -> dict[str, Any]:
     """Add additional metadata to `Model.META`."""
     metadata: dict[str, Any] = {}
     model_name = cls.__name__
@@ -117,14 +124,13 @@ def caching(cls: Any, service_name: str) -> dict[str, Any]:
     # Count fields for migrating.
     count_fields_for_migrating = 0
 
-    old_model = cls()
-    old_model.fields()
-    default_fields: dict[str, Any] = {
-        "_id": IDField(),
-        "created_at": DateTimeField(),
-        "updated_at": DateTimeField(),
-    }
-    fields = {**old_model.__dict__, **default_fields}
+    raw_model = cls()
+    raw_model.fields()
+    default_fields: dict[str, Any] = {"_id": IDField()}
+    if is_migrate_model:
+        default_fields["created_at"] = DateTimeField()
+        default_fields["updated_at"] = DateTimeField()
+    fields = {**raw_model.__dict__, **default_fields}
     for f_name, f_type in fields.items():
         if not callable(f_type):
             f_type_str = f_type.__class__.__name__
@@ -138,7 +144,8 @@ def caching(cls: Any, service_name: str) -> dict[str, Any]:
             #
             if not f_type.ignored:
                 # Count fields for migrating.
-                count_fields_for_migrating += 1
+                if is_migrate_model:
+                    count_fields_for_migrating += 1
                 # Get a dictionary of field names and types.
                 field_name_and_type[f_name] = f_type_str
                 # Build data migration storage for dynamic fields.

ramifice/fields/file_field.py

@@ -4,7 +4,7 @@ import os
 import shutil
 import uuid
 from base64 import b64decode
-from datetime import datetime
+from datetime import date
 from pathlib import Path
 from typing import Any
 
@@ -121,7 +121,7 @@ class FileField(Field, FileGroup, JsonMixin):
             # Create new (uuid) file name.
             f_uuid_name = f"{uuid.uuid4()}{extension}"
             # Create the current date for the directory name.
-            date_str = datetime.now().strftime("%Y-%m-%d")
+            date_str: str = str(date.today())
             # Create path to target directory.
             dir_target_path = f"{self.media_root}/{self.target_dir}/{date_str}"
             # Create target directory if it does not exist.
@@ -166,7 +166,7 @@ class FileField(Field, FileGroup, JsonMixin):
             # Create new (uuid) file name.
             f_uuid_name = f"{uuid.uuid4()}{extension}"
             # Create the current date for the directory name.
-            date_str = datetime.now().strftime("%Y-%m-%d")
+            date_str: str = str(date.today())
             # Create path to target directory.
             dir_target_path = f"{self.media_root}/{self.target_dir}/{date_str}"
             # Create target directory if it does not exist.

ramifice/fields/image_field.py

@@ -4,7 +4,7 @@ import os
 import shutil
 import uuid
 from base64 import b64decode
-from datetime import datetime
+from datetime import date
 from pathlib import Path
 from typing import Any
 
@@ -135,7 +135,6 @@ class ImageField(Field, FileGroup, JsonMixin):
         base64_str: str | None = None,
         filename: str | None = None,
         is_delete: bool = False,
-        add_wh: bool = False,
     ) -> None:
         """Convert base64 to a image,
         get image information and save in the target directory.
@@ -159,7 +158,7 @@ class ImageField(Field, FileGroup, JsonMixin):
                 if item[0] == 40:
                     break
             # Create the current date for the directory name.
-            date_str = datetime.now().strftime("%Y-%m-%d")
+            date_str: str = str(date.today())
             # Directory name for the original image and its thumbnails.
             general_dir = uuid.uuid4()
             # Create path to target directory with images.
@@ -181,7 +180,7 @@ class ImageField(Field, FileGroup, JsonMixin):
             img_info["path"] = main_img_path
             img_info["url"] = f"{imgs_dir_url}/{new_original_name}"
             # Add width and height.
-            if add_wh:
+            if self.__dict__.get("add_width_height", False):
                 with Image.open(main_img_path) as img:
                     width, height = img.size
                     img_info["width"] = width
@@ -209,7 +208,6 @@ class ImageField(Field, FileGroup, JsonMixin):
         self,
         src_path: str | None = None,
         is_delete: bool = False,
-        add_wh: bool = False,
     ) -> None:
         """Get image information and copy the image to the target directory."""
         src_path = src_path or None
@@ -224,7 +222,7 @@ class ImageField(Field, FileGroup, JsonMixin):
                 msg = f"The image `{src_path}` has no extension."
                 raise FileHasNoExtensionError(msg)
             # Create the current date for the directory name.
-            date_str = datetime.now().strftime("%Y-%m-%d")
+            date_str: str = str(date.today())
             # Directory name for the original image and its thumbnails.
             general_dir = uuid.uuid4()
             # Create path to target directory with images.
@@ -244,7 +242,7 @@ class ImageField(Field, FileGroup, JsonMixin):
             img_info["path"] = main_img_path
             img_info["url"] = f"{imgs_dir_url}/{new_original_name}"
             # Add width and height.
-            if add_wh:
+            if self.__dict__.get("add_width_height", False):
                 with Image.open(main_img_path) as img:
                     width, height = img.size
                     img_info["width"] = width

ramifice/model.py

@@ -1,8 +1,6 @@
 """For converting Python classes into Ramifice Model."""
 
 import json
-import os
-import shutil
 from abc import ABCMeta, abstractmethod
 from typing import Any
 
@@ -15,7 +13,7 @@ from .fields import DateTimeField, IDField  # type: ignore[attr-defined]
 
 
 class Model(metaclass=ABCMeta):
-    """For converting Python classes into Ramifice Model."""
+    """For converting Python Class into Ramifice Model."""
 
     META: dict[str, Any] = {}
 
@@ -47,24 +45,6 @@ class Model(metaclass=ABCMeta):
         self.fields()
         self.inject()
 
-    def __del__(self) -> None:  # noqa: D105
-        # If the model is not migrated,
-        # it must delete files and images in the destructor.
-        if not self.__class__.META["is_migrate_model"]:
-            for _, f_type in self.__dict__.items():
-                if not callable(f_type):
-                    value = f_type.value
-                    if value is None:
-                        continue
-                    if f_type.group == "file":
-                        value = value.get("path")
-                        if value is not None:
-                            os.remove(value)
-                    elif f_type.group == "img":
-                        value = value.get("imgs_dir_path")
-                        if value is not None:
-                            shutil.rmtree(value)
-
     @abstractmethod
     def fields(self) -> None:
         """For adding fields."""

ramifice/pseudo_model.py

@@ -0,0 +1,183 @@
+"""For converting Python classes into Ramifice Model."""
+
+import json
+import os
+import shutil
+from abc import ABCMeta, abstractmethod
+from typing import Any
+
+from babel.dates import format_date, format_datetime
+from bson.objectid import ObjectId
+from dateutil.parser import parse
+
+from . import translations
+from .fields import IDField  # type: ignore[attr-defined]
+
+
+class PseudoModel(metaclass=ABCMeta):
+    """For convert the Python class into a pseudo model Ramifice.
+
+    Used for a Model that do not migrate into the database.
+    """
+
+    META: dict[str, Any] = {}
+
+    def __init__(self) -> None:  # noqa: D107
+        self._id = IDField(
+            label="Stub",
+            placeholder="Stub",
+            hint="Stub",
+            hide=True,
+            disabled=True,
+        )
+        self.fields()
+        self.inject()
+        for _, f_type in self.__dict__.items():
+            if not callable(f_type):
+                if f_type.group == "img":
+                    f_type.__dict__["add_width_height"] = True
+
+    def __del__(self) -> None:  # noqa: D105
+        # If the model is not migrated,
+        # it must delete files and images in the destructor.
+        for _, f_type in self.__dict__.items():
+            if not callable(f_type):
+                value = f_type.value
+                if value is None:
+                    continue
+                if f_type.group == "file":
+                    value = value.get("path")
+                    if value is not None:
+                        os.remove(value)
+                elif f_type.group == "img":
+                    value = value.get("imgs_dir_path")
+                    if value is not None:
+                        shutil.rmtree(value)
+
+    @abstractmethod
+    def fields(self) -> None:
+        """For adding fields."""
+        pass
+
+    def model_name(self) -> str:
+        """Get Model name - Class name."""
+        return self.__class__.__name__
+
+    def full_model_name(self) -> str:
+        """Get full Model name - module_name + . + ClassName."""
+        cls = self.__class__
+        return f"{cls.__module__}.{cls.__name__}"
+
+    def inject(self) -> None:
+        """Injecting metadata from Model.META in params of fields."""
+        metadata = self.__class__.META
+        if bool(metadata):
+            field_attrs = metadata["field_attrs"]
+            data_dynamic_fields = metadata["data_dynamic_fields"]
+            for f_name, f_type in self.__dict__.items():
+                if not callable(f_type):
+                    f_type.id = field_attrs[f_name]["id"]
+                    f_type.name = field_attrs[f_name]["name"]
+                    if "Dyn" in f_type.field_type:
+                        f_type.choices = data_dynamic_fields[f_name]
+
+    # Complect of methods for converting Model to JSON and back.
+    # --------------------------------------------------------------------------
+    def to_dict(self) -> dict[str, Any]:
+        """Convert object instance to a dictionary."""
+        json_dict: dict[str, Any] = {}
+        for name, data in self.__dict__.items():
+            if not callable(data):
+                json_dict[name] = data.to_dict()
+        return json_dict
+
+    def to_json(self) -> str:
+        """Convert object instance to a JSON string."""
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_dict(cls, json_dict: dict[str, Any]) -> Any:
+        """Convert JSON string to a object instance."""
+        obj = cls()
+        for name, data in json_dict.items():
+            obj.__dict__[name] = obj.__dict__[name].__class__.from_dict(data)
+        return obj
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Any:
+        """Convert JSON string to a object instance."""
+        json_dict = json.loads(json_str)
+        return cls.from_dict(json_dict)
+
+    # --------------------------------------------------------------------------
+    def to_dict_only_value(self) -> dict[str, Any]:
+        """Convert model.field.value (only the `value` attribute) to a dictionary."""
+        json_dict: dict[str, Any] = {}
+        current_locale = translations.CURRENT_LOCALE
+        for name, data in self.__dict__.items():
+            if callable(data):
+                continue
+            value = data.value
+            if value is not None:
+                group = data.group
+                if group == "date":
+                    value = (
+                        format_date(
+                            date=value,
+                            format="short",
+                            locale=current_locale,
+                        )
+                        if data.field_type == "DateField"
+                        else format_datetime(
+                            datetime=value,
+                            format="short",
+                            locale=current_locale,
+                        )
+                    )
+                elif group == "id":
+                    value = str(value)
+                elif group == "pass":
+                    value = None
+            json_dict[name] = value
+        return json_dict
+
+    def to_json_only_value(self) -> str:
+        """Convert model.field.value (only the `value` attribute) to a JSON string."""
+        return json.dumps(self.to_dict_only_value())
+
+    @classmethod
+    def from_dict_only_value(cls, json_dict: dict[str, Any]) -> Any:
+        """Convert JSON string to a object instance."""
+        obj = cls()
+        for name, data in obj.__dict__.items():
+            if callable(data):
+                continue
+            value = json_dict.get(name)
+            if value is not None:
+                group = data.group
+                if group == "date":
+                    value = parse(value)
+                elif group == "id":
+                    value = ObjectId(value)
+            obj.__dict__[name].value = value
+        return obj
+
+    @classmethod
+    def from_json_only_value(cls, json_str: str) -> Any:
+        """Convert JSON string to a object instance."""
+        json_dict = json.loads(json_str)
+        return cls.from_dict_only_value(json_dict)
+
+    def refrash_fields(self, only_value_dict: dict[str, Any]) -> None:
+        """Partial or complete update a `value` of fields."""
+        for name, data in self.__dict__.items():
+            if callable(data):
+                continue
+            value = only_value_dict.get(name)
+            if value is not None:
+                group = data.group
+                if group == "date":
+                    value = parse(value)
+                elif group == "id":
+                    value = ObjectId(value)
+            self.__dict__[name].value = value

{ramifice-0.3.19.dist-info → ramifice-0.3.21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ramifice
-Version: 0.3.19
+Version: 0.3.21
 Summary: ORM-like API MongoDB for Python language.
 Project-URL: Homepage, https://github.com/kebasyaty/ramifice
 Project-URL: Documentation, https://kebasyaty.github.io/ramifice/

{ramifice-0.3.19.dist-info → ramifice-0.3.21.dist-info}/RECORD

@@ -1,13 +1,14 @@
 ramifice/__init__.py,sha256=ISlaL2BprlJLE_N1fvtAqGrB3Dhniy9IZGoyWEYZhRU,678
 ramifice/add_valid.py,sha256=kvpMg7snL9tor0A23XRdgwiXazRwHfb8baoJUNjM_4Y,327
-ramifice/decorators.py,sha256=rOM8b_5FHQ02rdxuRL-LUd5oV_MB-RDGXVfdjMUWuGY,6143
+ramifice/decorators.py,sha256=X4UnHrbuMObv10dooNip3u9ihfdNvFqeMcfLNuhLlbg,6466
 ramifice/errors.py,sha256=iuhq7fzpUmsOyeXeg2fJjta8yAuqlXLKsZVMpfUhtHE,1901
 ramifice/fixtures.py,sha256=NtxOnZslYJb4yvRpZbs3ckugmTwHQFS_9iCt2zddOC0,3102
 ramifice/hooks.py,sha256=Ri-ISfMT-IHaLO2eAqg8CODCTs3HRTxSylqspUKnVf4,873
 ramifice/indexing.py,sha256=wQpX2qei5Zc7iIq5yIV93Skp8Aa8ZD0vybnEk7cRuXs,271
 ramifice/migration.py,sha256=t_Rm1OUQYrlaPQQd1uS5S7EYMvSuKUcWzi7P4JMkrOw,11114
 ramifice/mixins.py,sha256=gKLmWQ-QrGO3K5_k-h1tDa08lkCql_dte2Jy05q1wsM,1125
-ramifice/model.py,sha256=FnBEsKJhYHL3HZTGRC1_UaLlBh7BJS_O8qCRYCFavhg,7365
+ramifice/model.py,sha256=xhLKosxnT3HkPr6j_BSkB7pvG2WNY_7uylcHo3Oq0vM,6521
+ramifice/pseudo_model.py,sha256=AdETZEvffFvHogtL0NYzp1rqLaI5lq3XcVX1n5v62bw,6816
 ramifice/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ramifice/store.py,sha256=MpDEPvUvbs11FXjakNtHPm9MekIv5p1U3as2Y80lTyc,1860
 ramifice/translations.py,sha256=GNGE0ULAA0aOY5pTxUd3MQW-nVaKvp6BeXWEcsR0s0o,4048
@@ -38,10 +39,10 @@ ramifice/fields/color_field.py,sha256=sjVSoJU6TIZ66wzPx0WRl5zQsx-kINMMuxa_pSUpW6
 ramifice/fields/date_field.py,sha256=Vlaxgp3WeDNMwbnQcTGu8kyQ7gc7M-7sFBPfzu-4MVw,5205
 ramifice/fields/date_time_field.py,sha256=VpLeYJHs0df45fz4gnprtn7aipVFKGY4n02eRep7in0,5240
 ramifice/fields/email_field.py,sha256=wOM07nQ5fOSOTydQhg3b4dV_95F1bd97peQ_XAnV0MY,3720
-ramifice/fields/file_field.py,sha256=Ofui6MFme78v_U_pWu8chpN3FnCW5cKQmnqmJOCi2VE,7922
+ramifice/fields/file_field.py,sha256=NMM9k-kVes7VarxvTQmsl2f2nvRKp-upjPHMDjNIrwY,7892
 ramifice/fields/float_field.py,sha256=4l7gzg46qQ7ZbXS6Z8GUhiUBR26rXChvO_uFx-lbUds,4555
 ramifice/fields/id_field.py,sha256=5wlY2j051TB2GPsw0iQkFiQBV_Y_o1W_QnCtBlaDuYQ,4126
-ramifice/fields/image_field.py,sha256=flh08BZnluez-XvL-ucIS61Km_oZO8HCA5105hpHfTE,12285
+ramifice/fields/image_field.py,sha256=u4YJ3vFtGj5uhVLjgrvV9gNLwLXT4jfVPUN2mlPKHfg,12269
 ramifice/fields/integer_field.py,sha256=Gnm5IBSvWtCLGbg5pOSAdKa5xLzqXgiigVbzw8zcjas,4531
 ramifice/fields/ip_field.py,sha256=D7xR3A-O049TQ_pEEKVTLsKF5cdr5O7ULyz4Pj3-cwQ,3601
 ramifice/fields/password_field.py,sha256=5BlZZ4mXM0CAYDHguwsK8KFnvkOOmr8R0yowHByNVD4,3451
@@ -75,7 +76,7 @@ ramifice/paladins/groups/num_group.py,sha256=Jvb-lwHxapQybbLerC4t-_yO8N7Coo1fIlZ
 ramifice/paladins/groups/pass_group.py,sha256=SEKpR2voNQtmywugDXJKY4XqPTL91CrJ87h0QNMqQqs,1952
 ramifice/paladins/groups/slug_group.py,sha256=_IRil2PwpY7cH7WaExNksKz61kQjvc27blrEufgUB30,2323
 ramifice/paladins/groups/text_group.py,sha256=nYZGwAIsJD-tX8RBtFlWvngO9RU4V0CnREUhxvV2UDo,3493
-ramifice-0.3.19.dist-info/METADATA,sha256=uaJt29S3kOMiBjlopixQuCRIu-O8MvdAeUzQDwJHr2I,18904
-ramifice-0.3.19.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ramifice-0.3.19.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
-ramifice-0.3.19.dist-info/RECORD,,
+ramifice-0.3.21.dist-info/METADATA,sha256=4pWgH5EVC0dvdG2SGf4smhNUkvdXzbOEymF3YcYfvzQ,18904
+ramifice-0.3.21.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ramifice-0.3.21.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
+ramifice-0.3.21.dist-info/RECORD,,