ramifice 0.3.20__py3-none-any.whl → 0.3.22__py3-none-any.whl

ramifice/__init__.py

@@ -1,10 +1,10 @@
-# Copyright 2018-present MongoDB, Inc.
+# Copyright 2022-present MongoDB, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+# https://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,

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,
@@ -67,7 +71,7 @@ def model(
         }
         attrs["META"] = {
             **metadata,
-            **caching(cls, service_name),
+            **caching(cls, service_name, is_migrate_model),
         }
 
         if is_migrate_model:
@@ -87,7 +91,7 @@ def model(
             return type(
                 cls.__name__,
                 (
-                    Model,
+                    PseudoModel,
                     ValidationMixin,
                     CheckMixin,
                     AddValidMixin,
@@ -98,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__
@@ -118,15 +122,14 @@ def caching(cls: Any, service_name: str) -> dict[str, Any]:
     # Count all fields.
     count_all_fields = 0
     # Count fields for migrating.
-    count_fields_for_migrating = 0
+    count_fields_no_ignored = 0
 
     raw_model = cls()
     raw_model.fields()
-    default_fields: dict[str, Any] = {
-        "_id": IDField(),
-        "created_at": DateTimeField(),
-        "updated_at": DateTimeField(),
-    }
+    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):
@@ -141,17 +144,25 @@ 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_no_ignored += 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.
                 if "Dyn" in f_type.field_type:
+                    if not is_migrate_model:
+                        msg = (
+                            f"Model: `{cls.__module__}.{model_name}` > "
+                            + f"Field: `{f_name}` => "
+                            + "Dynamic field only for a migrated Model."
+                        )
+                        raise PanicError(msg)
                     data_dynamic_fields[f_name] = None
 
     metadata["field_name_and_type"] = field_name_and_type
     metadata["field_attrs"] = field_attrs
     metadata["data_dynamic_fields"] = data_dynamic_fields
     metadata["count_all_fields"] = count_all_fields
-    metadata["count_fields_for_migrating"] = count_fields_for_migrating
+    metadata["count_fields_no_ignored"] = count_fields_no_ignored
 
     return metadata

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] = {}
 
@@ -46,29 +44,6 @@ class Model(metaclass=ABCMeta):
         )
         self.fields()
         self.inject()
-        if not self.__class__.META["is_migrate_model"]:
-            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.
-        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:

ramifice/paladins/check.py

