ramifice 0.5.12__py3-none-any.whl → 0.6.1__py3-none-any.whl

ramifice/fields/file_field.py

@@ -1,12 +1,13 @@
 """Field of Model for upload file."""
 
 import os
-import shutil
 import uuid
 from base64 import b64decode
 from datetime import date
 from pathlib import Path
-from typing import Any
+
+import aiofiles
+from aioshutil import copyfile
 
 from ramifice.fields.general.field import Field
 from ramifice.fields.general.file_group import FileGroup
@@ -91,7 +92,7 @@ class FileField(Field, FileGroup, JsonMixin):
 
         self.value: dict[str, str | int | bool] | None = None
 
-    def from_base64(
+    async def from_base64(
         self,
         base64_str: str | None = None,
         filename: str | None = None,
@@ -125,14 +126,14 @@ class FileField(Field, FileGroup, JsonMixin):
             # 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.
-            if not os.path.exists(dir_target_path):
-                os.makedirs(dir_target_path)
+            if not await aiofiles.os.path.exists(dir_target_path):
+                await aiofiles.os.makedirs(dir_target_path)
             # Create path to target file.
             f_target_path = f"{dir_target_path}/{f_uuid_name}"
             # Save file in target directory.
-            with open(f_target_path, mode="wb") as open_f:
+            async with aiofiles.open(f_target_path, mode="wb") as open_f:
                 f_content = b64decode(base64_str)
-                open_f.write(f_content)
+                await open_f.write(f_content)
             # Add paths to target file.
             file_info["path"] = f_target_path
             file_info["url"] = f"{self.media_url}/{self.target_dir}/{date_str}/{f_uuid_name}"
@@ -141,12 +142,12 @@ class FileField(Field, FileGroup, JsonMixin):
             # Add file extension.
             file_info["extension"] = extension
             # Add file size (in bytes).
-            file_info["size"] = os.path.getsize(f_target_path)
+            file_info["size"] = await aiofiles.os.path.getsize(f_target_path)
         #
         # to value.
         self.value = file_info
 
-    def from_path(
+    async def from_path(
         self,
         src_path: str | None = None,
         is_delete: bool = False,
@@ -170,12 +171,12 @@ class FileField(Field, FileGroup, JsonMixin):
             # 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.
-            if not os.path.exists(dir_target_path):
-                os.makedirs(dir_target_path)
+            if not await aiofiles.os.path.exists(dir_target_path):
+                await aiofiles.os.makedirs(dir_target_path)
             # Create path to target file.
             f_target_path = f"{dir_target_path}/{f_uuid_name}"
             # Save file in target directory.
-            shutil.copyfile(src_path, f_target_path)
+            await copyfile(src_path, f_target_path)
             # Add paths to target file.
             file_info["path"] = f_target_path
             file_info["url"] = f"{self.media_url}/{self.target_dir}/{date_str}/{f_uuid_name}"
@@ -184,7 +185,7 @@ class FileField(Field, FileGroup, JsonMixin):
             # Add file extension.
             file_info["extension"] = extension
             # Add file size (in bytes).
-            file_info["size"] = os.path.getsize(f_target_path)
+            file_info["size"] = await aiofiles.os.path.getsize(f_target_path)
         #
         # to value.
         self.value = file_info

ramifice/fields/image_field.py

@@ -1,14 +1,13 @@
 """Field of Model for upload image."""
 
 import os
-import shutil
 import uuid
 from base64 import b64decode
 from datetime import date
 from pathlib import Path
-from typing import Any
 
-from PIL import Image
+import aiofiles
+from aioshutil import copyfile
 
 from ramifice.fields.general.field import Field
 from ramifice.fields.general.file_group import FileGroup
@@ -38,8 +37,6 @@ class ImageField(Field, FileGroup, JsonMixin):
         # Available 4 sizes from lg to xs or None.
         # Example: {"lg": 1200, "md": 600, "sm": 300, "xs": 150 }
         thumbnails: dict[str, int] | None = None,
-        # True - high quality and low performance for thumbnails.
-        high_quality: bool = False,
     ):
         if globals.DEBUG:
             if default is not None:
@@ -98,8 +95,6 @@ class ImageField(Field, FileGroup, JsonMixin):
                 raise AssertionError("Parameter `target_dir` - Not а `str` type!")
             if not isinstance(accept, str):
                 raise AssertionError("Parameter `accept` - Not а `str` type!")
-            if not isinstance(high_quality, bool):
-                raise AssertionError("Parameter `high_quality` - Not а `bool` type!")
 
         Field.__init__(
             self,
@@ -127,10 +122,8 @@ class ImageField(Field, FileGroup, JsonMixin):
         # Available 4 sizes from lg to xs or None.
         # Example: {"lg": 1200, "md": 600, "sm": 300, "xs": 150 }
         self.thumbnails = thumbnails
-        # True is high quality and low performance.
-        self.high_quality = high_quality
 
-    def from_base64(
+    async def from_base64(
         self,
         base64_str: str | None = None,
         filename: str | None = None,
@@ -170,21 +163,15 @@ class ImageField(Field, FileGroup, JsonMixin):
             # Create path to main image.
             main_img_path = f"{imgs_dir_path}/{new_original_name}"
             # Create target directory if it does not exist.
-            if not os.path.exists(imgs_dir_path):
-                os.makedirs(imgs_dir_path)
+            if not await aiofiles.os.path.exists(imgs_dir_path):
+                await aiofiles.os.makedirs(imgs_dir_path)
             # Save main image in target directory.
-            with open(main_img_path, mode="wb") as open_f:
+            async with aiofiles.open(main_img_path, mode="wb") as open_f:
                 f_content = b64decode(base64_str)
-                open_f.write(f_content)
+                await open_f.write(f_content)
             # Add paths for main image.
             img_info["path"] = main_img_path
             img_info["url"] = f"{imgs_dir_url}/{new_original_name}"
-            # Add width and height.
-            if self.__dict__.get("add_width_height", False):
-                with Image.open(main_img_path) as img:
-                    width, height = img.size
-                    img_info["width"] = width
-                    img_info["height"] = height
             # Add original image name.
             img_info["name"] = filename
             # Add image extension.
@@ -199,12 +186,12 @@ class ImageField(Field, FileGroup, JsonMixin):
             # Add url path to target directory with images.
             img_info["imgs_dir_url"] = imgs_dir_url
             # Add size of main image (in bytes).
-            img_info["size"] = os.path.getsize(main_img_path)
+            img_info["size"] = await aiofiles.os.path.getsize(main_img_path)
         #
         # to value.
         self.value = img_info
 
-    def from_path(
+    async def from_path(
         self,
         src_path: str | None = None,
         is_delete: bool = False,
@@ -234,19 +221,13 @@ class ImageField(Field, FileGroup, JsonMixin):
             # Create path to main image.
             main_img_path = f"{imgs_dir_path}/{new_original_name}"
             # Create target directory if it does not exist.
-            if not os.path.exists(imgs_dir_path):
-                os.makedirs(imgs_dir_path)
+            if not await aiofiles.os.path.exists(imgs_dir_path):
+                await aiofiles.os.makedirs(imgs_dir_path)
             # Save main image in target directory.
-            shutil.copyfile(src_path, main_img_path)
+            await copyfile(src_path, main_img_path)
             # Add paths for main image.
             img_info["path"] = main_img_path
             img_info["url"] = f"{imgs_dir_url}/{new_original_name}"
-            # Add width and height.
-            if self.__dict__.get("add_width_height", False):
-                with Image.open(main_img_path) as img:
-                    width, height = img.size
-                    img_info["width"] = width
-                    img_info["height"] = height
             # Add original image name.
             img_info["name"] = os.path.basename(src_path)
             # Add image extension.
@@ -261,7 +242,7 @@ class ImageField(Field, FileGroup, JsonMixin):
             # Add url path to target directory with images.
             img_info["imgs_dir_url"] = imgs_dir_url
             # Add size of main image (in bytes).
-            img_info["size"] = os.path.getsize(main_img_path)
+            img_info["size"] = await aiofiles.os.path.getsize(main_img_path)
         #
         # to value.
         self.value = img_info

ramifice/models/decorator.py

@@ -7,8 +7,7 @@ from typing import Any
 from ramifice.commons import QCommonsMixin
 from ramifice.fields import DateTimeField, IDField
 from ramifice.models.model import Model
-from ramifice.models.pseudo import PseudoModel
-from ramifice.paladins import CheckMixin, QPaladinsMixin, ValidationMixin
+from ramifice.paladins import QPaladinsMixin
 from ramifice.utils.errors import DoesNotMatchRegexError, PanicError
 from ramifice.utils.globals import REGEX
 from ramifice.utils.mixins.add_valid import AddValidMixin
@@ -20,7 +19,6 @@ def model(
     service_name: str,
     fixture_name: str | None = None,
     db_query_docs_limit: int = 1000,
-    is_migrate_model: bool = True,
     is_create_doc: bool = True,
     is_update_doc: bool = True,
     is_delete_doc: bool = True,
@@ -32,8 +30,6 @@ def model(
         raise AssertionError("Parameter `fixture_name` - Must be `str | None` type!")
     if not isinstance(db_query_docs_limit, int):
         raise AssertionError("Parameter `db_query_docs_limit` - Must be `int` type!")
-    if not isinstance(is_migrate_model, bool):
-        raise AssertionError("Parameter `is_migrate_model` - Must be `bool` type!")
     if not isinstance(is_create_doc, bool):
         raise AssertionError("Parameter `is_create_doc` - Must be `bool` type!")
     if not isinstance(is_update_doc, bool):
@@ -55,53 +51,37 @@ def model(
                 raise PanicError(msg)
 
         attrs = {key: val for key, val in cls.__dict__.items()}
-        if is_migrate_model:
-            attrs["__dict__"] = Model.__dict__["__dict__"]
-        else:
-            attrs["__dict__"] = PseudoModel.__dict__["__dict__"]
+        attrs["__dict__"] = Model.__dict__["__dict__"]
         metadata = {
             "service_name": service_name,
             "fixture_name": fixture_name,
             "db_query_docs_limit": db_query_docs_limit,
-            "is_migrate_model": is_migrate_model,
-            "is_create_doc": is_create_doc if is_migrate_model else False,
-            "is_update_doc": is_update_doc if is_migrate_model else False,
-            "is_delete_doc": is_delete_doc if is_migrate_model else False,
+            "is_create_doc": is_create_doc,
+            "is_update_doc": is_update_doc,
+            "is_delete_doc": is_delete_doc,
         }
         attrs["META"] = {
             **metadata,
-            **caching(cls, service_name, is_migrate_model),
+            **caching(cls, service_name),
         }
 
-        if is_migrate_model:
-            return type(
-                cls.__name__,
-                (
-                    Model,
-                    QPaladinsMixin,
-                    QCommonsMixin,
-                    AddValidMixin,
-                    IndexMixin,
-                    HooksMixin,
-                ),
-                attrs,
-            )
-        else:
-            return type(
-                cls.__name__,
-                (
-                    PseudoModel,
-                    ValidationMixin,
-                    CheckMixin,
-                    AddValidMixin,
-                ),
-                attrs,
-            )
+        return type(
+            cls.__name__,
+            (
+                Model,
+                QPaladinsMixin,
+                QCommonsMixin,
+                AddValidMixin,
+                IndexMixin,
+                HooksMixin,
+            ),
+            attrs,
+        )
 
     return decorator
 
 
-def caching(cls: Any, service_name: str, is_migrate_model: bool) -> dict[str, Any]:
+def caching(cls: Any, service_name: str) -> dict[str, Any]:
     """Add additional metadata to `Model.META`."""
     metadata: dict[str, Any] = {}
     model_name: str = cls.__name__
@@ -128,11 +108,11 @@ def caching(cls: Any, service_name: str, is_migrate_model: bool) -> dict[str, An
 
     raw_model = cls()
     raw_model.fields()
-    default_fields: dict[str, Any] = {}
-    if is_migrate_model:
-        default_fields["_id"] = IDField()
-        default_fields["created_at"] = DateTimeField()
-        default_fields["updated_at"] = DateTimeField()
+    default_fields: dict[str, Any] = {
+        "_id": IDField(),
+        "created_at": DateTimeField(),
+        "updated_at": DateTimeField(),
+    }
     fields = {**raw_model.__dict__, **default_fields}
     for f_name, f_data in fields.items():
         if not callable(f_data):
@@ -147,19 +127,11 @@ def caching(cls: Any, service_name: str, is_migrate_model: bool) -> dict[str, An
             #
             if not f_data.ignored:
                 # Count fields for migrating.
-                if is_migrate_model:
-                    count_fields_no_ignored += 1
+                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_data.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
                 if f_data.field_type == "TextField" and f_data.multi_language:
                     supported_lang_fields.append(f_name)

ramifice/paladins/check.py

@@ -1,9 +1,9 @@
 """Validation of Model data before saving to the database."""
 
-import os
-import shutil
 from typing import Any
 
+from aiofiles import os
+from aioshutil import rmtree
 from bson.objectid import ObjectId
 from pymongo.asynchronous.collection import AsyncCollection
 
@@ -48,27 +48,15 @@ class CheckMixin(
         It is also used to verify Models that do not migrate to the database.
         """
         cls_model = self.__class__
-        is_migrate_model: bool = cls_model.META["is_migrate_model"]
 
-        if not is_migrate_model and is_save:
-            msg = (
-                f"Model: `{self.full_model_name()}` > "
-                + "Method: `check` => "
-                + "For a non -migrating Model, the `is_save` parameter must be equal to` False` !"
-            )
-            raise PanicError(msg)
-
-        doc_id: ObjectId | None = None
-        is_update: bool = False
-        if is_migrate_model:
-            # Get the document ID.
-            doc_id = self._id.value
-            # Does the document exist in the database?
-            is_update = doc_id is not None
-            # Create an identifier for a new document.
-            if is_save and not is_update:
-                doc_id = ObjectId()
-                self._id.value = doc_id
+        # Get the document ID.
+        doc_id: ObjectId | None = self._id.value
+        # Does the document exist in the database?
+        is_update: bool = doc_id is not None
+        # Create an identifier for a new document.
+        if is_save and not is_update:
+            doc_id = ObjectId()
+            self._id.value = doc_id
 
         result_map: dict[str, Any] = {}
         # Errors from additional validation of fields.
@@ -86,7 +74,6 @@ class CheckMixin(
             "collection": collection,
             "field_data": None,
             "full_model_name": cls_model.META["full_model_name"],
-            "is_migrate_model": is_migrate_model,
             "is_migration_process": is_migration_process,
             "curr_doc": (
                 await collection.find_one({"_id": doc_id}) if is_save and is_update else None
@@ -116,9 +103,9 @@ class CheckMixin(
                 elif group == "date":
                     self.date_group(params)
                 elif group == "img":
-                    self.img_group(params)
+                    await self.img_group(params)
                 elif group == "file":
-                    self.file_group(params)
+                    await self.file_group(params)
                 elif group == "choice":
                     self.choice_group(params)
                 elif group == "bool":
@@ -146,7 +133,7 @@ class CheckMixin(
                         file_data = result_map.get(field_name)
                         if file_data is not None:
                             if file_data["is_new_file"]:
-                                os.remove(file_data["path"])
+                                await os.remove(file_data["path"])
                             field_data.value = None
                         if curr_doc is not None:
                             field_data.value = curr_doc[field_name]
@@ -154,7 +141,7 @@ class CheckMixin(
                         img_data = result_map.get(field_name)
                         if img_data is not None:
                             if img_data["is_new_img"]:
-                                shutil.rmtree(img_data["imgs_dir_path"])
+                                await rmtree(img_data["imgs_dir_path"])  # type: ignore[call-arg]
                             field_data.value = None
                         if curr_doc is not None:
                             field_data.value = curr_doc[field_name]

ramifice/paladins/delete.py

@@ -1,9 +1,9 @@
 """Delete document from database."""
 
-import os
-import shutil
 from typing import Any
 
+from aiofiles import os
+from aioshutil import rmtree
 from pymongo.asynchronous.collection import AsyncCollection
 
 from ramifice.utils import globals
@@ -77,12 +77,12 @@ class DeleteMixin:
                 if group == "file":
                     file_data = mongo_doc[field_name]
                     if file_data is not None and len(file_data["path"]) > 0:
-                        os.remove(file_data["path"])
+                        await os.remove(file_data["path"])
                     file_data = None
                 elif group == "img":
                     file_data = mongo_doc[field_name]
                     if file_data is not None and len(file_data["imgs_dir_path"]) > 0:
-                        shutil.rmtree(file_data["imgs_dir_path"])
+                        await rmtree(file_data["imgs_dir_path"])  # type: ignore[call-arg]
                     file_data = None
             field_data.value = None
         # Run hook.

ramifice/paladins/groups/file_group.py

@@ -19,7 +19,7 @@ class FileGroupMixin:
     Supported fields: FileField
     """
 
-    def file_group(self, params: dict[str, Any]) -> None:
+    async def file_group(self, params: dict[str, Any]) -> None:
         """Checking file fields."""
         field = params["field_data"]
         value = field.value or None

ramifice/paladins/groups/img_group.py

@@ -3,6 +3,7 @@
 Supported fields: ImageField
 """
 
+import asyncio
 from typing import Any
 
 from PIL import Image
@@ -18,7 +19,7 @@ class ImgGroupMixin:
     Supported fields: ImageField
     """
 
-    def img_group(self, params: dict[str, Any]) -> None:
+    async def img_group(self, params: dict[str, Any]) -> None:
         """Checking image fields."""
         field = params["field_data"]
         value = field.value or None
@@ -79,37 +80,48 @@ class ImgGroupMixin:
                     # Extension to the upper register and delete the point.
                     ext_upper = value["ext_upper"]
                     # Get image file.
-                    with Image.open(path) as img:
+                    with await asyncio.to_thread(Image.open, path) as img:
                         width, height = img.size
                         value["width"] = width
                         value["height"] = height
-                        resample = (
-                            Image.Resampling.LANCZOS  # High quality and low performance.
-                            if params["field_data"].high_quality
-                            else Image.Resampling.BICUBIC
-                        )
                         for size_name in ["lg", "md", "sm", "xs"]:
                             max_size = thumbnails.get(size_name)
                             if max_size is None:
                                 continue
                             size = max_size, max_size
-                            img.thumbnail(size=size, resample=resample)
+                            img.thumbnail(size=size, resample=Image.Resampling.LANCZOS)
                             if size_name == "lg":
                                 value["path_lg"] = f"{imgs_dir_path}/lg{extension}"
                                 value["url_lg"] = f"{imgs_dir_url}/lg{extension}"
-                                img.save(fp=value["path_lg"], format=ext_upper)
+                                await asyncio.to_thread(
+                                    img.save,
+                                    fp=value["path_lg"],
+                                    format=ext_upper,
+                                )
                             elif size_name == "md":
                                 value["path_md"] = f"{imgs_dir_path}/md{extension}"
                                 value["url_md"] = f"{imgs_dir_url}/md{extension}"
-                                img.save(fp=value["path_md"], format=ext_upper)
+                                await asyncio.to_thread(
+                                    img.save,
+                                    fp=value["path_md"],
+                                    format=ext_upper,
+                                )
                             elif size_name == "sm":
                                 value["path_sm"] = f"{imgs_dir_path}/sm{extension}"
                                 value["url_sm"] = f"{imgs_dir_url}/sm{extension}"
-                                img.save(fp=value["path_sm"], format=ext_upper)
+                                await asyncio.to_thread(
+                                    img.save,
+                                    fp=value["path_sm"],
+                                    format=ext_upper,
+                                )
                             elif size_name == "xs":
                                 value["path_xs"] = f"{imgs_dir_path}/xs{extension}"
                                 value["url_xs"] = f"{imgs_dir_url}/xs{extension}"
-                                img.save(fp=value["path_xs"], format=ext_upper)
+                                await asyncio.to_thread(
+                                    img.save,
+                                    fp=value["path_xs"],
+                                    format=ext_upper,
+                                )
         # Insert result.
         if params["is_save"] and (value["is_new_img"] or value["save_as_is"]):
             value["is_delete"] = False

ramifice/paladins/groups/text_group.py

@@ -5,13 +5,26 @@ Supported fields:
     IPField | EmailField | ColorField
 """
 
+import asyncio
 from typing import Any
 
-from email_validator import EmailNotValidError, validate_email
+from email_validator import (
+    EmailNotValidError,
+    validate_email,
+)
 
-from ramifice.paladins.tools import accumulate_error, check_uniqueness, panic_type_error
+from ramifice.paladins.tools import (
+    accumulate_error,
+    check_uniqueness,
+    panic_type_error,
+)
 from ramifice.utils import translations
-from ramifice.utils.tools import is_color, is_ip, is_phone, is_url
+from ramifice.utils.tools import (
+    is_color,
+    is_ip,
+    is_phone,
+    is_url,
+)
 
 
 class TextGroupMixin:
@@ -60,27 +73,28 @@ class TextGroupMixin:
             err_msg = translations._("Is not unique !")
             accumulate_error(err_msg, params)
         # Validation Email, Url, IP, Color, Phone.
-        if "EmailField" == field_type:
+        if field_type == "EmailField":
             try:
-                emailinfo = validate_email(
+                emailinfo = await asyncio.to_thread(
+                    validate_email,
                     str(value),
-                    check_deliverability=self.__class__.META["is_migrate_model"],
+                    check_deliverability=True,
                 )
                 value = emailinfo.normalized
                 params["field_data"].value = value
             except EmailNotValidError:
                 err_msg = translations._("Invalid Email address !")
                 accumulate_error(err_msg, params)
-        elif "URLField" == field_type and not is_url(value):
+        elif field_type == "URLField" and not is_url(value):
             err_msg = translations._("Invalid URL address !")
             accumulate_error(err_msg, params)
-        elif "IPField" == field_type and not is_ip(value):
+        elif field_type == "IPField" and not is_ip(value):
             err_msg = translations._("Invalid IP address !")
             accumulate_error(err_msg, params)
-        elif "ColorField" == field_type and not is_color(value):
+        elif field_type == "ColorField" and not is_color(value):
             err_msg = translations._("Invalid Color code !")
             accumulate_error(err_msg, params)
-        elif "PhoneField" == field_type and not is_phone(value):
+        elif field_type == "PhoneField" and not is_phone(value):
             err_msg = translations._("Invalid Phone number !")
             accumulate_error(err_msg, params)
         # Insert result.

ramifice/paladins/tools.py

@@ -58,8 +58,6 @@ async def check_uniqueness(
     is_multi_language: bool = False,
 ) -> bool:
     """Check the uniqueness of the value in the collection."""
-    if not params["is_migrate_model"]:
-        return True
     q_filter = None
     if is_multi_language:
         lang_filter = [{f"{field_name}.{lang}": value} for lang in translations.LANGUAGES]

ramifice/utils/migration.py

@@ -31,9 +31,7 @@ class Monitor:
         globals.MONGO_CLIENT = mongo_client
         globals.MONGO_DATABASE = globals.MONGO_CLIENT[globals.DATABASE_NAME]
         # Get Model list.
-        self.model_list: list[Any] = [
-            cls_model for cls_model in Model.__subclasses__() if cls_model.META["is_migrate_model"]
-        ]
+        self.model_list: list[Any] = Model.__subclasses__()
         # Raise the exception if there are no models for migration.
         if len(self.model_list) == 0:
             raise NoModelsForMigrationError()  # type: ignore[no-untyped-call]

ramifice/utils/tools.py

@@ -1,5 +1,6 @@
 """Global collection of auxiliary methods."""
 
+import asyncio
 import ipaddress
 import math
 import os
@@ -49,10 +50,14 @@ def normal_email(email: str | None) -> str | None:
     return normal
 
 
-def is_email(email: str | None) -> bool:
+async def is_email(email: str | None) -> bool:
     """Validate Email address."""
     try:
-        validate_email(str(email), check_deliverability=True)
+        await asyncio.to_thread(
+            validate_email,
+            str(email),
+            check_deliverability=True,
+        )
     except EmailNotValidError:
         return False
     return True

{ramifice-0.5.12.dist-info → ramifice-0.6.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ramifice
-Version: 0.5.12
+Version: 0.6.1
 Summary: ORM-like API MongoDB for Python language.
 Project-URL: Homepage, https://github.com/kebasyaty/ramifice
 Project-URL: Documentation, https://kebasyaty.github.io/ramifice/
@@ -23,6 +23,8 @@ Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Database
 Classifier: Typing :: Typed
 Requires-Python: <4.0,>=3.12
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: aioshutil>=1.5
 Requires-Dist: argon2-cffi>=25.1.0
 Requires-Dist: babel>=2.17.0
 Requires-Dist: email-validator>=2.2.0
@@ -58,6 +60,7 @@ Description-Content-Type: text/markdown
       <a href="https://pepy.tech/projects/ramifice"><img src="https://static.pepy.tech/badge/ramifice" alt="PyPI Downloads"></a>
       <a href="https://github.com/kebasyaty/ramifice/blob/main/LICENSE" alt="GitHub license"><img src="https://img.shields.io/github/license/kebasyaty/ramifice" alt="GitHub license"></a>
       <a href="https://docs.astral.sh/ruff/" alt="Code style: Ruff"><img src="https://img.shields.io/badge/code%20style-Ruff-FDD835.svg" alt="Code style: Ruff"></a>
+      <a href="https://github.com/kebasyaty/ramifice" alt="PyPI implementation"><img src="https://img.shields.io/pypi/implementation/ramifice" alt="PyPI implementation"></a>
       <a href="https://github.com/kebasyaty/ramifice" alt="GitHub repository"><img src="https://img.shields.io/badge/--ecebeb?logo=github&logoColor=000000" alt="GitHub repository"></a>
     </p>
     <p align="center">
@@ -148,16 +151,12 @@ class User:
         # ngettext = translations.ngettext
         self.avatar = ImageField(
             label=gettext("Avatar"),
-            placeholder=gettext("Upload your photo"),
             default="public/media/default/no-photo.png",
             # Directory for images inside media directory.
             target_dir="users/avatars",
             # Available 4 sizes from lg to xs or None.
             # Hint: By default = None
             thumbnails={"lg": 512, "md": 256, "sm": 128, "xs": 64},
-            # True - high quality and low performance for thumbnails.
-            # Hint: By default = False
-            high_quality=True,
             # The maximum size of the original image in bytes.
             # Hint: By default = 2 MB
             max_size=524288,  # 0.5 MB = 512 KB = 524288 Bytes (in binary)
@@ -167,7 +166,6 @@ class User:
         )
         self.username = TextField(
             label=gettext("Username"),
-            placeholder=gettext("Enter your username"),
             maxlength=150,
             required=True,
             unique=True,
@@ -177,11 +175,9 @@ class User:
         )
         self.password = PasswordField(
             label=gettext("Password"),
-            placeholder=gettext("Enter your password"),
         )
         self.сonfirm_password = PasswordField(
             label=gettext("Confirm password"),
-            placeholder=gettext("Repeat your password"),
             # If true, the value of this field is not saved in the database.
             ignored=True,
         )
@@ -342,14 +338,6 @@ See the documentation [here](https://kebasyaty.github.io/ramifice/ "here").
        <td align="left">1000</td>
        <td align="left">limiting query results.</td>
      </tr>
-     <tr>
-       <td align="left">is_migrate_model</td>
-       <td align="left">True</td>
-       <td align="left">
-         Set to <b>False</b> if you do not need to migrate the Model to the database.<br>
-         This can be use to validate a web forms - Search form, Contact form, etc.
-       </td>
-     </tr>
      <tr>
        <td align="left">is_create_doc</td>
        <td align="left">True</td>
@@ -380,7 +368,6 @@ See the documentation [here](https://kebasyaty.github.io/ramifice/ "here").
     service_name="ServiceName",
     fixture_name="FixtureName",
     db_query_docs_limit=1000,
-    is_migrate_model=True,
     is_create_doc = True,
     is_update_doc = True,
     is_delete_doc = True,
@@ -570,7 +557,7 @@ if is_password("12345678"):
     ...
 
 # Validate Email address.
-if is_email("kebasyaty@gmail.com"):
+if await is_email("kebasyaty@gmail.com"):
     ...
 
 # Normalizing email address.

{ramifice-0.5.12.dist-info → ramifice-0.6.1.dist-info}/RECORD

@@ -25,10 +25,10 @@ ramifice/fields/color_field.py,sha256=Syam8MtB--B0HzAT3w3QuWz3pPixSMbh8xGPmbGYLC
 ramifice/fields/date_field.py,sha256=xhMRsEwk4CztDae5va2Tx0v9Oh55M4p0S4Y0qu-ZlIk,5251
 ramifice/fields/date_time_field.py,sha256=RKxXVWTWGNxTri-MDlOAZNSwgtL46m-0grh3wKX-gi8,5286
 ramifice/fields/email_field.py,sha256=qXG7zHkr5ox4CFrb6QYarBMl8gwcq8KlVFVCj-zfvs0,3477
-ramifice/fields/file_field.py,sha256=IysryfsXz5wcBudV_h5BspMfwtEkvLHFhPPs6VgBp4A,7992
+ramifice/fields/file_field.py,sha256=YLdZvotj6ymEVRjYGU4xsiHkP_zI8krk3TuHaowvfDo,8126
 ramifice/fields/float_field.py,sha256=wadjiYakzv4uzWD8wI2E0B9w78Or4hZiAmrNXlOy8EI,4629
 ramifice/fields/id_field.py,sha256=NqdM0UJAi-iXJc7wa6CAJNG0-i4YNt08XGkHqV5ingc,4157
-ramifice/fields/image_field.py,sha256=EjvR_43CM_EJM4OO9VVdQGmNquKzmNsJ2OMeSIJB54k,12369
+ramifice/fields/image_field.py,sha256=MfKILPPz2ye8x696eEu8loRRpIWgP4neVoZ7ucNkDIw,11545
 ramifice/fields/integer_field.py,sha256=QpLqLItG4mVMYOhpGDVFNr-wDFqeUuERtfZy7C-EslE,4605
 ramifice/fields/ip_field.py,sha256=q-2OgT4VBDo8yzrX7wwuSHwexwsM8wDwnHOyQRACItI,3386
 ramifice/fields/password_field.py,sha256=EzIsegHdsVpnj9D-cTI1Q9RBbW07qUx7I7UFcMWW8Hk,3238
@@ -44,34 +44,33 @@ ramifice/fields/general/file_group.py,sha256=T-IwFnlJAWaRcQKVn09IJCdFNGgnUfMkjLz
 ramifice/fields/general/number_group.py,sha256=LOPHbKAnIuqW4DEh2fH78w6qOQjp0OhkuP7MoikhlkA,761
 ramifice/fields/general/text_group.py,sha256=m9EnlYGwqlck-JIYOCUd0hUYAVr8jH4YCnTmm9QlCkQ,1103
 ramifice/models/__init__.py,sha256=h_QQ5rSJNZ-7kmx7wIFd8E8RmUS94b_x4jdwMbq8zm4,15
-ramifice/models/decorator.py,sha256=6t5-dD5aoVbBfpGwpcIkowt0Hhupy1ldtJ3EuSQGGXc,7337
+ramifice/models/decorator.py,sha256=vEblLbpQQ0BkdTI2ch-BtDvCqWSEXe2aaEjxND705_Q,5954
 ramifice/models/model.py,sha256=JPEUYONRHVj7uE5vnuodc65dGHyBQCRmV8mdVUAgyXw,7118
-ramifice/models/pseudo.py,sha256=PEtK_ilezUlKKUyvwBZv5fc93SbZh2yoIQuc2c4D-Ko,6779
 ramifice/paladins/__init__.py,sha256=EJ6EEKXUcMG5P1bDmlEa4W3fsxSz5u6mzDG_oU1efMQ,618
-ramifice/paladins/check.py,sha256=CxcCiLBqNftrDksVi2XwKGWl1czTUbgXwzeIgJYgXCg,7057
-ramifice/paladins/delete.py,sha256=WEH0PwIdnGZpmUOLobJlZRD4iX94DOb_4ucwiGukd1o,3366
+ramifice/paladins/check.py,sha256=OeEDtL3lNR94bL1shrHloAHXHZtHnl6IWzEgukD9HSU,6580
+ramifice/paladins/delete.py,sha256=hnLpyMoNbgegQ_GF-A7iEHj7cbk1oSc5xyTy1BNLxsE,3426
 ramifice/paladins/password.py,sha256=pp0AVMf98w-2Ps3hHqwwIDSsXh93s-1TrBbeEI83Ly8,3041
 ramifice/paladins/refrash.py,sha256=4xojazc5BqCkE8_st11gH5tj2LpflzWVn2ZD-uNoOsg,1096
 ramifice/paladins/save.py,sha256=Z8vmqEksCK8XY27-BsgN2lyaNxLregOo5p0_XB9qUys,3895
-ramifice/paladins/tools.py,sha256=FYFnNMiTwyvoeBzKlpgsTx6GmFbv-m9Udpwc5Cog0DU,2713
+ramifice/paladins/tools.py,sha256=zc2VXp1U_BCT4IQWopwhxJ5vqci9jX128U5_nMeHawY,2652
 ramifice/paladins/validation.py,sha256=gcEJXIEPu1g7Z54vl14YTs5rCmxOEYsgQH1usFfyy7k,1730
 ramifice/paladins/groups/__init__.py,sha256=GxJWM3IkYT3HW9pnJ1QTEjdOKJnjEoAaQ8SRukXnIW0,712
 ramifice/paladins/groups/bool_group.py,sha256=rz1XIIdhOqbCOYZT1Yl84XaJg-0vwdcqCnt0BH-xHVA,808
 ramifice/paladins/groups/choice_group.py,sha256=KmrjbuHLLl6yGbRkdoMflf1thh17GLWrcbfaqrHlDiE,1813
 ramifice/paladins/groups/date_group.py,sha256=V3MCp8eA7txVLh6xmg76G9_y62TzWIQWqH59Ip26Xag,3779
-ramifice/paladins/groups/file_group.py,sha256=3_U3wHm306KGw88E63W5G11U6Y4d2IrFlo8EMOFSCGY,2976
+ramifice/paladins/groups/file_group.py,sha256=ySS7L5zcm2XrZRQUUOU8kgzqrucZ95UYzXD6pALWqE4,2982
 ramifice/paladins/groups/id_group.py,sha256=zN_Glu_cMGk8jMSDli3vYPvYrQXvQJNJFzb-t-qtZlQ,1290
-ramifice/paladins/groups/img_group.py,sha256=2VBtvItInjD1xCsAvx_7C3QJefV_0B6a8PPzpA3Ev08,5570
+ramifice/paladins/groups/img_group.py,sha256=YDJTvbRoqQ2nf7-2QbIQ72I4j_c98_d5LZNrD9kCy0Q,6040
 ramifice/paladins/groups/num_group.py,sha256=sbxzTdl33TVySfaNfqMixyBkJ69v6AqEgraFUN3Kftk,2317
 ramifice/paladins/groups/pass_group.py,sha256=uuIIqMBXsYG7vTHc_AhdgWuNCivxTgQMjkEu0-ElSmY,1887
 ramifice/paladins/groups/slug_group.py,sha256=ztiA2v7e5lQYRZtlLw8WGOhSWaYQfOdZ6wkKbx3ZbTM,2329
-ramifice/paladins/groups/text_group.py,sha256=aMaS7jA3NBAHE6mjv5M4sJE3xOdY8mKHIPv0uMH6CrU,4382
+ramifice/paladins/groups/text_group.py,sha256=cdwUZoomw61A7CmDIbds_oOaia2tD-J5LLuj5b8E8O4,4472
 ramifice/utils/__init__.py,sha256=xixHoOX4ja5jIUZemem1qn4k4aonv3G3Q76azQK_pkU,43
 ramifice/utils/errors.py,sha256=iuhq7fzpUmsOyeXeg2fJjta8yAuqlXLKsZVMpfUhtHE,1901
 ramifice/utils/fixtures.py,sha256=IG55gdFUbrWRQ2cL3Df9mYBgjVlFrlRuWB7UeK1Nzd8,3173
 ramifice/utils/globals.py,sha256=uR20um3Qg_1SG1t7WyWbpq8kQD-9Mslyr_c1yh5Hw9w,1751
-ramifice/utils/migration.py,sha256=cEGGSGcFGtaPUIkt_BB6tiPLFEtQtDoujV1hF413LVg,11108
-ramifice/utils/tools.py,sha256=1yFIOrkWToM55OpMMId9T26hZqPQWnxLU3_jQ4Ejazg,2743
+ramifice/utils/migration.py,sha256=JUhYaJ61IS1W_Khof0sbqeHDQrI7-XcmTQ41PhCdjcQ,11017
+ramifice/utils/tools.py,sha256=mEcLYdSM3x0Sj9d6ygYOfsOA7iXnmELoNNsCWtGIuGE,2841
 ramifice/utils/translations.py,sha256=aEkNKilD7RlJjBixqhh0cfIMw9lg13woaIwd3dyR8G4,4247
 ramifice/utils/unit.py,sha256=PPNKWYFJ8cz0nwbBPaTdL58_Nr7N0fIHFJBpKG2ZLKI,2482
 ramifice/utils/mixins/__init__.py,sha256=GrxJDsw73bEkitIh0-0BCxNnUK-N5uRXMCRlaPoaz1o,265
@@ -79,7 +78,7 @@ ramifice/utils/mixins/add_valid.py,sha256=TLOObedzXNA9eCylfAVbVCqIKE5sV-P5AdIN7a
 ramifice/utils/mixins/hooks.py,sha256=33jvJRhfnJeL2Hd_YFXk3M_7wjqHaByU2wRjKyboL6s,914
 ramifice/utils/mixins/indexing.py,sha256=Z0427HoaVRyNmSNN8Fx0mSICgAKV-gDdu3iR5qYUEbs,329
 ramifice/utils/mixins/json_converter.py,sha256=WhigXyDAV-FfILaZuwvRFRIk0D90Rv3dG5t-mv5fVyc,1107
-ramifice-0.5.12.dist-info/METADATA,sha256=2MQrjGd6MQddOO6PomVVgsfcCREPzHWWbriPLpMMHuQ,21454
-ramifice-0.5.12.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ramifice-0.5.12.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
-ramifice-0.5.12.dist-info/RECORD,,
+ramifice-0.6.1.dist-info/METADATA,sha256=oINmxfbfasgZhCMYMBRTUMErLb2Exx4l5khQjgXGusY,20993
+ramifice-0.6.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ramifice-0.6.1.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
+ramifice-0.6.1.dist-info/RECORD,,

ramifice/models/pseudo.py

@@ -1,181 +0,0 @@
-"""For converting Python classes into Ramifice models."""
-
-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 ramifice.utils import translations
-from ramifice.utils.errors import PanicError
-
-
-class PseudoModel(metaclass=ABCMeta):
-    """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.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_only_value(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