ramifice 0.5.11__py3-none-any.whl → 0.6.0__py3-none-any.whl

ramifice/__init__.py

@@ -14,6 +14,6 @@
 
 """ORM-like API MongoDB for Python language."""
 
-from .models.decorator import model
-from .utils import migration, translations
-from .utils.unit import Unit
+from ramifice.models.decorator import model
+from ramifice.utils import migration, translations
+from ramifice.utils.unit import Unit

ramifice/commons/__init__.py

@@ -1,10 +1,10 @@
 """Commons - Model class methods."""
 
-from .general import GeneralMixin
-from .indexes import IndexMixin
-from .many import ManyMixin
-from .one import OneMixin
-from .unit_manager import UnitMixin
+from ramifice.commons.general import GeneralMixin
+from ramifice.commons.indexes import IndexMixin
+from ramifice.commons.many import ManyMixin
+from ramifice.commons.one import OneMixin
+from ramifice.commons.unit_manager import UnitMixin
 
 
 class QCommonsMixin(

ramifice/commons/general.py

@@ -6,8 +6,8 @@ from pymongo.asynchronous.collection import AsyncCollection
 from pymongo.asynchronous.command_cursor import AsyncCommandCursor
 from pymongo.asynchronous.database import AsyncDatabase
 
-from ..utils import globals, translations
-from .tools import correct_mongo_filter
+from ramifice.commons.tools import correct_mongo_filter
+from ramifice.utils import globals, translations
 
 
 class GeneralMixin:

ramifice/commons/indexes.py

@@ -4,7 +4,7 @@ from typing import Any
 
 from pymongo.asynchronous.collection import AsyncCollection
 
-from ..utils import globals
+from ramifice.utils import globals
 
 
 class IndexMixin:

ramifice/commons/many.py

@@ -7,9 +7,13 @@ from pymongo.asynchronous.collection import AsyncCollection
 from pymongo.asynchronous.cursor import AsyncCursor, CursorType
 from pymongo.results import DeleteResult
 
-from ..utils import globals, translations
-from ..utils.errors import PanicError
-from .tools import correct_mongo_filter, mongo_doc_to_raw_doc, password_to_none
+from ramifice.commons.tools import (
+    correct_mongo_filter,
+    mongo_doc_to_raw_doc,
+    password_to_none,
+)
+from ramifice.utils import globals, translations
+from ramifice.utils.errors import PanicError
 
 
 class ManyMixin:

ramifice/commons/one.py

@@ -5,9 +5,13 @@ from typing import Any
 from pymongo.asynchronous.collection import AsyncCollection
 from pymongo.results import DeleteResult
 
-from ..utils import globals, translations
-from ..utils.errors import PanicError
-from .tools import correct_mongo_filter, mongo_doc_to_raw_doc, password_to_none
+from ramifice.commons.tools import (
+    correct_mongo_filter,
+    mongo_doc_to_raw_doc,
+    password_to_none,
+)
+from ramifice.utils import globals, translations
+from ramifice.utils.errors import PanicError
 
 
 class OneMixin:

ramifice/commons/tools.py

@@ -6,7 +6,7 @@ from typing import Any
 from babel.dates import format_date, format_datetime
 from bson import json_util
 
-from ..utils import translations
+from ramifice.utils import translations
 
 
 def correct_mongo_filter(cls_model: Any, filter: Any) -> Any:

ramifice/commons/unit_manager.py

@@ -7,9 +7,9 @@ from typing import Any
 
 from pymongo.asynchronous.collection import AsyncCollection
 
-from ..utils import globals, translations
-from ..utils.errors import PanicError
-from ..utils.unit import Unit
+from ramifice.utils import globals, translations
+from ramifice.utils.errors import PanicError
+from ramifice.utils.unit import Unit
 
 
 class UnitMixin:

ramifice/fields/__init__.py

@@ -1,30 +1,30 @@
 """Available field types."""
 
-from .bool_field import BooleanField
-from .choice_float_dyn_field import ChoiceFloatDynField
-from .choice_float_field import ChoiceFloatField
-from .choice_float_mult_dyn_field import ChoiceFloatMultDynField
-from .choice_float_mult_field import ChoiceFloatMultField
-from .choice_int_dyn_field import ChoiceIntDynField
-from .choice_int_field import ChoiceIntField
-from .choice_int_mult_dyn_field import ChoiceIntMultDynField
-from .choice_int_mult_field import ChoiceIntMultField
-from .choice_text_dyn_field import ChoiceTextDynField
-from .choice_text_field import ChoiceTextField
-from .choice_text_mult_dyn_field import ChoiceTextMultDynField
-from .choice_text_mult_field import ChoiceTextMultField
-from .color_field import ColorField
-from .date_field import DateField
-from .date_time_field import DateTimeField
-from .email_field import EmailField
-from .file_field import FileField
-from .float_field import FloatField
-from .id_field import IDField
-from .image_field import ImageField
-from .integer_field import IntegerField
-from .ip_field import IPField
-from .password_field import PasswordField
-from .phone_field import PhoneField
-from .slug_field import SlugField
-from .text_field import TextField
-from .url_field import URLField
+from ramifice.fields.bool_field import BooleanField
+from ramifice.fields.choice_float_dyn_field import ChoiceFloatDynField
+from ramifice.fields.choice_float_field import ChoiceFloatField
+from ramifice.fields.choice_float_mult_dyn_field import ChoiceFloatMultDynField
+from ramifice.fields.choice_float_mult_field import ChoiceFloatMultField
+from ramifice.fields.choice_int_dyn_field import ChoiceIntDynField
+from ramifice.fields.choice_int_field import ChoiceIntField
+from ramifice.fields.choice_int_mult_dyn_field import ChoiceIntMultDynField
+from ramifice.fields.choice_int_mult_field import ChoiceIntMultField
+from ramifice.fields.choice_text_dyn_field import ChoiceTextDynField
+from ramifice.fields.choice_text_field import ChoiceTextField
+from ramifice.fields.choice_text_mult_dyn_field import ChoiceTextMultDynField
+from ramifice.fields.choice_text_mult_field import ChoiceTextMultField
+from ramifice.fields.color_field import ColorField
+from ramifice.fields.date_field import DateField
+from ramifice.fields.date_time_field import DateTimeField
+from ramifice.fields.email_field import EmailField
+from ramifice.fields.file_field import FileField
+from ramifice.fields.float_field import FloatField
+from ramifice.fields.id_field import IDField
+from ramifice.fields.image_field import ImageField
+from ramifice.fields.integer_field import IntegerField
+from ramifice.fields.ip_field import IPField
+from ramifice.fields.password_field import PasswordField
+from ramifice.fields.phone_field import PhoneField
+from ramifice.fields.slug_field import SlugField
+from ramifice.fields.text_field import TextField
+from ramifice.fields.url_field import URLField

ramifice/fields/bool_field.py

@@ -1,8 +1,8 @@
 """Field of Model for enter boolean value."""
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.field import Field
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class BooleanField(Field, JsonMixin):

ramifice/fields/choice_float_dyn_field.py

@@ -3,10 +3,10 @@
 Type of selective float field with dynamic addition of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceFloatDynField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/choice_float_field.py

@@ -3,10 +3,10 @@
 Type of selective float field with static of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceFloatField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/choice_float_mult_dyn_field.py

@@ -3,10 +3,10 @@
 Type of selective float field with dynamic addition of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceFloatMultDynField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/choice_float_mult_field.py

@@ -3,10 +3,10 @@
 Type of selective float field with static of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceFloatMultField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/choice_int_dyn_field.py

@@ -3,10 +3,10 @@
 Type of selective integer field with dynamic addition of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceIntDynField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/choice_int_field.py

@@ -3,10 +3,10 @@
 Type of selective integer field with static of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceIntField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/choice_int_mult_dyn_field.py

@@ -3,10 +3,10 @@
 Type of selective integer field with dynamic addition of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceIntMultDynField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/choice_int_mult_field.py

@@ -3,10 +3,10 @@
 Type of selective integer field with static of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceIntMultField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/choice_text_dyn_field.py

@@ -3,10 +3,10 @@
 Type of selective text field with dynamic addition of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceTextDynField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/choice_text_field.py

@@ -3,10 +3,10 @@
 Type of selective text field with static of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceTextField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/choice_text_mult_dyn_field.py

@@ -3,10 +3,10 @@
 Type of selective text field with dynamic addition of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceTextMultDynField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/choice_text_mult_field.py

@@ -3,10 +3,10 @@
 Type of selective text field with static of elements.
 """
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.choice_group import ChoiceGroup
-from .general.field import Field
+from ramifice.fields.general.choice_group import ChoiceGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ChoiceTextMultField(Field, ChoiceGroup, JsonMixin):

ramifice/fields/color_field.py

@@ -1,9 +1,9 @@
 """Field of Model for enter color code."""
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.field import Field
-from .general.text_group import TextGroup
+from ramifice.fields.general.field import Field
+from ramifice.fields.general.text_group import TextGroup
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class ColorField(Field, TextGroup, JsonMixin):

ramifice/fields/date_field.py

@@ -7,9 +7,9 @@ from typing import Any
 from babel.dates import format_date
 from dateutil.parser import parse
 
-from ..utils import globals, translations
-from .general.date_group import DateGroup
-from .general.field import Field
+from ramifice.fields.general.date_group import DateGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals, translations
 
 
 class DateField(Field, DateGroup):

ramifice/fields/date_time_field.py

@@ -7,9 +7,9 @@ from typing import Any
 from babel.dates import format_datetime
 from dateutil.parser import parse
 
-from ..utils import globals, translations
-from .general.date_group import DateGroup
-from .general.field import Field
+from ramifice.fields.general.date_group import DateGroup
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals, translations
 
 
 class DateTimeField(Field, DateGroup):

ramifice/fields/email_field.py

@@ -2,10 +2,10 @@
 
 from email_validator import EmailNotValidError, validate_email
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.field import Field
-from .general.text_group import TextGroup
+from ramifice.fields.general.field import Field
+from ramifice.fields.general.text_group import TextGroup
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class EmailField(Field, TextGroup, JsonMixin):

ramifice/fields/file_field.py

@@ -1,18 +1,19 @@
 """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
 
-from ..utils import globals
-from ..utils.errors import FileHasNoExtensionError
-from ..utils.mixins.json_converter import JsonMixin
-from .general.field import Field
-from .general.file_group import FileGroup
+import aiofiles
+from aioshutil import copyfile
+
+from ramifice.fields.general.field import Field
+from ramifice.fields.general.file_group import FileGroup
+from ramifice.utils import globals
+from ramifice.utils.errors import FileHasNoExtensionError
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class FileField(Field, FileGroup, JsonMixin):
@@ -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/float_field.py

@@ -1,9 +1,9 @@
 """Field of Model for enter (float) number."""
 
-from ..utils import globals
-from ..utils.mixins.json_converter import JsonMixin
-from .general.field import Field
-from .general.number_group import NumberGroup
+from ramifice.fields.general.field import Field
+from ramifice.fields.general.number_group import NumberGroup
+from ramifice.utils import globals
+from ramifice.utils.mixins.json_converter import JsonMixin
 
 
 class FloatField(Field, NumberGroup, JsonMixin):

ramifice/fields/general/__init__.py

@@ -1 +1 @@
-# ruff: noqa: D104
+"""Abstract classes for the fields."""

ramifice/fields/general/choice_group.py

@@ -1,7 +1,9 @@
 """General additional parameters for choice fields."""
 
+from abc import ABCMeta
 
-class ChoiceGroup:
+
+class ChoiceGroup(metaclass=ABCMeta):
     """General additional parameters for choice fields.
 
     Attributes:

ramifice/fields/general/date_group.py

@@ -1,9 +1,10 @@
 """General additional parameters for date|datetime fields."""
 
+from abc import ABCMeta
 from datetime import datetime
 
 
-class DateGroup:
+class DateGroup(metaclass=ABCMeta):
     """General additional parameters for date|datetime fields.
 
     Attributes:

ramifice/fields/general/field.py

@@ -1,7 +1,9 @@
 """General parameters for all types fields of Model."""
 
+from abc import ABCMeta
 
-class Field:
+
+class Field(metaclass=ABCMeta):
     """General parameters for all types fields of Model.
 
     Attributes:

ramifice/fields/general/file_group.py

@@ -1,7 +1,9 @@
 """General additional parameters for file fields."""
 
+from abc import ABCMeta
 
-class FileGroup:
+
+class FileGroup(metaclass=ABCMeta):
     """General additional parameters for file fields.
 
     Attributes:

ramifice/fields/general/number_group.py

@@ -1,7 +1,9 @@
 """General additional parameters for number fields."""
 
+from abc import ABCMeta
 
-class NumberGroup:
+
+class NumberGroup(metaclass=ABCMeta):
     """General additional parameters for number fields.
 
     Attributes:

ramifice/fields/general/text_group.py

@@ -1,7 +1,9 @@
 """General additional parameters for text fields."""
 
+from abc import ABCMeta
 
-class TextGroup:
+
+class TextGroup(metaclass=ABCMeta):
     """General additional parameters for text fields.
 
     Attributes:

ramifice/fields/id_field.py

@@ -5,8 +5,8 @@ from typing import Any
 
 from bson.objectid import ObjectId
 
-from ..utils import globals
-from .general.field import Field
+from ramifice.fields.general.field import Field
+from ramifice.utils import globals
 
 
 class IDField(Field):