@@ -45,11 +45,12 @@ class CheckMixin(
         It is also used to verify Models that do not migrate to the database.
         """
         cls_model = self.__class__
-        if not cls_model.META["is_migrate_model"] and is_save:  # type: ignore[attr-defined]
+        is_migrate_model: bool = cls_model.META["is_migrate_model"]  # type: ignore[attr-defined]
+        if not is_migrate_model and is_save:
             msg = (
                 f"Model: `{self.full_model_name()}` > "  # type: ignore[attr-defined]
                 + "Method: `check` => "
-                + "For a non-migrating Model, the `is_save` parameter cannot be equal to `True`!"
+                + "For a non -migrating Model, the `is_save` parameter must be equal to` False` !"
             )
             raise PanicError(msg)
         # Get the document ID.
@@ -78,6 +79,7 @@ class CheckMixin(
             "collection": collection,
             "field_data": None,
             "full_model_name": cls_model.META["full_model_name"],  # type: ignore[attr-defined]
+            "is_migrate_model": is_migrate_model,
         }
         #
         # Run checking fields.

ramifice/paladins/groups/bool_group.py

@@ -23,7 +23,7 @@ class BoolGroupMixin:
         value = field.value
 
         if not isinstance(value, (bool, type(None))):
-            panic_type_error(params["full_model_name"], "bool | None", params)
+            panic_type_error("bool | None", params)
 
         if not params["is_update"] and value is None:
             value = field.default

ramifice/paladins/groups/choice_group.py

@@ -32,14 +32,14 @@ class ChoiceGroupMixin:
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                accumulate_error(params["full_model_name"], err_msg, params)
+                accumulate_error(err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
         # Does the field value match the possible options in choices.
         if not field.has_value():
             err_msg = translations._("Your choice does not match the options offered !")
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         # Insert result.
         if params["is_save"]:
             params["result_map"][field.name] = value

ramifice/paladins/groups/date_group.py

@@ -27,12 +27,12 @@ class DateGroupMixin:
         value = field.value or field.default or None
 
         if not isinstance(value, (datetime, type(None))):
-            panic_type_error(params["full_model_name"], "datetime | None", params)
+            panic_type_error("datetime | None", params)
 
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                accumulate_error(params["full_model_name"], err_msg, params)
+                accumulate_error(err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
@@ -70,7 +70,7 @@ class DateGroupMixin:
                 "The date %s must not be greater than max=%s !" % value_str,
                 max_date_str,
             )
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         # Validation the `min_date` field attribute.
         min_date = field.min_date
         if min_date is not None and value < min_date:
@@ -103,7 +103,7 @@ class DateGroupMixin:
             err_msg = translations._(
                 "The date %s must not be less than min=%s !" % value_str, min_date_str
             )
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         # Insert result.
         if params["is_save"]:
             params["result_map"][field.name] = value

ramifice/paladins/groups/file_group.py

@@ -22,7 +22,7 @@ class FileGroupMixin:
         value = field.value or None
 
         if not isinstance(value, (dict, type(None))):
-            panic_type_error(params["full_model_name"], "dict | None", params)
+            panic_type_error("dict | None", params)
 
         if not params["is_update"]:
             if value is None:
@@ -36,7 +36,7 @@ class FileGroupMixin:
                 if value is None:
                     if field.required:
                         err_msg = translations._("Required field !")
-                        accumulate_error(params["full_model_name"], err_msg, params)
+                        accumulate_error(err_msg, params)
                     if params["is_save"]:
                         params["result_map"][field.name] = None
                     return
@@ -57,14 +57,14 @@ class FileGroupMixin:
                             params["result_map"][field.name] = None
                     else:
                         err_msg = translations._("Required field !")
-                        accumulate_error(params["full_model_name"], err_msg, params)
+                        accumulate_error(err_msg, params)
                     return
             # Accumulate an error if the file size exceeds the maximum value.
             if value["size"] > field.max_size:
                 err_msg = translations._(
                     "File size exceeds the maximum value %s !" % to_human_size(field.max_size)
                 )
-                accumulate_error(params["full_model_name"], err_msg, params)
+                accumulate_error(err_msg, params)
                 return
         # Insert result.
         if params["is_save"] and (value["is_new_file"] or value["save_as_is"]):

ramifice/paladins/groups/id_group.py

@@ -23,22 +23,22 @@ class IDGroupMixin:
         """Checking id fields."""
         field = params["field_data"]
         # Get current value.
-        value = field.value or None
+        value = field.value
 
         if not isinstance(value, (ObjectId, type(None))):
-            panic_type_error(params["full_model_name"], "ObjectId | None", params)
+            panic_type_error("ObjectId | None", params)
 
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                accumulate_error(params["full_model_name"], err_msg, params)
+                accumulate_error(err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
         # Validation of the MongoDB identifier in a string form.
         if not ObjectId.is_valid(value):
             err_msg = translations._("Invalid document ID !")
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         # Insert result.
         if params["is_save"]:
             params["result_map"][field.name] = value

ramifice/paladins/groups/img_group.py

@@ -24,7 +24,7 @@ class ImgGroupMixin:
         value = field.value or None
 
         if not isinstance(value, (dict, type(None))):
-            panic_type_error(params["full_model_name"], "dict | None", params)
+            panic_type_error("dict | None", params)
 
         if not params["is_update"]:
             if value is None:
@@ -38,7 +38,7 @@ class ImgGroupMixin:
                 if value is None:
                     if field.required:
                         err_msg = translations._("Required field !")
-                        accumulate_error(params["full_model_name"], err_msg, params)
+                        accumulate_error(err_msg, params)
                     if params["is_save"]:
                         params["result_map"][field.name] = None
                     return
@@ -59,14 +59,14 @@ class ImgGroupMixin:
                             params["result_map"][field.name] = None
                     else:
                         err_msg = translations._("Required field !")
-                        accumulate_error(params["full_model_name"], err_msg, params)
+                        accumulate_error(err_msg, params)
                     return
             # Accumulate an error if the file size exceeds the maximum value.
             if value["size"] > field.max_size:
                 err_msg = translations._(
                     "Image size exceeds the maximum value %s !" % to_human_size(field.max_size)
                 )
-                accumulate_error(params["full_model_name"], err_msg, params)
+                accumulate_error(err_msg, params)
                 return
             # Create thumbnails.
             if value["is_new_img"]:

ramifice/paladins/groups/num_group.py

@@ -27,15 +27,15 @@ class NumGroupMixin:
 
         if "Float" in field.field_type:
             if not isinstance(value, (float, type(None))):
-                panic_type_error(params["full_model_name"], "float | None", params)
+                panic_type_error("float | None", params)
         else:
             if not isinstance(value, (int, type(None))):
-                panic_type_error(params["full_model_name"], "int | None", params)
+                panic_type_error("int | None", params)
 
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                accumulate_error(params["full_model_name"], err_msg, params)
+                accumulate_error(err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
@@ -45,22 +45,18 @@ class NumGroupMixin:
             err_msg = translations._(
                 "The value %d must not be greater than max=%d !" % value, max_number
             )
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         # Validation the `min_number` field attribute.
         min_number = field.min_number
         if min_number is not None and value < min_number:
             err_msg = translations._(
                 "The value %d must not be less than min=%d !" % value, min_number
             )
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         # Validation the `unique` field attribute.
-        if field.unique and not await check_uniqueness(
-            self.__class__.META["is_migrate_model"],  # type: ignore[attr-defined]
-            value,
-            params,
-        ):
+        if field.unique and not await check_uniqueness(value, params):
             err_msg = translations._("Is not unique !")
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         # Insert result.
         if params["is_save"]:
             params["result_map"][field.name] = value

ramifice/paladins/groups/pass_group.py

@@ -28,24 +28,24 @@ class PassGroupMixin:
         value = field.value or None
 
         if not isinstance(value, (str, type(None))):
-            panic_type_error(params["full_model_name"], "str | None", params)
+            panic_type_error("str | None", params)
 
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                accumulate_error(params["full_model_name"], err_msg, params)
+                accumulate_error(err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
         # Validation Passwor.
         if not field.is_valid(value):
             err_msg = translations._("Invalid Password !")
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
             chars = "a-z A-Z 0-9 - . _ ! \" ` ' # % & , : ; < > = @ { } ~ $ ( ) * + / \\ ? [ ] ^ |"
             err_msg = translations._("Valid characters: %s" % chars)
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
             err_msg = translations._("Number of characters: from 8 to 256")
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         # Insert result.
         if params["is_save"]:
             ph = PasswordHasher()

ramifice/paladins/groups/slug_group.py

@@ -51,11 +51,7 @@ class SlugGroupMixin:
             # Convert to slug.
             value = slugify("-".join(raw_str_list))
             # Validation of uniqueness of the value.
-            if not await check_uniqueness(
-                self.__class__.META["is_migrate_model"],  # type: ignore[attr-defined]
-                value,
-                params,
-            ):
+            if not await check_uniqueness(value, params):
                 err_msg = (
                     f"Model: `{params['full_model_name']}` > "
                     + f"Field: `{field.name}` > "

ramifice/paladins/groups/text_group.py

@@ -28,12 +28,12 @@ class TextGroupMixin:
         value = field.value or field.default or None
 
         if not isinstance(value, (str, type(None))):
-            panic_type_error(params["full_model_name"], "str | None", params)
+            panic_type_error("str | None", params)
 
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                accumulate_error(params["full_model_name"], err_msg, params)
+                accumulate_error(err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
@@ -41,15 +41,11 @@ class TextGroupMixin:
         maxlength: int | None = field.__dict__.get("maxlength")
         if maxlength is not None and len(value) > maxlength:
             err_msg = translations._("The length of the string exceeds maxlength=%d !" % maxlength)
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         # Validation the `unique` field attribute.
-        if field.unique and not await check_uniqueness(
-            self.__class__.META["is_migrate_model"],  # type: ignore[attr-defined]
-            value,
-            params,
-        ):
+        if field.unique and not await check_uniqueness(value, params):
             err_msg = translations._("Is not unique !")
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         # Validation Email, Url, IP, Color, Phone.
         field_type = field.field_type
         if "Email" in field_type:
@@ -62,19 +58,19 @@ class TextGroupMixin:
                 params["field_data"].value = value
             except EmailNotValidError:
                 err_msg = translations._("Invalid Email address !")
-                accumulate_error(params["full_model_name"], err_msg, params)
+                accumulate_error(err_msg, params)
         elif "URL" in field_type and not field.is_valid(value):
             err_msg = translations._("Invalid URL address !")
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         elif "IP" in field_type and not field.is_valid(value):
             err_msg = translations._("Invalid IP address !")
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         elif "Color" in field_type and not field.is_valid(value):
             err_msg = translations._("Invalid Color code !")
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         elif "Phone" in field_type and not field.is_valid(value):
             err_msg = translations._("Invalid Phone number !")
-            accumulate_error(params["full_model_name"], err_msg, params)
+            accumulate_error(err_msg, params)
         # Insert result.
         if params["is_save"]:
             params["result_map"][field.name] = value

ramifice/paladins/tools.py

@@ -2,8 +2,6 @@
 
 from typing import Any
 
-from termcolor import colored
-
 from ..errors import PanicError
 
 
@@ -21,17 +19,17 @@ def refresh_from_mongo_doc(inst_model: Any, mongo_doc: dict[str, Any]) -> None:
         field.value = data if field.group != "pass" else None
 
 
-def panic_type_error(model_name: str, value_type: str, params: dict[str, Any]) -> None:
+def panic_type_error(value_type: str, params: dict[str, Any]) -> None:
     """Unacceptable type of value."""
     msg = (
-        f"Model: `{model_name}` > "
+        f"Model: `{params['full_model_name']}` > "
         + f"Field: `{params['field_data'].name}` > "
         + f"Parameter: `value` => Must be `{value_type}` type!"
     )
     raise PanicError(msg)
 
 
-def accumulate_error(model_name: str, err_msg: str, params: dict[str, Any]) -> None:
+def accumulate_error(err_msg: str, params: dict[str, Any]) -> None:
     """For accumulating errors to ModelName.field_name.errors ."""
     if not params["field_data"].hide:
         params["field_data"].errors.append(err_msg)
@@ -39,7 +37,7 @@ def accumulate_error(model_name: str, err_msg: str, params: dict[str, Any]) -> N
             params["is_error_symptom"] = True
     else:
         msg = (
-            f">>hidden field<< -> Model: `{model_name}` > "
+            f">>hidden field<< -> Model: `{params['full_model_name']}` > "
             + f"Field: `{params['field_data'].name}`"
             + f" => {err_msg}"
         )
@@ -47,12 +45,11 @@ def accumulate_error(model_name: str, err_msg: str, params: dict[str, Any]) -> N
 
 
 async def check_uniqueness(
-    is_migrate_model: bool,
     value: str | int | float,
     params: dict[str, Any],
 ) -> bool:
     """Check the uniqueness of the value in the collection."""
-    if not is_migrate_model:
+    if not params["is_migrate_model"]:
         return True
     q_filter = {
         "$and": [

ramifice/pseudo_model.py

@@ -0,0 +1,189 @@
+"""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 .errors import PanicError
+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) and 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 callable(f_type):
+                continue
+            value = f_type.value
+            if value is not None:
+                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"]
+            for f_name, f_type in self.__dict__.items():
+                if callable(f_type):
+                    continue
+                f_type.id = field_attrs[f_name]["id"]
+                f_type.name = field_attrs[f_name]["name"]
+                if "Dyn" in f_type.field_type:
+                    msg = (
+                        f"Model: `{metadata['full_model_name']}` > "
+                        + f"Field: `{f_name}` => "
+                        + "Dynamic field only for a migrated Model."
+                    )
+                    raise PanicError(msg)
+
+    # 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.20.dist-info → ramifice-0.3.22.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ramifice
-Version: 0.3.20
+Version: 0.3.22
 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.20.dist-info → ramifice-0.3.22.dist-info}/RECORD

