ramifice 0.8.10__py3-none-any.whl → 0.8.12__py3-none-any.whl

ramifice/paladins/groups/id_group.py

@@ -1,4 +1,4 @@
-"""Group for checking id fields.
+"""Ramifice - Group for checking id fields.
 
 Supported fields:
     IDField
@@ -15,14 +15,14 @@ from ramifice.utils import translations
 
 
 class IDGroupMixin:
-    """Group for checking id fields.
+    """Ramifice - Group for checking id fields.
 
     Supported fields:
         IDField
     """
 
     def id_group(self, params: dict[str, Any]) -> None:
-        """Checking id fields."""
+        """Ramifice - Checking id fields."""
         field = params["field_data"]
         # Get current value.
         value = field.value

ramifice/paladins/groups/img_group.py

@@ -1,4 +1,4 @@
-"""Group for checking image fields.
+"""Ramifice - Group for checking image fields.
 
 Supported fields: ImageField
 """
@@ -16,13 +16,13 @@ from ramifice.utils.tools import to_human_size
 
 
 class ImgGroupMixin:
-    """Group for checking image fields.
+    """Ramifice - Group for checking image fields.
 
     Supported fields: ImageField
     """
 
     async def img_group(self, params: dict[str, Any]) -> None:
-        """Checking image fields."""
+        """Ramifice - Checking image fields."""
         field = params["field_data"]
         value = field.value or None
 
@@ -92,38 +92,39 @@ class ImgGroupMixin:
                                 continue
                             size = max_size, max_size
                             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}"
-                                await 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}"
-                                await 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}"
-                                await 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}"
-                                await to_thread(
-                                    img.save,
-                                    fp=value["path_xs"],
-                                    format=ext_upper,
-                                )
+                            match size_name:
+                                case "lg":
+                                    value["path_lg"] = f"{imgs_dir_path}/lg{extension}"
+                                    value["url_lg"] = f"{imgs_dir_url}/lg{extension}"
+                                    await to_thread(
+                                        img.save,
+                                        fp=value["path_lg"],
+                                        format=ext_upper,
+                                    )
+                                case "md":
+                                    value["path_md"] = f"{imgs_dir_path}/md{extension}"
+                                    value["url_md"] = f"{imgs_dir_url}/md{extension}"
+                                    await to_thread(
+                                        img.save,
+                                        fp=value["path_md"],
+                                        format=ext_upper,
+                                    )
+                                case "sm":
+                                    value["path_sm"] = f"{imgs_dir_path}/sm{extension}"
+                                    value["url_sm"] = f"{imgs_dir_url}/sm{extension}"
+                                    await to_thread(
+                                        img.save,
+                                        fp=value["path_sm"],
+                                        format=ext_upper,
+                                    )
+                                case "xs":
+                                    value["path_xs"] = f"{imgs_dir_path}/xs{extension}"
+                                    value["url_xs"] = f"{imgs_dir_url}/xs{extension}"
+                                    await 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/num_group.py

@@ -1,4 +1,4 @@
-"""Group for checking integer fields.
+"""Ramifice - Group for checking integer fields.
 
 Supported fields:
     IntegerField | FloatField
@@ -17,14 +17,14 @@ from ramifice.utils import translations
 
 
 class NumGroupMixin:
-    """Group for checking integer fields.
+    """Ramifice - Group for checking integer fields.
 
     Supported fields:
         IntegerField | FloatField
     """
 
     async def num_group(self, params: dict[str, Any]) -> None:
-        """Checking number fields."""
+        """Ramifice - Checking number fields."""
         field = params["field_data"]
         field_name = field.name
         # Get current value.

ramifice/paladins/groups/pass_group.py

