ramifice 0.4.11__py3-none-any.whl → 0.5.0__py3-none-any.whl

ramifice/commons/general.py

@@ -7,6 +7,7 @@ from pymongo.asynchronous.command_cursor import AsyncCommandCursor
 from pymongo.asynchronous.database import AsyncDatabase
 
 from ..utils import globals, translations
+from .tools import correct_mongo_filter
 
 
 class GeneralMixin:
@@ -25,7 +26,7 @@ class GeneralMixin:
             if field is None:
                 continue
             if field.field_type == "TextField":
-                field.value = data.get(lang, "") if data is not None else None
+                field.value = data.get(lang, "- -") if data is not None else None
             elif field.group == "pass":
                 field.value = None
             else:
@@ -58,7 +59,10 @@ class GeneralMixin:
         """Gets an estimate of the count of documents in a collection using collection metadata."""
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
-        #
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
+
         return await collection.count_documents(
             filter=filter,
             session=session,
@@ -78,7 +82,10 @@ class GeneralMixin:
         """Runs an aggregation framework pipeline."""
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
-        #
+        # Correcting filter.
+        if pipeline is not None:
+            pipeline = correct_mongo_filter(cls, pipeline)
+
         return await collection.aggregate(
             pipeline=pipeline,
             session=session,
@@ -103,7 +110,10 @@ class GeneralMixin:
         """
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
-        #
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
+
         return await collection.distinct(
             key=key,
             filter=filter,

ramifice/commons/many.py

@@ -7,9 +7,9 @@ from pymongo.asynchronous.collection import AsyncCollection
 from pymongo.asynchronous.cursor import AsyncCursor, CursorType
 from pymongo.results import DeleteResult
 
-from ..utils import globals
+from ..utils import globals, translations
 from ..utils.errors import PanicError
-from .tools import mongo_doc_to_raw_doc, password_to_none
+from .tools import correct_mongo_filter, mongo_doc_to_raw_doc, password_to_none
 
 
 class ManyMixin:
@@ -43,6 +43,9 @@ class ManyMixin:
         """Find documents."""
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
         # Get documents.
         doc_list: list[dict[str, Any]] = []
         cursor: AsyncCursor = collection.find(
@@ -108,6 +111,9 @@ class ManyMixin:
         """
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
         # Get documents.
         doc_list: list[dict[str, Any]] = []
         cursor: AsyncCursor = collection.find(
@@ -133,9 +139,18 @@ class ManyMixin:
             session=session,
             allow_disk_use=allow_disk_use,
         )
-        field_name_and_type = cls.META["field_name_and_type"]
+        inst_model_dict = {
+            key: val for key, val in cls().__dict__.items() if not callable(val) and not val.ignored
+        }
+        lang = translations.CURRENT_LOCALE
         async for mongo_doc in cursor:
-            doc_list.append(mongo_doc_to_raw_doc(field_name_and_type, mongo_doc))
+            doc_list.append(
+                mongo_doc_to_raw_doc(
+                    inst_model_dict,
+                    mongo_doc,
+                    lang,
+                )
+            )
         return doc_list
 
     @classmethod
@@ -166,6 +181,9 @@ class ManyMixin:
         """Find documents and convert to a json string."""
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
         # Get documents.
         doc_list: list[dict[str, Any]] = []
         cursor: AsyncCursor = collection.find(
@@ -191,9 +209,18 @@ class ManyMixin:
             session=session,
             allow_disk_use=allow_disk_use,
         )
-        field_name_and_type = cls.META["field_name_and_type"]
+        inst_model_dict = {
+            key: val for key, val in cls().__dict__.items() if not callable(val) and not val.ignored
+        }
+        lang = translations.CURRENT_LOCALE
         async for mongo_doc in cursor:
-            doc_list.append(mongo_doc_to_raw_doc(field_name_and_type, mongo_doc))
+            doc_list.append(
+                mongo_doc_to_raw_doc(
+                    inst_model_dict,
+                    mongo_doc,
+                    lang,
+                )
+            )
         return json.dumps(doc_list) if len(doc_list) > 0 else None
 
     @classmethod
@@ -217,6 +244,9 @@ class ManyMixin:
             raise PanicError(msg)
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
         # Delete documents.
         result: DeleteResult = await collection.delete_many(
             filter=filter,

ramifice/commons/one.py

@@ -5,9 +5,9 @@ from typing import Any
 from pymongo.asynchronous.collection import AsyncCollection
 from pymongo.results import DeleteResult
 
-from ..utils import globals
+from ..utils import globals, translations
 from ..utils.errors import PanicError
-from .tools import mongo_doc_to_raw_doc, password_to_none
+from .tools import correct_mongo_filter, mongo_doc_to_raw_doc, password_to_none
 
 
 class OneMixin:
@@ -23,6 +23,9 @@ class OneMixin:
         """Find a single document."""
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
         # Get document.
         mongo_doc = await collection.find_one(filter, *args, **kwargs)
         if mongo_doc is not None:
@@ -42,13 +45,20 @@ class OneMixin:
         """Find a single document and converting to raw document."""
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
         # Get document.
         raw_doc = None
         mongo_doc = await collection.find_one(filter, *args, **kwargs)
+        inst_model_dict = {
+            key: val for key, val in cls().__dict__.items() if not callable(val) and not val.ignored
+        }
         if mongo_doc is not None:
             raw_doc = mongo_doc_to_raw_doc(
-                cls.META["field_name_and_type"],
+                inst_model_dict,
                 mongo_doc,
+                translations.CURRENT_LOCALE,
             )
         return raw_doc
 
@@ -62,6 +72,9 @@ class OneMixin:
         """Find a single document and convert it to a Model instance."""
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
         # Get document.
         inst_model = None
         mongo_doc = await collection.find_one(filter, *args, **kwargs)
@@ -80,12 +93,15 @@ class OneMixin:
         """Find a single document and convert it to a JSON string."""
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
         # Get document.
         json_str: str | None = None
         mongo_doc = await collection.find_one(filter, *args, **kwargs)
         if mongo_doc is not None:
             # Convert document to Model instance.
-            inst_model = cls.from_mongo_doc( mongo_doc)
+            inst_model = cls.from_mongo_doc(mongo_doc)
             json_str = inst_model.to_json()
         return json_str
 
@@ -110,6 +126,9 @@ class OneMixin:
             raise PanicError(msg)
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
         # Get document.
         result: DeleteResult = await collection.delete_one(
             filter=filter,
@@ -144,6 +163,9 @@ class OneMixin:
             raise PanicError(msg)
         # Get collection for current model.
         collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
+        # Correcting filter.
+        if filter is not None:
+            filter = correct_mongo_filter(cls, filter)
         # Get document.
         mongo_doc: dict[str, Any] | None = await collection.find_one_and_delete(
             filter=filter,

ramifice/commons/tools.py

@@ -1,12 +1,29 @@
 """Tool of Commons - A set of auxiliary methods."""
 
+import json
 from typing import Any
 
 from babel.dates import format_date, format_datetime
+from bson import json_util
 
 from ..utils import translations
 
 
+def correct_mongo_filter(cls_model: Any, filter: Any) -> Any:
+    """Correcting filter of request.
+
+    Corrects `TextField` fields that require localization of translation.
+    """
+    lang: str = translations.CURRENT_LOCALE
+    filter_json: str = json_util.dumps(filter)
+    filter_json = (
+        cls_model.META["regex_mongo_filter"]
+        .sub(rf'\g<field>.{lang}":', filter_json)
+        .replace('":.', ".")
+    )
+    return json_util.loads(filter_json)
+
+
 def password_to_none(
     field_name_and_type: dict[str, str],
     mongo_doc: dict[str, Any],
@@ -19,8 +36,9 @@ def password_to_none(
 
 
 def mongo_doc_to_raw_doc(
-    field_name_and_type: dict[str, str],
+    inst_model_dict: dict[str, Any],
     mongo_doc: dict[str, Any],
+    lang: str,
 ) -> dict[str, Any]:
     """Convert the Mongo document to the raw document.
 
@@ -31,14 +49,14 @@ def mongo_doc_to_raw_doc(
         datetime to str
     """
     doc: dict[str, Any] = {}
-    lang: str = translations.CURRENT_LOCALE
-    for f_name, t_name in field_name_and_type.items():
+    for f_name, f_data in inst_model_dict.items():
+        field_type = f_data.field_type
         value = mongo_doc[f_name]
         if value is not None:
-            if t_name == "TextField":
-                value = value.get(lang, "") if value is not None else None
-            elif "Date" in t_name:
-                if "Time" in t_name:
+            if field_type == "TextField" and f_data.multi_language:
+                value = value.get(lang, "- -") if value is not None else None
+            elif "Date" in field_type:
+                if "Time" in field_type:
                     value = format_datetime(
                         datetime=value,
                         format="short",
@@ -50,9 +68,9 @@ def mongo_doc_to_raw_doc(
                         format="short",
                         locale=lang,
                     )
-            elif t_name == "IDField":
+            elif field_type == "IDField":
                 value = str(value)
-            elif t_name == "PasswordField":
+            elif field_type == "PasswordField":
                 value = None
         doc[f_name] = value
     return doc

ramifice/commons/unit_manager.py

@@ -7,7 +7,7 @@ from typing import Any
 
 from pymongo.asynchronous.collection import AsyncCollection
 
-from ..utils import globals
+from ..utils import globals, translations
 from ..utils.errors import PanicError
 from ..utils.unit import Unit
 
@@ -34,59 +34,52 @@ class UnitMixin:
         # Check the presence of a Model state.
         if model_state is None:
             raise PanicError("Error: Model State - Not found!")
-        # Get the dynamic field type.
-        field_type = model_state["field_name_and_type"][unit.field]
         # Get dynamic field data.
-        choices: dict[str, float | int | str] | None = model_state["data_dynamic_fields"][
-            unit.field
-        ]
-        # Check whether the type of value is valid for the type of field.
-        if not (
-            ("ChoiceFloat" in field_type and isinstance(unit.value, float))
-            or ("ChoiceInt" in field_type and isinstance(unit.value, int))
-            or ("ChoiceText" in field_type and isinstance(unit.value, str))
-        ):
-            msg = (
-                "Error: Method: `unit_manager(unit: Unit)` => unit.value - "
-                + f"The type of value `{type(unit.value)}` "
-                + f"does not correspond to the type of field `{field_type}`!"
-            )
-            raise PanicError(msg)
+        choices: list | None = model_state["data_dynamic_fields"][unit.field]
+        # Get Title.
+        title = unit.title
+        title = {lang: title.get(lang, "- -") for lang in translations.LANGUAGES}
+        main_lang = translations.DEFAULT_LOCALE
+        main_title = title[main_lang]
         # Add Unit to Model State.
         if not unit.is_delete:
             if choices is not None:
-                choices = {**choices, **{unit.title: unit.value}}
+                choices.append({"title": title, "value": unit.value})
             else:
-                choices = {unit.title: unit.value}
+                choices = [{"title": title, "value": unit.value}]
             model_state["data_dynamic_fields"][unit.field] = choices
-        # Delete Unit from Model State.
         else:
+            # Delete Unit from Model State.
             if choices is None:
                 msg = (
                     "Error: It is not possible to delete Unit."
-                    + f"Unit `{unit.title}: {unit.value}` not exists!"
+                    + f"Title `{main_title}` not exists!"
                 )
                 raise PanicError(msg)
-            is_key_exists: bool = unit.title in choices.keys()
+            is_key_exists: bool = False
+            for item in choices:
+                if main_title == item["title"][main_lang]:
+                    is_key_exists = True
+                    break
             if not is_key_exists:
                 msg = (
                     "Error: It is not possible to delete Unit."
-                    + f"Unit `{unit.title}: {unit.value}` not exists!"
+                    + f"Title `{main_title}` not exists!"
                 )
                 raise PanicError(msg)
-            del choices[unit.title]
+            choices = [item for item in choices if item["title"][main_lang] != main_title]
             model_state["data_dynamic_fields"][unit.field] = choices or None
-        # Update the state of the Model in the super collection.
+        # Update state of current Model in super collection.
         await super_collection.replace_one(
             filter={"collection_name": model_state["collection_name"]},
             replacement=model_state,
         )
-        # Update metadata of the current Model.
+        # Update metadata of current Model.
         cls.META["data_dynamic_fields"][unit.field] = choices or None
         # Update documents in the collection of the current Model.
         if unit.is_delete:
             unit_field: str = unit.field
-            unit_value: float | int | str = unit.value
+            unit_value: float | int | str | None = unit.value
             collection: AsyncCollection = globals.MONGO_DATABASE[cls.META["collection_name"]]
             async for mongo_doc in collection.find():
                 field_value = mongo_doc[unit_field]

ramifice/fields/text_field.py

@@ -23,6 +23,8 @@ class TextField(Field, JsonMixin):
         readonly: bool = False,
         unique: bool = False,
         maxlength: int = 256,
+        # Support for several language.
+        multi_language: bool = False,
     ):
         if globals.DEBUG:
             if not isinstance(maxlength, int):
@@ -55,6 +57,8 @@ class TextField(Field, JsonMixin):
                 raise AssertionError("Parameter `use_editor` - Not а `bool` type!")
             if not isinstance(maxlength, int):
                 raise AssertionError("Parameter `maxlength` - Not а `int` type!")
+            if not isinstance(multi_language, bool):
+                raise AssertionError("Parameter `multi_language` - Not а `int` type!")
 
         Field.__init__(
             self,
@@ -78,6 +82,8 @@ class TextField(Field, JsonMixin):
         self.textarea = textarea
         self.use_editor = use_editor
         self.maxlength = maxlength
+        # Support for several language.
+        self.multi_language = multi_language
 
     def __len__(self) -> int:
         """Return length of field `value`."""

ramifice/models/decorator.py

@@ -1,16 +1,17 @@
 """Decorator for converting Python classes into Ramifice models."""
 
 import os
+import re
 from typing import Any
 
 from ..commons import QCommonsMixin
 from ..fields import DateTimeField, IDField
 from ..paladins import CheckMixin, QPaladinsMixin, ValidationMixin
 from ..utils.errors import DoesNotMatchRegexError, PanicError
+from ..utils.globals import REGEX
 from ..utils.mixins.add_valid import AddValidMixin
 from ..utils.mixins.hooks import HooksMixin
 from ..utils.mixins.indexing import IndexMixin
-from ..utils.globals import REGEX
 from .model import Model
 from .pseudo import PseudoModel
 
@@ -103,7 +104,7 @@ def model(
 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__
+    model_name: str = cls.__name__
     if REGEX["model_name"].match(model_name) is None:
         raise DoesNotMatchRegexError("^[A-Z][a-zA-Z0-9]{0,24}$")
     #
@@ -118,9 +119,12 @@ def caching(cls: Any, service_name: str, is_migrate_model: bool) -> dict[str, An
     # Build data migration storage for dynamic fields.
     data_dynamic_fields: dict[str, dict[str, str | int | float] | None] = {}
     # Count all fields.
-    count_all_fields = 0
+    count_all_fields: int = 0
     # Count fields for migrating.
-    count_fields_no_ignored = 0
+    count_fields_no_ignored: int = 0
+    # List of fields that support localization of translates.
+    # Hint: `TextField`
+    supported_lang_fields: list[str] = []
 
     raw_model = cls()
     raw_model.fields()
@@ -130,9 +134,9 @@ def caching(cls: Any, service_name: str, is_migrate_model: bool) -> dict[str, An
         default_fields["created_at"] = DateTimeField()
         default_fields["updated_at"] = DateTimeField()
     fields = {**raw_model.__dict__, **default_fields}
-    for f_name, f_type in fields.items():
-        if not callable(f_type):
-            f_type_str = f_type.__class__.__name__
+    for f_name, f_data in fields.items():
+        if not callable(f_data):
+            f_type_str = f_data.__class__.__name__
             # Count all fields.
             count_all_fields += 1
             # Get attributes value for fields of Model: id, name.
@@ -141,14 +145,14 @@ def caching(cls: Any, service_name: str, is_migrate_model: bool) -> dict[str, An
                 "name": f_name,
             }
             #
-            if not f_type.ignored:
+            if not f_data.ignored:
                 # Count fields for migrating.
                 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 "Dyn" in f_data.field_type:
                     if not is_migrate_model:
                         msg = (
                             f"Model: `{cls.__module__}.{model_name}` > "
@@ -157,11 +161,16 @@ def caching(cls: Any, service_name: str, is_migrate_model: bool) -> dict[str, An
                         )
                         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)
 
     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_no_ignored"] = count_fields_no_ignored
+    metadata["regex_mongo_filter"] = re.compile(
+        rf'(?P<field>"(?:{"|".join(supported_lang_fields)})":)'
+    )
 
     return metadata

ramifice/models/model.py

@@ -68,6 +68,7 @@ class Model(metaclass=ABCMeta):
         """Injecting metadata from Model.META in params of fields."""
         metadata = self.__class__.META
         if bool(metadata):
+            lang = translations.CURRENT_LOCALE
             field_attrs = metadata["field_attrs"]
             data_dynamic_fields = metadata["data_dynamic_fields"]
             for f_name, f_type in self.__dict__.items():
@@ -75,7 +76,13 @@ class Model(metaclass=ABCMeta):
                     f_type.id = field_attrs[f_name]["id"]
                     f_type.name = field_attrs[f_name]["name"]
                     if "Dyn" in f_type.field_type:
-                        f_type.choices = data_dynamic_fields[f_name]
+                        dyn_data = data_dynamic_fields[f_name]
+                        if dyn_data is not None:
+                            f_type.choices = {
+                                item["title"].get(lang, "- -"): item["value"] for item in dyn_data
+                            }
+                        else:
+                            f_type.choices = None
 
     # Complect of methods for converting Model to JSON and back.
     # --------------------------------------------------------------------------

ramifice/paladins/groups/text_group.py

@@ -27,11 +27,11 @@ class TextGroupMixin:
         field = params["field_data"]
         field_name = field.name
         field_type: str = field.field_type
-        is_text_field: bool = "TextField" == field_type
+        is_multi_language: bool = (field_type == "TextField") and field.multi_language
         # Get current value.
         value = field.value or field.__dict__.get("default")
 
-        if is_text_field:
+        if is_multi_language:
             if not isinstance(value, (str, dict, type(None))):
                 panic_type_error("str | dict | None", params)
         else:
@@ -55,7 +55,7 @@ class TextGroupMixin:
             value,
             params,
             field_name,
-            is_text_field,
+            is_multi_language,
         ):
             err_msg = translations._("Is not unique !")
             accumulate_error(err_msg, params)
@@ -85,19 +85,19 @@ class TextGroupMixin:
             accumulate_error(err_msg, params)
         # Insert result.
         if params["is_save"]:
-            if is_text_field:
+            if is_multi_language:
                 mult_lang_text: dict[str, str] = (
                     params["curr_doc"][field_name]
                     if params["is_update"]
                     else (
                         {lang: value for lang in translations.LANGUAGES}
                         if isinstance(value, str)
-                        else {lang: value.get(lang, "") for lang in translations.LANGUAGES}
+                        else {lang: value.get(lang, "- -") for lang in translations.LANGUAGES}
                     )
                 )
                 if isinstance(value, dict):
                     for lang in translations.LANGUAGES:
-                        mult_lang_text[lang] = value.get(lang, "")
+                        mult_lang_text[lang] = value.get(lang, "- -")
                 else:
                     mult_lang_text[translations.CURRENT_LOCALE] = value
                 value = mult_lang_text

ramifice/paladins/tools.py

@@ -15,10 +15,11 @@ def ignored_fields_to_none(inst_model: Any) -> None:
 def refresh_from_mongo_doc(inst_model: Any, mongo_doc: dict[str, Any]) -> None:
     """Update object instance from Mongo document."""
     lang: str = translations.CURRENT_LOCALE
+    model_dict = inst_model.__dict__
     for name, data in mongo_doc.items():
-        field = inst_model.__dict__[name]
-        if field.field_type == "TextField":
-            field.value = data.get(lang, "") if data is not None else None
+        field = model_dict[name]
+        if field.field_type == "TextField" and field.multi_language:
+            field.value = data.get(lang, "- -") if data is not None else None
         elif field.group == "pass":
             field.value = None
         else:
@@ -54,13 +55,13 @@ async def check_uniqueness(
     value: str | int | float,
     params: dict[str, Any],
     field_name: str | None = None,
-    is_text_field: bool = False,
+    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_text_field:
+    if is_multi_language:
         lang_filter = [{f"{field_name}.{lang}": value} for lang in translations.LANGUAGES]
         q_filter = {
             "$and": [

ramifice/utils/unit.py

@@ -1,5 +1,7 @@
 """Unit - Data management in dynamic fields."""
 
+from typing import Any
+
 from .errors import PanicError
 from .mixins.json_converter import JsonMixin
 
@@ -17,19 +19,22 @@ class Unit(JsonMixin):
     def __init__(  # noqa: D107
         self,
         field: str,
-        title: str,
-        value: float | int | str,
+        title: dict[str, str],  # Example: {"en": "Title", "ru": "Заголовок"}
+        value: float | int | str | None = None,  # None for is_delete=True
         is_delete: bool = False,
     ):
         # Check the match of types.
         if not isinstance(field, str):
             msg = "Class: `Unit` > Field: `field` => Not а `str` type!"
             raise PanicError(msg)
-        if not isinstance(title, str):
-            msg = "Class: `Unit` > Field: `title` => Not а `str` type!"
+        if not isinstance(title, dict):
+            msg = (
+                "Class: `Unit` > Field: `title` => Not а `str` type! "
+                + 'Example: {"en": "Title", "ru": "Заголовок"}'
+            )
             raise PanicError(msg)
-        if not isinstance(value, (float, int, str)):
-            msg = "Class: `Unit` > Field: `value` => Not а `float | int | str` type!"
+        if not isinstance(value, (float, int, str, type(None))):
+            msg = "Class: `Unit` > Field: `value` => Not а `float | int | str | None` type!"
             raise PanicError(msg)
         if not isinstance(is_delete, bool):
             msg = "Class: `Unit` > Field: `is_delete` => Not а `bool` type!"
@@ -42,10 +47,10 @@ class Unit(JsonMixin):
         self.value = value
         self.is_delete = is_delete
 
-        self.check_empty_arguments()
+        self.check_value_arguments()
 
-    def check_empty_arguments(self) -> None:
-        """Error: If any of the arguments in the Unit is empty.
+    def check_value_arguments(self) -> None:
+        """Check if the values correspond to the arguments.
 
         Returns:
             `None` or raised exception `PanicError`.
@@ -56,6 +61,14 @@ class Unit(JsonMixin):
             field_name = "field"
         elif len(self.title) == 0:
             field_name = "title"
+        elif self.value is None and self.is_delete == False:
+            msg = (
+                "Method: `unit_manager` > "
+                + "Argument: `unit` > "
+                + f"Field: `{field_name}` => "
+                + "For `value` = None, `is_delete` should be True!"
+            )
+            raise PanicError(msg)
         elif isinstance(self.value, str) and len(self.value) == 0:
             field_name = "value"
 

{ramifice-0.4.11.dist-info → ramifice-0.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ramifice
-Version: 0.4.11
+Version: 0.5.0
 Summary: ORM-like API MongoDB for Python language.
 Project-URL: Homepage, https://github.com/kebasyaty/ramifice
 Project-URL: Documentation, https://kebasyaty.github.io/ramifice/
@@ -177,7 +177,10 @@ class User:
             required=True,
             unique=True,
         )
-        self.first_name = TextField(label=gettext("First name"), required=True)
+        self.first_name = TextField(
+          label=gettext("First name"),
+          required=True,
+        )
         self.last_name = TextField(
             label=gettext("Last name"),
             required=True,
@@ -187,8 +190,17 @@ class User:
             required=True,
             unique=True,
         )
-        self.birthday = DateField(label=gettext("Birthday"))
-        self.password = PasswordField(label=gettext("Password"))
+        self.birthday = DateField(
+          label=gettext("Birthday"),
+        )
+        self.description = TextField(
+          label=gettext("About yourself"),
+          # Support for several language.
+          multi_language=True,
+        )
+        self.password = PasswordField(
+          label=gettext("Password"),
+        )
         self.сonfirm_password = PasswordField(
             label=gettext("Confirm password"),
             # If true, the value of this field is not saved in the database.
@@ -251,8 +263,7 @@ async def main():
     print("User details:")
     user_details = await User.find_one_to_raw_doc(
         # {"_id": user.id.value}
-        # For `TextField`.
-        {f"username.{translations.CURRENT_LOCALE}": user.username.value}
+        {f"username": user.username.value}
     )
     if user_details is not None:
         pprint.pprint(user_details)

{ramifice-0.4.11.dist-info → ramifice-0.5.0.dist-info}/RECORD

@@ -1,12 +1,12 @@
 ramifice/__init__.py,sha256=IuI20h84QWyFftykvte_HLft2iVxwpu0K592NypMwfo,759
 ramifice/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ramifice/commons/__init__.py,sha256=FTG78sTU0ay0rvmrq5fUmVjL-I-S7wgQq3BLcyqnjrQ,433
-ramifice/commons/general.py,sha256=yi52I9t8R1XePZdyrPmhXJxLc_YkY72Ea7_dBvsKfXI,4984
+ramifice/commons/general.py,sha256=SmtJge18Yjz7cpc-KXo238rQl465WtTqzNnuRjHl8qs,5361
 ramifice/commons/indexes.py,sha256=hAcWKZ9MMgLbRtoQ6Af0b8r-PY0dbEYmMBl8z_d1DRo,3646
-ramifice/commons/many.py,sha256=KGt7licVJmLADvyPtH7-GbXHig-EnGFbnk7QKu3mfvQ,8214
-ramifice/commons/one.py,sha256=MwUlU9getNtwTOL6-lROdzViBsChWgMIMppCWoeAnFU,5815
-ramifice/commons/tools.py,sha256=s4CdHb9h8aqR371py0KVsBnNBJSW8-7AVjbTmuFAeeg,1793
-ramifice/commons/unit_manager.py,sha256=IkWqXu1PHHal0aGfx6zme81iXPeygxPqEWO-u_8RXoI,4356
+ramifice/commons/many.py,sha256=jkah1kO1CXWPB0xW0dbMelCFBSirRYkX9a333EcPE_M,9202
+ramifice/commons/one.py,sha256=uZsgwg_GgA1VMZDPqhRFMmCdtvcv6xsL4DWbCOwGV3w,6730
+ramifice/commons/tools.py,sha256=ectaILVYCSwNbB0VAys6nIhdsJbwuxAupNvcQfweC88,2366
+ramifice/commons/unit_manager.py,sha256=o8Ux2y95nddo762hf1YDyp07QwvQyotR5iVoG5FZaZI,4001
 ramifice/fields/__init__.py,sha256=yRfX7Tvpuh27Ggcx5u9e1RRYK7Wu59EVJYxxetmuP1w,1290
 ramifice/fields/bool_field.py,sha256=WWubSwsFJZu8b3MviDd2zXnNYOQaYw8toklFNSTVFLA,2072
 ramifice/fields/choice_float_dyn_field.py,sha256=Yrd9cNKLm0mhU-P3IojwFRLSbuxdp7f2NMGJhrRWsf8,3093
@@ -34,7 +34,7 @@ ramifice/fields/ip_field.py,sha256=tsxdwKd-MhkhnE1F2FmFg67jwh9Q-RvXECv1aG8PitE,3
 ramifice/fields/password_field.py,sha256=m3n_qJRRHCtgyBC7nDB0dYBO_82Lp1Ws48d1_jxHA8o,3216
 ramifice/fields/phone_field.py,sha256=5qZ_rR82M9cuW7Dv-D5d9jDaw7DJp9y60lRB4GEmi4w,3615
 ramifice/fields/slug_field.py,sha256=9rH1VdxYPoK60QCKHRB91bA3ZmIeIuFmf6WttzB1yTI,2685
-ramifice/fields/text_field.py,sha256=OrZJ337C9YUT7LOzIZR5xRBxL7dSb7ERddiJWQaT3zI,3797
+ramifice/fields/text_field.py,sha256=pa5J1nTBC56JDU3mDyjy1Qofv8FLFUgACkNcZB6cUGQ,4107
 ramifice/fields/url_field.py,sha256=DTy4B22juav9dzIrqKy3NzM2vuICHvDzIDbzkkyF1C0,3993
 ramifice/fields/general/__init__.py,sha256=5OE0TwPQjvpB3lBPuEwKrhjR_1ehOWxB98OJP_n32MA,20
 ramifice/fields/general/choice_group.py,sha256=TBJblwH8mB71wd1z2jcSs28H-zx3JZVBfkk4YCE1-pI,916
@@ -44,8 +44,8 @@ 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=6GD2Fe6Toz6zZjAAlcy5rPVCAGh6Yn1ltdIrFg9RF18,1057
 ramifice/models/__init__.py,sha256=h_QQ5rSJNZ-7kmx7wIFd8E8RmUS94b_x4jdwMbq8zm4,15
-ramifice/models/decorator.py,sha256=jOEn-0v0m_tM7mow45-tM-8LADUmwlG2DWZsEuC9S_w,6834
-ramifice/models/model.py,sha256=ZvgIbcuSXuAkBl_FofOZXGwWMwlqKB-PwTMyXiqK-Fo,6610
+ramifice/models/decorator.py,sha256=U1ukWWq2voEwvKonQAzihqGYVsoyPrOQ2jDXJZ-UcMc,7251
+ramifice/models/model.py,sha256=3426PGlJpb9ojc7gP80fd0cz5zsenvCyfgDaXAVk6FM,6963
 ramifice/models/pseudo.py,sha256=PhLQM4zXdaOtTSmNFzwN4twlUmdvA1D_-YOMJtaOIwM,6754
 ramifice/paladins/__init__.py,sha256=PIP3AXI2KBRXNcLJUF0d7ygJ7VLOAxlhb4HRKQ9MGYY,516
 ramifice/paladins/check.py,sha256=ennDiVAoCZIS3aKBK0eA-Vt8VJQnbIv90be5IFYraFg,7026
@@ -53,7 +53,7 @@ ramifice/paladins/delete.py,sha256=tw50E98D5eFZ7gHGnh_8ztUB1LeTeWWKZvIcQqlgbF8,3
 ramifice/paladins/password.py,sha256=w1XWh3bsncH1VTVjCLxyKI2waxMvltwcsPWW3V9Ib84,3027
 ramifice/paladins/refrash.py,sha256=fw-9x_NKGzreipBt_F9KF6FTsYm9hSzfq4ubi1FHYrQ,1065
 ramifice/paladins/save.py,sha256=EG0_v-imCQPax2pJIAXPoQcSL99g8abY2EeGJMvXBW4,3864
-ramifice/paladins/tools.py,sha256=QxxwZILyBLcAiDUN48KE99c_cHVjG-VYilEsIinRhEU,2641
+ramifice/paladins/tools.py,sha256=Xm1RhkV1GX5B6GbyGmJMBzFyDQcenBxcRjlUamIz5pA,2706
 ramifice/paladins/validation.py,sha256=gcEJXIEPu1g7Z54vl14YTs5rCmxOEYsgQH1usFfyy7k,1730
 ramifice/paladins/groups/__init__.py,sha256=hpqmWLsYAMvZHAbmMXluQSqLhkHOSTUAgLHyTM1LTYI,472
 ramifice/paladins/groups/bool_group.py,sha256=oJc9mw9KGrnK_Pj7uXixYYQAJphcXLr_xSQv3PMUlcU,792
@@ -65,7 +65,7 @@ ramifice/paladins/groups/img_group.py,sha256=RoD_QnW0F0DAzrGQmRi8jMZnWy2IomlFn6A
 ramifice/paladins/groups/num_group.py,sha256=6jT7nfIiVoQTlI2UdkcQOlHIDYjllFqSH7Nb87uJgzg,2274
 ramifice/paladins/groups/pass_group.py,sha256=YU5a-NwohEutoEx2N5JmGfg8uPiYiW0XJ8XYsOih6eA,1859
 ramifice/paladins/groups/slug_group.py,sha256=joBB5litljbv2h5JKEMzF71s_DKMWH6nzgThLiLZx2E,2307
-ramifice/paladins/groups/text_group.py,sha256=rUWNaAPkTMMlRf6A-6nQAa4HCj6NBTjPKIYaEKSOUL4,4305
+ramifice/paladins/groups/text_group.py,sha256=EiHGuiJKm-A4UrsV4DHoI7whL-LdQCIEvW6jX4YjfCo,4354
 ramifice/utils/__init__.py,sha256=xixHoOX4ja5jIUZemem1qn4k4aonv3G3Q76azQK_pkU,43
 ramifice/utils/errors.py,sha256=iuhq7fzpUmsOyeXeg2fJjta8yAuqlXLKsZVMpfUhtHE,1901
 ramifice/utils/fixtures.py,sha256=qsv9cg06lc82XaRlhI1j5vftmOQTTwOcDXCg_lnpK04,3159
@@ -73,13 +73,13 @@ ramifice/utils/globals.py,sha256=uR20um3Qg_1SG1t7WyWbpq8kQD-9Mslyr_c1yh5Hw9w,175
 ramifice/utils/migration.py,sha256=ol8ysNGBr0wuOwo00ZbbN0U8YKiiYVgyRYja0axdiHM,11059
 ramifice/utils/tools.py,sha256=sOKzwnvf6vdTNf9r6PKAdw6aB4undat2Z8tzS3M1GnQ,2733
 ramifice/utils/translations.py,sha256=GNGE0ULAA0aOY5pTxUd3MQW-nVaKvp6BeXWEcsR0s0o,4048
-ramifice/utils/unit.py,sha256=qJ2SpClsFcMRcwB_ZA-QlrB5T9OinCBiWx5KqQ9vH_A,2266
+ramifice/utils/unit.py,sha256=cFnhXt8sO0X-wiuiSU7_YzmRkpdNFcf2qxfR8YPsuiE,2861
 ramifice/utils/mixins/__init__.py,sha256=-UxYokZSlEaqoIs0aPVGtzK2CgN88mTzyhryHEtt0Yo,181
 ramifice/utils/mixins/add_valid.py,sha256=TLOObedzXNA9eCylfAVbVCqIKE5sV-P5AdIN7avj-GA,407
 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.4.11.dist-info/METADATA,sha256=wgz9BoK-X9H0JftAf608T2qd8nBKBnoC1Q4mlb8rygs,21785
-ramifice-0.4.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ramifice-0.4.11.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
-ramifice-0.4.11.dist-info/RECORD,,
+ramifice-0.5.0.dist-info/METADATA,sha256=up068qtq-ezkO2-Y5M1-oiZoHgcA9OPdc-FXFGV5jls,21964
+ramifice-0.5.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ramifice-0.5.0.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
+ramifice-0.5.0.dist-info/RECORD,,