ramifice 0.8.21__py3-none-any.whl → 0.8.25__py3-none-any.whl

ramifice/fields/general/number_group.py

@@ -1,4 +1,4 @@
-"""Ramifice - General additional parameters for number fields."""
+"""General additional parameters for number fields."""
 
 __all__ = ("NumberGroup",)
 
@@ -6,13 +6,13 @@ from abc import ABCMeta
 
 
 class NumberGroup(metaclass=ABCMeta):
-    """Ramifice - General additional parameters for number fields.
+    """General additional parameters for number fields.
 
-    Attributes:
-        placeholder -- Displays prompt text.
-        required -- Required field.
-        readonly -- Specifies that the field cannot be modified by the user.
-        unique -- The unique value of a field in a collection.
+    Args:
+        placeholder: Displays prompt text.
+        required: Required field.
+        readonly: Specifies that the field cannot be modified by the user.
+        unique: The unique value of a field in a collection.
     """
 
     def __init__(  # noqa: D107
@@ -21,7 +21,7 @@ class NumberGroup(metaclass=ABCMeta):
         required: bool = False,
         readonly: bool = False,
         unique: bool = False,
-    ):
+    ) -> None:
         self.placeholder = placeholder
         self.required = required
         self.readonly = readonly

ramifice/fields/general/text_group.py

@@ -1,4 +1,4 @@
-"""Ramifice - General additional parameters for text fields."""
+"""General additional parameters for text fields."""
 
 __all__ = ("TextGroup",)
 
@@ -6,14 +6,14 @@ from abc import ABCMeta
 
 
 class TextGroup(metaclass=ABCMeta):
-    """Ramifice - General additional parameters for text fields.
+    """General additional parameters for text fields.
 
-    Attributes:
-        input_type -- Input type for a web form field.
-        placeholder -- Displays prompt text.
-        required -- Required field.
-        readonly -- Specifies that the field cannot be modified by the user.
-        unique -- The unique value of a field in a collection.
+    Args:
+        input_type: Input type for a web form field.
+        placeholder: Displays prompt text.
+        required: Required field.
+        readonly: Specifies that the field cannot be modified by the user.
+        unique: The unique value of a field in a collection.
     """
 
     def __init__(  # noqa: D107
@@ -23,7 +23,7 @@ class TextGroup(metaclass=ABCMeta):
         required: bool = False,
         readonly: bool = False,
         unique: bool = False,
-    ):
+    ) -> None:
         self.input_type = input_type
         self.value: str | None = None
         self.placeholder = placeholder
@@ -32,7 +32,7 @@ class TextGroup(metaclass=ABCMeta):
         self.unique = unique
 
     def __len__(self) -> int:
-        """Ramifice - Return length of field `value`."""
+        """Return length of field `value`."""
         value = self.value
         if value is None:
             return 0

ramifice/fields/id_field.py

@@ -1,4 +1,4 @@
-"""Ramifice - Field of Model for enter identifier of document."""
+"""Field of Model for enter identifier of document."""
 
 __all__ = ("IDField",)
 
@@ -15,7 +15,7 @@ logger = logging.getLogger(__name__)
 
 
 class IDField(Field):
-    """Ramifice - Field of Model for enter identifier of document.
+    """Field of Model for enter identifier of document.
 
     Attributes:
         input_type -- Input type for a web form field.
@@ -37,7 +37,7 @@ class IDField(Field):
         required: bool = False,
         readonly: bool = False,
         unique: bool = False,
-    ):
+    ) -> None:
         if constants.DEBUG:
             try:
                 if not isinstance(label, str):
@@ -87,7 +87,7 @@ class IDField(Field):
         self.alerts: list[str] = []
 
     def to_dict(self) -> dict[str, Any]:
-        """Ramifice - Convert object instance to a dictionary."""
+        """Convert object instance to a dictionary."""
         json_dict: dict[str, Any] = {}
         for name, data in self.__dict__.items():
             if not callable(data):
@@ -98,12 +98,12 @@ class IDField(Field):
         return json_dict
 
     def to_json(self) -> str:
-        """Ramifice - Convert object instance to a JSON string."""
+        """Convert object instance to a JSON string."""
         return orjson.dumps(self.to_dict()).decode("utf-8")
 
     @classmethod
     def from_dict(cls, json_dict: dict[str, Any]) -> Any:
-        """Ramifice - Convert JSON string to a object instance."""
+        """Convert JSON string to a object instance."""
         obj = cls()
         for name, data in json_dict.items():
             if name == "value" and data is not None:
@@ -114,6 +114,6 @@ class IDField(Field):
 
     @classmethod
     def from_json(cls, json_str: str) -> Any:
-        """Ramifice - Convert JSON string to a object instance."""
+        """Convert JSON string to a object instance."""
         json_dict = orjson.loads(json_str)
         return cls.from_dict(json_dict)

ramifice/fields/image_field.py

@@ -1,4 +1,4 @@
-"""Ramifice - Field of Model for upload image."""
+"""Field of Model for upload image."""
 
 __all__ = ("ImageField",)
 
@@ -17,13 +17,13 @@ from ramifice.fields.general.file_group import FileGroup
 from ramifice.utils import constants
 from ramifice.utils.constants import MEDIA_ROOT, MEDIA_URL
 from ramifice.utils.errors import FileHasNoExtensionError
-from ramifice.utils.mixins.json_converter import JsonMixin
+from ramifice.utils.mixins import JsonMixin
 
 logger = logging.getLogger(__name__)
 
 
 class ImageField(Field, FileGroup, JsonMixin):
-    """Ramifice - Field of Model for upload image."""
+    """Field of Model for upload image."""
 
     def __init__(  # noqa: D107
         self,
@@ -43,7 +43,7 @@ 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,
-    ):
+    ) -> None:
         if constants.DEBUG:
             try:
                 if default is not None:
@@ -139,7 +139,7 @@ class ImageField(Field, FileGroup, JsonMixin):
         filename: str | None = None,
         is_delete: bool = False,
     ) -> None:
-        """Ramifice - Convert base64 to a image,
+        """Convert base64 to a image,
         get image information and save in the target directory.
         """  # noqa: D205
         base64_str = base64_str or None
@@ -208,7 +208,7 @@ class ImageField(Field, FileGroup, JsonMixin):
         src_path: str | None = None,
         is_delete: bool = False,
     ) -> None:
-        """Ramifice - Get image information and copy the image to the target directory."""
+        """Get image information and copy the image to the target directory."""
         src_path = src_path or None
         img_info: dict[str, str | int | bool] = {"save_as_is": False}
         img_info["is_new_img"] = True

ramifice/fields/integer_field.py

@@ -1,4 +1,4 @@
-"""Ramifice - Field of Model for enter (int) number."""
+"""Field of Model for enter (int) number."""
 
 __all__ = ("IntegerField",)
 
@@ -8,13 +8,13 @@ from typing import Literal
 from ramifice.fields.general.field import Field
 from ramifice.fields.general.number_group import NumberGroup
 from ramifice.utils import constants
-from ramifice.utils.mixins.json_converter import JsonMixin
+from ramifice.utils.mixins import JsonMixin
 
 logger = logging.getLogger(__name__)
 
 
 class IntegerField(Field, NumberGroup, JsonMixin):
-    """Ramifice - Field of Model for enter (int) number."""
+    """Field of Model for enter (int) number."""
 
     def __init__(  # noqa: D107
         self,
@@ -33,7 +33,7 @@ class IntegerField(Field, NumberGroup, JsonMixin):
         min_number: int | None = None,
         step: int = 1,
         input_type: Literal["number", "range"] = "number",
-    ):
+    ) -> None:
         if constants.DEBUG:
             try:
                 if input_type not in ["number", "range"]:

ramifice/fields/ip_field.py

@@ -1,4 +1,4 @@
-"""Ramifice - Field of Model for enter IP address."""
+"""Field of Model for enter IP address."""
 
 __all__ = ("IPField",)
 
@@ -8,13 +8,13 @@ import logging
 from ramifice.fields.general.field import Field
 from ramifice.fields.general.text_group import TextGroup
 from ramifice.utils import constants
-from ramifice.utils.mixins.json_converter import JsonMixin
+from ramifice.utils.mixins import JsonMixin
 
 logger = logging.getLogger(__name__)
 
 
 class IPField(Field, TextGroup, JsonMixin):
-    """Ramifice - Field of Model for enter IP address."""
+    """Field of Model for enter IP address."""
 
     def __init__(  # noqa: D107
         self,
@@ -29,7 +29,7 @@ class IPField(Field, TextGroup, JsonMixin):
         required: bool = False,
         readonly: bool = False,
         unique: bool = False,
-    ):
+    ) -> None:
         if constants.DEBUG:
             try:
                 if default is not None:

ramifice/fields/password_field.py

@@ -1,4 +1,4 @@
-"""Ramifice - Field of Model for enter password."""
+"""Field of Model for enter password."""
 
 __all__ = ("PasswordField",)
 
@@ -14,7 +14,7 @@ logger = logging.getLogger(__name__)
 
 
 class PasswordField(Field):
-    r"""Ramifice - Field of Model for enter password.
+    r"""Field of Model for enter password.
 
     Warning:
             Regular expression: ^[-._!"`'#%&,:;<>=@{}~$()*+/\\?[]^|a-zA-Z0-9]{8,256}$
@@ -31,7 +31,7 @@ class PasswordField(Field):
         warning: list[str] | None = None,
         placeholder: str = "",
         required: bool = False,
-    ):
+    ) -> None:
         if constants.DEBUG:
             try:
                 if not isinstance(label, str):
@@ -72,7 +72,7 @@ class PasswordField(Field):
         self.required = required
 
     def to_dict(self) -> dict[str, Any]:
-        """Ramifice - Convert object instance to a dictionary."""
+        """Convert object instance to a dictionary."""
         json_dict: dict[str, Any] = {}
         for name, data in self.__dict__.items():
             if not callable(data):
@@ -80,12 +80,12 @@ class PasswordField(Field):
         return json_dict
 
     def to_json(self) -> str:
-        """Ramifice - Convert object instance to a JSON string."""
+        """Convert object instance to a JSON string."""
         return orjson.dumps(self.to_dict()).decode("utf-8")
 
     @classmethod
     def from_dict(cls, json_dict: dict[str, Any]) -> Any:
-        """Ramifice - Convert JSON string to a object instance."""
+        """Convert JSON string to a object instance."""
         obj = cls()
         for name, data in json_dict.items():
             obj.__dict__[name] = data
@@ -93,6 +93,6 @@ class PasswordField(Field):
 
     @classmethod
     def from_json(cls, json_str: str) -> Any:
-        """Ramifice - Convert JSON string to a object instance."""
+        """Convert JSON string to a object instance."""
         json_dict = orjson.loads(json_str)
         return cls.from_dict(json_dict)

ramifice/fields/phone_field.py

@@ -1,4 +1,4 @@
-"""Ramifice - Field of Model for enter phone number."""
+"""Field of Model for enter phone number."""
 
 __all__ = ("PhoneField",)
 
@@ -9,13 +9,13 @@ import phonenumbers
 from ramifice.fields.general.field import Field
 from ramifice.fields.general.text_group import TextGroup
 from ramifice.utils import constants
-from ramifice.utils.mixins.json_converter import JsonMixin
+from ramifice.utils.mixins import JsonMixin
 
 logger = logging.getLogger(__name__)
 
 
 class PhoneField(Field, TextGroup, JsonMixin):
-    """Ramifice - Field of Model for enter phone number.
+    """Field of Model for enter phone number.
 
     WARNING: By default is used validator `phonenumbers.is_valid_number()`.
     """
@@ -33,7 +33,7 @@ class PhoneField(Field, TextGroup, JsonMixin):
         required: bool = False,
         readonly: bool = False,
         unique: bool = False,
-    ):
+    ) -> None:
         if constants.DEBUG:
             try:
                 if default is not None:

ramifice/fields/slug_field.py