@@ -1,4 +1,4 @@
-"""Group for checking password fields.
+"""Ramifice - Group for checking password fields.
 
 Supported fields: PasswordField
 """
@@ -15,13 +15,13 @@ from ramifice.utils.tools import is_password
 
 
 class PassGroupMixin:
-    """Group for checking password fields.
+    """Ramifice - Group for checking password fields.
 
     Supported fields: PasswordField
     """
 
     def pass_group(self, params: dict[str, Any]) -> None:
-        """Checking password fields."""
+        """Ramifice - Checking password fields."""
         field = params["field_data"]
         # When updating the document, skip the verification.
         if params["is_update"]:

ramifice/paladins/groups/slug_group.py

@@ -1,4 +1,4 @@
-"""Group for checking slug fields.
+"""Ramifice - Group for checking slug fields.
 
 Supported fields:
     SlugField
@@ -6,6 +6,7 @@ Supported fields:
 
 __all__ = ("SlugGroupMixin",)
 
+import logging
 from typing import Any
 
 from slugify import slugify
@@ -13,16 +14,18 @@ from slugify import slugify
 from ramifice.paladins.tools import check_uniqueness
 from ramifice.utils.errors import PanicError
 
+logger = logging.getLogger(__name__)
+
 
 class SlugGroupMixin:
-    """Group for checking slug fields.
+    """Ramifice - Group for checking slug fields.
 
     Supported fields:
         SlugField
     """
 
     async def slug_group(self, params: dict[str, Any]) -> None:
-        """Checking slug fields."""
+        """Ramifice - Checking slug fields."""
         if not params["is_save"]:
             return
         #
@@ -48,6 +51,7 @@ class SlugGroupMixin:
                         + "This field is specified in slug_sources. "
                         + "This field should be mandatory or assign a default value."
                     )
+                    logger.error(err_msg)
                     raise PanicError(err_msg)
         # Insert result.
         if params["is_save"]:
@@ -65,6 +69,7 @@ class SlugGroupMixin:
                     + f"Parameter: `slug_sources` => "
                     + "At least one field should be unique!"
                 )
+                logger.error(err_msg)
                 raise PanicError(err_msg)
             # Add value to map.
             params["result_map"][field_name] = value

ramifice/paladins/groups/text_group.py

@@ -1,4 +1,4 @@
-"""Group for checking text fields.
+"""Ramifice - Group for checking text fields.
 
 Supported fields:
     URLField | TextField | PhoneField
@@ -30,7 +30,7 @@ from ramifice.utils.tools import (
 
 
 class TextGroupMixin:
-    """Group for checking text fields.
+    """Ramifice - Group for checking text fields.
 
     Supported fields:
         URLField | TextField | PhoneField
@@ -38,7 +38,7 @@ class TextGroupMixin:
     """
 
     async def text_group(self, params: dict[str, Any]) -> None:
-        """Checking text fields."""
+        """Ramifice - Checking text fields."""
         field = params["field_data"]
         field_name = field.name
         field_type: str = field.field_type

ramifice/paladins/password.py

@@ -1,7 +1,8 @@
-"""Verification, replacement and recoverang of password."""
+"""Ramifice - Verification, replacement and recoverang of password."""
 
 __all__ = ("PasswordMixin",)
 
+import logging
 from typing import Any
 
 from argon2 import PasswordHasher
@@ -10,16 +11,18 @@ from pymongo.asynchronous.collection import AsyncCollection
 from ramifice.utils import constants
 from ramifice.utils.errors import OldPassNotMatchError, PanicError
 
+logger = logging.getLogger(__name__)
+
 
 class PasswordMixin:
-    """Verification, replacement and recoverang of password."""
+    """Ramifice - Verification, replacement and recoverang of password."""
 
     async def verify_password(
         self,
         password: str,
         field_name: str = "password",
     ) -> bool:
-        """For password verification."""
+        """Ramifice - For password verification."""
         cls_model = self.__class__
         # Get documet ID.
         doc_id = self._id.value
@@ -29,6 +32,7 @@ class PasswordMixin:
                 + "Method: `verify_password` => "
                 + "Cannot get document ID - ID field is empty."
             )