@@ -1,13 +1,14 @@
-ramifice/__init__.py,sha256=ISlaL2BprlJLE_N1fvtAqGrB3Dhniy9IZGoyWEYZhRU,678
+ramifice/__init__.py,sha256=jOSfXKsCkSk7y_mkKMF32gKotkD8V4RmQYvPh4smVVE,679
 ramifice/add_valid.py,sha256=kvpMg7snL9tor0A23XRdgwiXazRwHfb8baoJUNjM_4Y,327
-ramifice/decorators.py,sha256=txbTYnKw5AtRZb7IshOzEHuoy8MAPB8wBcCTbk-6CcE,6181
+ramifice/decorators.py,sha256=0_KKq2u7mX12iqWp4-vfGBR4cKqfkey7gL5P9C7bBNQ,6811
 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=hKA_BrGBWcn-mYB9dHIJoSJYEteO6SdJdgwgjdaV7mc,7632
+ramifice/model.py,sha256=xhLKosxnT3HkPr6j_BSkB7pvG2WNY_7uylcHo3Oq0vM,6521
+ramifice/pseudo_model.py,sha256=D2eW6gYDKxSLOXyyeIOyP2k84vsaISGXytBHoiLwRdU,6981
 ramifice/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ramifice/store.py,sha256=MpDEPvUvbs11FXjakNtHPm9MekIv5p1U3as2Y80lTyc,1860
 ramifice/translations.py,sha256=GNGE0ULAA0aOY5pTxUd3MQW-nVaKvp6BeXWEcsR0s0o,4048