@@ -1,4 +1,4 @@
-"""Ramifice - Field of Model for automatic generation of string `slug`."""
+"""Field of Model for automatic generation of string `slug`."""
 
 __all__ = ("SlugField",)
 
@@ -7,13 +7,13 @@ import logging
 from ramifice.fields.general.field import Field
 from ramifice.fields.general.text_group import TextGroup
 from ramifice.utils import constants
-from ramifice.utils.mixins.json_converter import JsonMixin
+from ramifice.utils.mixins import JsonMixin
 
 logger = logging.getLogger(__name__)
 
 
 class SlugField(Field, TextGroup, JsonMixin):
-    """Ramifice - Field of Model for automatic generation of string `slug`.
+    """Field of Model for automatic generation of string `slug`.
 
     Convenient to use for Url addresses.
     """
@@ -29,7 +29,7 @@ class SlugField(Field, TextGroup, JsonMixin):
         placeholder: str = "",
         readonly: bool = False,
         slug_sources: list[str] = ["_id"],
-    ):
+    ) -> None:
         if constants.DEBUG:
             try:
                 if not isinstance(label, str):

ramifice/fields/text_field.py

@@ -1,4 +1,4 @@
-"""Ramifice - Field of Model for enter text."""
+"""Field of Model for enter text."""
 
 __all__ = ("TextField",)
 
@@ -6,13 +6,13 @@ import logging
 
 from ramifice.fields.general.field import Field
 from ramifice.utils import constants
-from ramifice.utils.mixins.json_converter import JsonMixin
+from ramifice.utils.mixins import JsonMixin
 
 logger = logging.getLogger(__name__)
 
 
 class TextField(Field, JsonMixin):
-    """Ramifice - Field of Model for enter text."""
+    """Field of Model for enter text."""
 
     def __init__(  # noqa: D107
         self,
@@ -31,7 +31,7 @@ class TextField(Field, JsonMixin):
         maxlength: int = 256,
         # Support for several language.
         multi_language: bool = False,
-    ):
+    ) -> None:
         if constants.DEBUG:
             try:
                 if not isinstance(maxlength, int):
@@ -96,7 +96,7 @@ class TextField(Field, JsonMixin):
         self.multi_language = multi_language
 
     def __len__(self) -> int:
-        """Ramifice - Return length of field `value`."""
+        """Return length of field `value`."""
         value = self.value
         if isinstance(value, str):
             return len(value)

ramifice/fields/url_field.py

@@ -1,4 +1,4 @@
-"""Ramifice - Field of Model for enter URL address."""
+"""Field of Model for enter URL address."""
 
 __all__ = ("URLField",)
 
@@ -8,13 +8,13 @@ from urllib.parse import urlparse
 from ramifice.fields.general.field import Field
 from ramifice.fields.general.text_group import TextGroup
 from ramifice.utils import constants
-from ramifice.utils.mixins.json_converter import JsonMixin
+from ramifice.utils.mixins import JsonMixin
 
 logger = logging.getLogger(__name__)
 
 
 class URLField(Field, TextGroup, JsonMixin):
-    """Ramifice - Field of Model for enter URL address.
+    """Field of Model for enter URL address.
 
     Attributes:
         label -- Text label for a web form field.
@@ -43,7 +43,7 @@ class URLField(Field, TextGroup, JsonMixin):
         required: bool = False,
         readonly: bool = False,
         unique: bool = False,
-    ):
+    ) -> None:
         if constants.DEBUG:
             try:
                 if default is not None:

ramifice/models/__init__.py

@@ -1 +1 @@
-"""Ramifice - Models."""
+"""Models."""

ramifice/models/decorator.py

@@ -1,4 +1,4 @@
-"""Ramifice - Decorator for converting Python classes into Ramifice models."""
+"""Decorator for converting Python classes into Ramifice models."""
 
 __all__ = ("model",)
 
@@ -25,7 +25,7 @@ def model(
     is_update_doc: bool = True,
     is_delete_doc: bool = True,
 ) -> Any:
-    """Ramifice - Decorator for converting Python Classe into Ramifice Model."""
+    """Decorator for converting Python Classe into Ramifice Model."""
     try:
         if not isinstance(service_name, str):
             msg = "Parameter `service_name` - Must be `str` type!"
@@ -96,7 +96,7 @@ def model(
 
 
 def caching(cls: Any, service_name: str) -> dict[str, Any]:
-    """Ramifice - Add additional metadata to `Model.META`."""
+    """Add additional metadata to `Model.META`."""
     metadata: dict[str, Any] = {}
     model_name: str = cls.__name__
     if REGEX["model_name"].match(model_name) is None:

ramifice/models/model.py

@@ -1,4 +1,4 @@
-"""Ramifice - Converting Python classes into Ramifice Models."""
+"""Converting Python classes into Ramifice Models."""
 
 __all__ = ("Model",)
 
@@ -16,7 +16,7 @@ from ramifice.utils import translations
 
 
 class Model(metaclass=ABCMeta):
-    """Ramifice - Converting Python Class into Ramifice Model."""
+    """Converting Python Class into Ramifice Model."""
 
     META: dict[str, Any] = {}
 
@@ -50,25 +50,25 @@ class Model(metaclass=ABCMeta):
 
     @property
     def id(self) -> IDField:
-        """Ramifice - Getter for the field `_id`."""
+        """Getter for the field `_id`."""
         return self._id
 
     @abstractmethod
     def fields(self) -> None:
-        """Ramifice - Adding fields."""
+        """Adding fields."""
         pass
 
     def model_name(self) -> str:
-        """Ramifice - Get Model name - Class name."""
+        """Get Model name - Class name."""
         return self.__class__.__name__
 
     def full_model_name(self) -> str:
-        """Ramifice - Get full Model name - module_name + . + ClassName."""
+        """Get full Model name - module_name + . + ClassName."""
         cls = self.__class__
         return f"{cls.__module__}.{cls.__name__}"
 
     def inject(self) -> None:
-        """Ramifice - Injecting metadata from Model.META in params of fields."""
+        """Injecting metadata from Model.META in params of fields."""
         metadata = self.__class__.META
         if bool(metadata):
             lang = translations.CURRENT_LOCALE
@@ -92,7 +92,7 @@ class Model(metaclass=ABCMeta):
     # Complect of methods for converting Model to JSON and back.
     # --------------------------------------------------------------------------
     def to_dict(self) -> dict[str, Any]:
-        """Ramifice - Convert object instance to a dictionary."""
+        """Convert object instance to a dictionary."""
         json_dict: dict[str, Any] = {}
         for name, data in self.__dict__.items():
             if not callable(data):
@@ -100,12 +100,12 @@ class Model(metaclass=ABCMeta):
         return json_dict
 
     def to_json(self) -> str:
-        """Ramifice - Convert object instance to a JSON string."""
+        """Convert object instance to a JSON string."""
         return orjson.dumps(self.to_dict()).decode("utf-8")
 
     @classmethod
     def from_dict(cls, json_dict: dict[str, Any]) -> Any:
-        """Ramifice - Convert JSON string to a object instance."""
+        """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)
@@ -113,13 +113,13 @@ class Model(metaclass=ABCMeta):
 
     @classmethod
     def from_json(cls, json_str: str) -> Any:
-        """Ramifice - Convert JSON string to a object instance."""
+        """Convert JSON string to a object instance."""
         json_dict = orjson.loads(json_str)
         return cls.from_dict(json_dict)
 
     # --------------------------------------------------------------------------
     def to_dict_only_value(self) -> dict[str, Any]:
-        """Ramifice - Convert model.field.value (only the `value` attribute) to a dictionary."""
+        """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():
@@ -150,12 +150,12 @@ class Model(metaclass=ABCMeta):
         return json_dict
 
     def to_json_only_value(self) -> str:
-        """Ramifice - Convert model.field.value (only the `value` attribute) to a JSON string."""
+        """Convert model.field.value (only the `value` attribute) to a JSON string."""
         return orjson.dumps(self.to_dict_only_value()).decode("utf-8")
 
     @classmethod
     def from_dict_only_value(cls, json_dict: dict[str, Any]) -> Any:
-        """Ramifice - Convert JSON string to a object instance."""
+        """Convert JSON string to a object instance."""
         obj = cls()
         for name, data in obj.__dict__.items():
             if callable(data):
@@ -172,12 +172,12 @@ class Model(metaclass=ABCMeta):
 
     @classmethod
     def from_json_only_value(cls, json_str: str) -> Any:
-        """Ramifice - Convert JSON string to a object instance."""
+        """Convert JSON string to a object instance."""
         json_dict = orjson.loads(json_str)
         return cls.from_dict_only_value(json_dict)
 
     def refrash_fields_only_value(self, only_value_dict: dict[str, Any]) -> None:
-        """Ramifice - Partial or complete update a `value` of fields."""
+        """Partial or complete update a `value` of fields."""
         for name, data in self.__dict__.items():
             if callable(data):
                 continue

ramifice/paladins/__init__.py

@@ -1,4 +1,4 @@
-"""Ramifice - Paladins - Model instance methods."""
+"""Paladins - Model instance methods."""
 
 __all__ = ("QPaladinsMixin",)
 
@@ -24,7 +24,7 @@ class QPaladinsMixin(
     HooksMixin,
     IndexMixin,
 ):
-    """Ramifice - Paladins - Model instance methods."""
+    """Paladins - Model instance methods."""
 
     def __init__(self) -> None:  # noqa: D107
         super().__init__()

ramifice/paladins/add_valid.py

@@ -1,4 +1,4 @@
-"""Ramifice - AddValidMixin - Contains an abstract method for additional validation of fields."""
+"""AddValidMixin - Contains an abstract method for additional validation of fields."""
 
 __all__ = ("AddValidMixin",)
 
@@ -8,8 +8,8 @@ from xloft import NamedTuple
 
 
 class AddValidMixin(metaclass=ABCMeta):
-    """Ramifice - Contains an abstract method for additional validation of fields."""
+    """Contains an abstract method for additional validation of fields."""
 
     async def add_validation(self) -> NamedTuple:
-        """Ramifice - Additional validation of fields."""
+        """Additional validation of fields."""
         return NamedTuple()

ramifice/paladins/check.py

@@ -1,4 +1,4 @@
-"""Ramifice - Validation of Model data before saving to the database."""
+"""Validation of Model data before saving to the database."""
 
 __all__ = ("CheckMixin",)
 
@@ -40,7 +40,7 @@ class CheckMixin(
     SlugGroupMixin,
     TextGroupMixin,
 ):
-    """Ramifice - Validation of Model data before saving to the database."""
+    """Validation of Model data before saving to the database."""
 
     async def check(
         self,
@@ -48,7 +48,7 @@ class CheckMixin(
         collection: AsyncCollection | None = None,
         is_migration_process: bool = False,
     ) -> dict[str, Any]:
-        """Ramifice - Validation of Model data before saving to the database.
+        """Validation of Model data before saving to the database.
 
         It is also used to verify Models that do not migrate to the database.
         """

ramifice/paladins/delete.py

@@ -1,4 +1,4 @@
-"""Ramifice - Delete document from database."""
+"""Delete document from database."""
 
 __all__ = ("DeleteMixin",)
 
@@ -17,7 +17,7 @@ logger = logging.getLogger(__name__)
 
 
 class DeleteMixin:
-    """Ramifice - Delete document from database."""
+    """Delete document from database."""
 
     async def delete(
         self,
@@ -30,7 +30,7 @@ class DeleteMixin:
         comment: Any | None = None,
         **kwargs: dict[str, Any],
     ) -> dict[str, Any]:
-        """Ramifice - Delete document from database."""
+        """Delete document from database."""
         cls_model = self.__class__
         # Raises a panic if the Model cannot be removed.
         if not cls_model.META["is_delete_doc"]:

ramifice/paladins/groups/__init__.py

@@ -1,4 +1,4 @@
-"""Ramifice - Groups - Model instance methods for specific processing of fields."""
+"""Groups - Model instance methods for specific processing of fields."""
 
 __all__ = (
     "BoolGroupMixin",