+            logger.error(msg)
             raise PanicError(msg)
         # Get collection for current Model.
         collection: AsyncCollection = constants.MONGO_DATABASE[cls_model.META["collection_name"]]
@@ -40,6 +44,7 @@ class PasswordMixin:
                 + "Method: `verify_password` => "
                 + f"There is no document with ID `{self._id.value}` in the database."
             )
+            logger.error(msg)
             raise PanicError(msg)
         # Get password hash.
         hash: str | None = mongo_doc.get(field_name)
@@ -49,6 +54,7 @@ class PasswordMixin:
                 + "Method: `verify_password` => "
                 + f"The model does not have a field `{field_name}`."
             )
+            logger.error(msg)
             raise PanicError(msg)
         # Password verification.
         is_valid: bool = False
@@ -70,9 +76,10 @@ class PasswordMixin:
         new_password: str,
         field_name: str = "password",
     ) -> None:
-        """For replace or recover password."""
+        """Ramifice - For replace or recover password."""
         cls_model = self.__class__
         if not await self.verify_password(old_password, field_name):
+            logger.warning("Old password does not match!")
             raise OldPassNotMatchError()
         # Get documet ID.
         doc_id = self._id.value

ramifice/paladins/refrash.py

@@ -1,7 +1,8 @@
-"""Update Model instance from database."""
+"""Ramifice - Update Model instance from database."""
 
 __all__ = ("RefrashMixin",)
 
+import logging
 from typing import Any
 
 from pymongo.asynchronous.collection import AsyncCollection
@@ -10,12 +11,14 @@ from ramifice.paladins.tools import refresh_from_mongo_doc
 from ramifice.utils import constants
 from ramifice.utils.errors import PanicError
 
+logger = logging.getLogger(__name__)
+
 
 class RefrashMixin:
-    """Update Model instance from database."""
+    """Ramifice - Update Model instance from database."""
 
     async def refrash_from_db(self) -> None:
-        """Update Model instance from database."""
+        """Ramifice - Update Model instance from database."""
         cls_model = self.__class__
         # Get collection.
         collection: AsyncCollection = constants.MONGO_DATABASE[cls_model.META["collection_name"]]
@@ -26,6 +29,7 @@ class RefrashMixin:
                 + "Method: `refrash_from_db` => "
                 + f"A document with an identifier `{self._id.value}` is not exists in the database!"
             )
+            logger.error(msg)
             raise PanicError(msg)
         self.inject()
         refresh_from_mongo_doc(self, mongo_doc)

ramifice/paladins/save.py

@@ -1,7 +1,8 @@
-"""Create or update document in database."""
+"""Ramifice - Create or update document in database."""
 
 __all__ = ("SaveMixin",)
 
+import logging
 from datetime import datetime
 from typing import Any
 
@@ -11,12 +12,14 @@ from ramifice.paladins.tools import ignored_fields_to_none, refresh_from_mongo_d
 from ramifice.utils import constants
 from ramifice.utils.errors import PanicError
 
+logger = logging.getLogger(__name__)
+
 
 class SaveMixin:
-    """Create or update document in database."""
+    """Ramifice - Create or update document in database."""
 
     async def save(self) -> bool:
-        """Create or update document in database.
+        """Ramifice - Create or update document in database.
 
         This method pre-uses the `check` method.
         """
@@ -60,6 +63,7 @@ class SaveMixin:
                     + "Method: `save` => "
                     + "Geted value is None - it is impossible to refresh the current Model."
                 )
+                logger.error(msg)
                 raise PanicError(msg)
             refresh_from_mongo_doc(self, mongo_doc)
         else:
@@ -81,6 +85,7 @@ class SaveMixin:
                     + "Method: `save` => "
                     + "Geted value is None - it is impossible to refresh the current Model."
                 )
+                logger.error(msg)
                 raise PanicError(msg)
             if mongo_doc is not None:
                 refresh_from_mongo_doc(self, mongo_doc)
@@ -90,6 +95,7 @@ class SaveMixin:
                     + "Method: `save` => "
                     + "The document was not created."
                 )
+                logger.error(msg)
                 raise PanicError(msg)
         #
         # If everything is completed successfully.

ramifice/paladins/tools.py

@@ -1,4 +1,4 @@
-"""Tool of Paladins - A set of auxiliary methods."""
+"""Ramifice - Tool of Paladins - A set of auxiliary methods."""
 
 __all__ = (
     "ignored_fields_to_none",
@@ -8,20 +8,23 @@ __all__ = (
     "check_uniqueness",
 )
 
+import logging
 from typing import Any
 
 from ramifice.utils import errors, translations
 
+logger = logging.getLogger(__name__)
+
 
 def ignored_fields_to_none(inst_model: Any) -> None:
-    """Reset the values of ignored fields to None."""
+    """Ramifice - Reset the values of ignored fields to None."""
     for _, field_data in inst_model.__dict__.items():
         if not callable(field_data) and field_data.ignored:
             field_data.value = None
 
 
 def refresh_from_mongo_doc(inst_model: Any, mongo_doc: dict[str, Any]) -> None:
-    """Update object instance from Mongo document."""
+    """Ramifice - Update object instance from Mongo document."""
     lang: str = translations.CURRENT_LOCALE
     model_dict = inst_model.__dict__
     for name, data in mongo_doc.items():
@@ -35,17 +38,18 @@ def refresh_from_mongo_doc(inst_model: Any, mongo_doc: dict[str, Any]) -> None:
 
 
 def panic_type_error(value_type: str, params: dict[str, Any]) -> None:
-    """Unacceptable type of value."""
+    """Ramifice - Unacceptable type of value."""
     msg = (
         f"Model: `{params['full_model_name']}` > "
         + f"Field: `{params['field_data'].name}` > "
         + f"Parameter: `value` => Must be `{value_type}` type!"
     )
+    logger.error(msg)
     raise errors.PanicError(msg)
 
 
 def accumulate_error(err_msg: str, params: dict[str, Any]) -> None:
-    """For accumulating errors to ModelName.field_name.errors ."""
+    """Ramifice - Accumulating errors to ModelName.field_name.errors ."""
     if not params["field_data"].hide:
         params["field_data"].errors.append(err_msg)
         if not params["is_error_symptom"]:
@@ -56,6 +60,7 @@ def accumulate_error(err_msg: str, params: dict[str, Any]) -> None:
             + f"Field: `{params['field_data'].name}`"
             + f" => {err_msg}"
         )
+        logger.error(msg)
         raise errors.PanicError(msg)
 
 
@@ -65,7 +70,7 @@ async def check_uniqueness(
     field_name: str | None = None,
     is_multi_language: bool = False,
 ) -> bool:
-    """Check the uniqueness of the value in the collection."""
+    """Ramifice - Checking the uniqueness of the value in the collection."""
     q_filter = None
     if is_multi_language:
         lang_filter = [{f"{field_name}.{lang}": value} for lang in translations.LANGUAGES]

ramifice/paladins/validation.py

@@ -1,4 +1,4 @@
-"""Validation of Model and printing errors to console."""
+"""Ramifice - Validation of Model and printing errors to console."""
 
 __all__ = ("ValidationMixin",)
 
@@ -8,10 +8,10 @@ from termcolor import colored
 
 
 class ValidationMixin:
-    """Validation of Model and printing errors to console."""
+    """Ramifice - Validation of Model and printing errors to console."""
 
     async def is_valid(self) -> bool:
-        """Check data validity.
+        """Ramifice - Check data validity.
 
         The main use is to check data from web forms.
         It is also used to verify Models that do not migrate to the database.
@@ -20,7 +20,7 @@ class ValidationMixin:
         return result_check["is_valid"]
 
     def print_err(self) -> None:
-        """Printing errors to console.
+        """Ramifice - Printing errors to console.
 
         Convenient to use during development.
         """