@@ -57,25 +58,25 @@ ramifice/fields/general/file_group.py,sha256=n45KfPzFI_l5hXoKkPDG0Q-0mdC2obExV-3
 ramifice/fields/general/number_group.py,sha256=AqlCY-t6JHZ2QVBe7mk5nPt6z8M4VJ_RARRlSBoIxms,715
 ramifice/fields/general/text_group.py,sha256=gP6mUGXr-LTI1UegqgEMQ-5vtUJuJs0wDYKVkknW_5E,873
 ramifice/paladins/__init__.py,sha256=PIP3AXI2KBRXNcLJUF0d7ygJ7VLOAxlhb4HRKQ9MGYY,516
-ramifice/paladins/check.py,sha256=kseDMCMliRsYsldcRFo5itqroQQtHtcA_oNEd6wvfgU,6835
+ramifice/paladins/check.py,sha256=W1eJRWxcaoKIFawJOF8rshy2-SKSPPuKXms9rxN7y64,6938
 ramifice/paladins/delete.py,sha256=RfCyew5tbBCT8u1c8nMgC2vIQlIWzu9Tvh6TuO7VBmM,3584
 ramifice/paladins/password.py,sha256=O1OvmeKuXbwtBX1sPTRVsoWYHPQn9isOe1rju6A3wbE,3264
 ramifice/paladins/refrash.py,sha256=DfBFGjPB6yYjga57GuCiWFBNHalmDO3EfMjkhgoWnVI,1207
 ramifice/paladins/save.py,sha256=7KxocEisEVYWkZtBpHZyP6drGMyOVvF2vaymm4HNHmg,4276