ramifice/utils/__init__.py

@@ -1 +1 @@
-"""A set of Ramifice useful utilities."""
+"""Ramifice - A set of Ramifice useful utilities."""

ramifice/utils/constants.py

@@ -1,4 +1,4 @@
-"""Global variables.
+"""Ramifice - Global variables.
 
 List of variables:
 

ramifice/utils/errors.py

@@ -1,15 +1,15 @@
-"""Custom Exceptions for Ramifice."""
+"""Ramifice - Custom Exceptions for Ramifice."""
 
 
 class RamificeException(Exception):
-    """Root Exception for Ramifice."""
+    """Ramifice - Root Exception for Ramifice."""
 
     def __init__(self, *args, **kwargs) -> None:  # type: ignore[no-untyped-def] # noqa: D107
         super().__init__(*args, **kwargs)
 
 
 class FileHasNoExtensionError(RamificeException):
-    """Exception raised if the file has no extension.
+    """Ramifice - Exception raised if the file has no extension.
 
     Attributes:
         message -- explanation of the error
@@ -21,7 +21,7 @@ class FileHasNoExtensionError(RamificeException):
 
 
 class DoesNotMatchRegexError(RamificeException):
-    """Exception raised if does not match the regular expression.
+    """Ramifice - Exception raised if does not match the regular expression.
 
     Attributes:
         regex_str -- regular expression in string representation
@@ -33,7 +33,7 @@ class DoesNotMatchRegexError(RamificeException):
 
 
 class NoModelsForMigrationError(RamificeException):
-    """Exception raised if no Models for migration."""
+    """Ramifice - Exception raised if no Models for migration."""
 
     def __init__(self):  # type: ignore[no-untyped-def] # noqa: D107
         self.message = "No Models for Migration!"
@@ -41,7 +41,7 @@ class NoModelsForMigrationError(RamificeException):
 
 
 class PanicError(RamificeException):
-    """Exception raised for cases of which should not be.
+    """Ramifice - Exception raised for cases of which should not be.
 
     Attributes:
         message -- explanation of the error
@@ -53,7 +53,7 @@ class PanicError(RamificeException):
 
 
 class OldPassNotMatchError(RamificeException):
-    """Exception raised if when updating the password,
+    """Ramifice - Exception raised if when updating the password,
     the old password does not match.
     """  # noqa: D205
 

ramifice/utils/fixtures.py

@@ -1,10 +1,11 @@
-"""Fixtures - To populate the database with pre-created data.
+"""Ramifice - Fixtures - To populate the database with pre-created data.
 
 Runs automatically during Model migration.
 """
 
 __all__ = ("apply_fixture",)
 
+import logging
 from datetime import datetime
 from typing import Any
 
@@ -15,13 +16,15 @@ from termcolor import colored
 
 from ramifice.utils.errors import PanicError
 
+logger = logging.getLogger(__name__)
+
 
 async def apply_fixture(
     fixture_name: str,
     cls_model: Any,
     collection: AsyncCollection,
 ) -> None:
-    """Apply fixture for current Model.
+    """Ramifice - Apply fixture for current Model.
 
     Runs automatically during Model migration.
     """
@@ -37,6 +40,7 @@ async def apply_fixture(
             + f"META param: `fixture_name` ({fixture_name}) => "
             + "It seems that fixture is empty or it has incorrect contents!"
         )
+        logger.error(msg)
         raise PanicError(msg)
 
     if data_yaml is not None:
@@ -71,6 +75,7 @@ async def apply_fixture(
                 print(colored(fixture_path, "blue", attrs=["bold"]))
                 inst_model.print_err()
                 msg = f"Fixture `{fixture_name}` failed."
+                logger.error(msg)
                 raise PanicError(msg)
             # Get data for document.
             checked_data: dict[str, Any] = result_check["data"]