-ramifice/paladins/tools.py,sha256=LlrY3rtKmBBGXOd6Lf8w84jMULA5C6nwzpHIoN16ibc,2094
+ramifice/paladins/tools.py,sha256=9RDjyRJ5j8E5jNxVYHx-L87hCxqpu9WadycGSz7LZY0,2038
 ramifice/paladins/validation.py,sha256=7lFDWjokUwMwVxWAVgd_GlWGpF4mukxIVpxvpdyA19A,1850
 ramifice/paladins/groups/__init__.py,sha256=hpqmWLsYAMvZHAbmMXluQSqLhkHOSTUAgLHyTM1LTYI,472
-ramifice/paladins/groups/bool_group.py,sha256=fpxCySJ5JL7w1dLFPX1025zEU8CRsWSyQyXb3Hr3Z2s,819
-ramifice/paladins/groups/choice_group.py,sha256=OJeZjpnqKnSF1_bechtNepCCPjmp54x1T0c28DAa11c,1777
-ramifice/paladins/groups/date_group.py,sha256=-IS9pAHXdWK7tO9KQ2UyG1uf7TA43DKYCOCtOM2_tZ0,3844
-ramifice/paladins/groups/file_group.py,sha256=9GzRY3sV8PYJh23ZPtMQYH5RDi4pibN-kIaSui4B5zY,3033
-ramifice/paladins/groups/id_group.py,sha256=tK3OL1pr-V8PHPyS7vmjmJi_sRU669EvkY_Fc4sRHzg,1352
-ramifice/paladins/groups/img_group.py,sha256=j184UyyYZ8gNuAivkP1A57o9JlrGS_0sht6QKiblbDs,5643
-ramifice/paladins/groups/num_group.py,sha256=Jvb-lwHxapQybbLerC4t-_yO8N7Coo1fIlZ9eAGHcGs,2508
-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.20.dist-info/METADATA,sha256=ZpWGFOazkmaGbW9rMKja65dApz_DHCrA2_PBCynIqzw,18904
-ramifice-0.3.20.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ramifice-0.3.20.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
-ramifice-0.3.20.dist-info/RECORD,,
+ramifice/paladins/groups/bool_group.py,sha256=oJc9mw9KGrnK_Pj7uXixYYQAJphcXLr_xSQv3PMUlcU,792
+ramifice/paladins/groups/choice_group.py,sha256=ZV6t6qgh__BzWGRUSx2RdXH_K9BtBOo0eAZ3Yon0tfY,1723
+ramifice/paladins/groups/date_group.py,sha256=bVhzmwsN3sKbmzvm4jI0i_Mzjwn8gdx4kxCUWq-0Yqs,3736
+ramifice/paladins/groups/file_group.py,sha256=AtGu2sQ9A64dPo2Kpt4milp5HWPdULdPdQycwFW8ZgE,2925
+ramifice/paladins/groups/id_group.py,sha256=zAlJrDTOdRY9e7eFYSXPjjsD05A4EsgSE6ibN3KKOMU,1263
+ramifice/paladins/groups/img_group.py,sha256=o0bMI1WIA6t1QrhLaR2bBAAJUKCgHg7SiIFQsGTr2Cg,5535
+ramifice/paladins/groups/num_group.py,sha256=lpyFG9a6WGOzu9f_9jwYVWZNFHxG0B0AVWvvbv_2mV0,2224
+ramifice/paladins/groups/pass_group.py,sha256=7EXqssszWQaDldJgvyNFFPxj1KSdCN89xFXrfYTTZTQ,1817
+ramifice/paladins/groups/slug_group.py,sha256=SVYxHcSSgCA51C18LVGxMQYuUw-6ryQlTi6B9T8Dzsw,2185
+ramifice/paladins/groups/text_group.py,sha256=N_uHsL-JJnNp2JIzNxmNyK9hRupdZGTx9Cbe6muKSmI,3128
+ramifice-0.3.22.dist-info/METADATA,sha256=YpuZPDu3wd9tubh_VDZdCSVQbl_aEaq1kZPjYqA_isU,18904
+ramifice-0.3.22.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ramifice-0.3.22.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
+ramifice-0.3.22.dist-info/RECORD,,