ramifice 0.3.14__py3-none-any.whl → 0.3.16__py3-none-any.whl

ramifice/add_valid.py

@@ -7,6 +7,6 @@ class AddValidMixin(metaclass=ABCMeta):
     """Additional validation of fields."""
 
     async def add_validation(self) -> dict[str, str]:
-        """For additional validation of fields."""
+        """Additional validation of fields."""
         error_map: dict[str, str] = {}
         return error_map

ramifice/commons/one.py

@@ -35,7 +35,7 @@ class OneMixin:
         *args: tuple,
         **kwargs: dict[str, Any],
     ) -> dict[str, Any] | None:
-        """Find a single document."""
+        """Find a single document and converting to raw document."""
         # Get collection for current model.
         collection: AsyncCollection = store.MONGO_DATABASE[cls.META["collection_name"]]  # type: ignore[index]
         # Get document.

ramifice/commons/tools.py

@@ -1,4 +1,4 @@
-"""Tools - A set of additional auxiliary methods for Commons."""
+"""Tool of Commons - A set of auxiliary methods."""
 
 from typing import Any
 
@@ -8,7 +8,7 @@ from .. import translations
 
 
 class ToolMixin:
-    """A set of additional auxiliary methods for Commons."""
+    """Tool of Commons - A set of auxiliary methods."""
 
     @classmethod
     def password_to_none(cls: Any, mongo_doc: dict[str, Any]) -> dict[str, Any]:

ramifice/decorators.py

@@ -11,7 +11,7 @@ from .fields import DateTimeField, IDField  # type: ignore[attr-defined]
 from .hooks import HooksMixin
 from .indexing import IndexMixin
 from .model import Model
-from .paladins import CheckMixin, QPaladinsMixin, ToolMixin  # type: ignore[attr-defined]
+from .paladins import CheckMixin, QPaladinsMixin, ValidationMixin  # type: ignore[attr-defined]
 from .store import REGEX
 
 
@@ -26,6 +26,20 @@ def model(
     is_delete_doc: bool = True,
 ) -> Any:
     """Decorator for converting into a Model."""
+    if not isinstance(service_name, str):
+        raise AssertionError("Parameter `service_name` - Must be `str` type!")
+    if not isinstance(fixture_name, (str, type(None))):
+        raise AssertionError("Parameter `fixture_name` - Must be `str | None` type!")
+    if not isinstance(db_query_docs_limit, int):
+        raise AssertionError("Parameter `db_query_docs_limit` - Must be `int` type!")
+    if not isinstance(is_migrate_model, bool):
+        raise AssertionError("Parameter `is_migrate_model` - Must be `bool` type!")
+    if not isinstance(is_create_doc, bool):
+        raise AssertionError("Parameter `is_create_doc` - Must be `bool` type!")
+    if not isinstance(is_update_doc, bool):
+        raise AssertionError("Parameter `is_update_doc` - Must be `bool` type!")
+    if not isinstance(is_delete_doc, bool):
+        raise AssertionError("Parameter `is_delete_doc` - Must be `bool` type!")
 
     def decorator(cls: Any) -> Any:
         if REGEX["service_name"].match(service_name) is None:
@@ -67,7 +81,16 @@ def model(
                 attrs,
             )
         else:
-            return type(cls.__name__, (Model, ToolMixin, CheckMixin, AddValidMixin), attrs)
+            return type(
+                cls.__name__,
+                (
+                    Model,
+                    ValidationMixin,
+                    CheckMixin,
+                    AddValidMixin,
+                ),
+                attrs,
+            )
 
     return decorator
 

ramifice/model.py

@@ -48,7 +48,7 @@ class Model(metaclass=ABCMeta):
 
     @abstractmethod
     def fields(self) -> None:
-        """For add fields."""
+        """For adding fields."""
         pass
 
     def model_name(self) -> str:

ramifice/paladins/__init__.py

@@ -5,16 +5,16 @@ from .delete import DeleteMixin
 from .password import PasswordMixin
 from .refrash import RefrashMixin
 from .save import SaveMixin
-from .tools import ToolMixin
+from .validation import ValidationMixin
 
 
 class QPaladinsMixin(
-    ToolMixin,
     CheckMixin,
     SaveMixin,
     PasswordMixin,
     DeleteMixin,
     RefrashMixin,
+    ValidationMixin,
 ):
     """Paladins - Model instance methods."""
 

ramifice/paladins/check.py

@@ -40,7 +40,10 @@ class CheckMixin(
     async def check(
         self, is_save: bool = False, collection: AsyncCollection | None = None
     ) -> dict[str, Any]:
-        """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.
+        """
         cls_model = self.__class__
         if not cls_model.META["is_migrate_model"] and is_save:  # type: ignore[attr-defined]
             msg = (
@@ -74,6 +77,7 @@ class CheckMixin(
             "result_map": result_map,  # Data to save or update to the database.
             "collection": collection,
             "field_data": None,
+            "full_model_name": cls_model.META["full_model_name"],  # type: ignore[attr-defined]
         }
         #
         # Run checking fields.
@@ -107,7 +111,7 @@ class CheckMixin(
                 elif group == "id":
                     self.id_group(params)
                 elif group == "slug":
-                    self.slug_group(params)
+                    await self.slug_group(params)
                 elif group == "pass":
                     self.pass_group(params)
 

ramifice/paladins/delete.py

@@ -15,7 +15,7 @@ class DeleteMixin:
 
     async def delete(
         self,
-        delete_files: bool = True,
+        remove_files: bool = True,
         projection: Any | None = None,
         sort: Any | None = None,
         hint: Any | None = None,
@@ -67,12 +67,12 @@ class DeleteMixin:
                 + "The document was not deleted, the document is absent in the database."
             )
             raise PanicError(msg)
-        # Delete orphaned files.
+        # Delete orphaned files and add None to field.value.
         file_data: dict[str, Any] | None = None
         for field_name, field_data in self.__dict__.items():
             if callable(field_data):
                 continue
-            if delete_files and not field_data.ignored:
+            if remove_files and not field_data.ignored:
                 group = field_data.group
                 if group == "file":
                     file_data = mongo_doc[field_name]

ramifice/paladins/groups/bool_group.py

@@ -6,6 +6,8 @@ Supported fields:
 
 from typing import Any
 
+from ..tools import panic_type_error
+
 
 class BoolGroupMixin:
     """Group for checking boolean fields.
@@ -21,7 +23,7 @@ class BoolGroupMixin:
         value = field.value
 
         if not isinstance(value, (bool, type(None))):
-            self.panic_type_error("bool", params)  # type: ignore[attr-defined]
+            panic_type_error(params["full_model_name"], "bool | None", params)
 
         if not params["is_update"] and value is None:
             value = field.default

ramifice/paladins/groups/choice_group.py

@@ -10,6 +10,7 @@ Supported fields:
 from typing import Any
 
 from ... import translations
+from ..tools import accumulate_error
 
 
 class ChoiceGroupMixin:
@@ -31,14 +32,14 @@ class ChoiceGroupMixin:
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                accumulate_error(params["full_model_name"], err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
         # Does the field value match the possible options in choices.
         if not field.has_value():
             err_msg = translations._("Your choice does not match the options offered !")
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         # Insert result.
         if params["is_save"]:
             params["result_map"][field.name] = value

ramifice/paladins/groups/date_group.py

@@ -10,6 +10,7 @@ from typing import Any
 from babel.dates import format_date, format_datetime
 
 from ... import translations
+from ..tools import accumulate_error, panic_type_error
 
 
 class DateGroupMixin:
@@ -26,12 +27,12 @@ class DateGroupMixin:
         value = field.value or field.default or None
 
         if not isinstance(value, (datetime, type(None))):
-            self.panic_type_error("datetime", params)  # type: ignore[attr-defined]
+            panic_type_error(params["full_model_name"], "datetime | None", params)
 
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                accumulate_error(params["full_model_name"], err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
@@ -69,7 +70,7 @@ class DateGroupMixin:
                 "The date %s must not be greater than max=%s !" % value_str,
                 max_date_str,
             )
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         # Validation the `min_date` field attribute.
         min_date = field.min_date
         if min_date is not None and value < min_date:
@@ -102,7 +103,7 @@ class DateGroupMixin:
             err_msg = translations._(
                 "The date %s must not be less than min=%s !" % value_str, min_date_str
             )
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         # Insert result.
         if params["is_save"]:
             params["result_map"][field.name] = value

ramifice/paladins/groups/file_group.py

@@ -7,7 +7,8 @@ import os
 from typing import Any
 
 from ... import translations
-from ...tools import to_human_size
+from ...utilities import to_human_size
+from ..tools import accumulate_error, panic_type_error
 
 
 class FileGroupMixin:
@@ -22,7 +23,7 @@ class FileGroupMixin:
         value = field.value or None
 
         if not isinstance(value, (dict, type(None))):
-            self.panic_type_error("dict", params)  # type: ignore[attr-defined]
+            panic_type_error(params["full_model_name"], "dict | None", params)
 
         if not params["is_update"]:
             if value is None:
@@ -36,7 +37,7 @@ class FileGroupMixin:
                 if value is None:
                     if field.required:
                         err_msg = translations._("Required field !")
-                        self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                        accumulate_error(params["full_model_name"], err_msg, params)
                     if params["is_save"]:
                         params["result_map"][field.name] = None
                     return
@@ -57,14 +58,14 @@ class FileGroupMixin:
                             params["result_map"][field.name] = None
                     else:
                         err_msg = translations._("Required field !")
-                        self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                        accumulate_error(params["full_model_name"], err_msg, params)
                     return
             # Accumulate an error if the file size exceeds the maximum value.
             if value["size"] > field.max_size:
                 err_msg = translations._(
                     "File size exceeds the maximum value %s !" % to_human_size(field.max_size)
                 )
-                self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                accumulate_error(params["full_model_name"], err_msg, params)
                 return
             # Return if there is no need to save.
             if not params["is_save"]:

ramifice/paladins/groups/id_group.py

@@ -9,6 +9,7 @@ from typing import Any
 from bson.objectid import ObjectId
 
 from ... import translations
+from ..tools import accumulate_error, panic_type_error
 
 
 class IDGroupMixin:
@@ -25,19 +26,19 @@ class IDGroupMixin:
         value = field.value or None
 
         if not isinstance(value, (ObjectId, type(None))):
-            self.panic_type_error("ObjectId", params)  # type: ignore[attr-defined]
+            panic_type_error(params["full_model_name"], "ObjectId | None", params)
 
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                accumulate_error(params["full_model_name"], err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
         # Validation of the MongoDB identifier in a string form.
         if not ObjectId.is_valid(value):
             err_msg = translations._("Invalid document ID !")
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         # Insert result.
         if params["is_save"]:
             params["result_map"][field.name] = value

ramifice/paladins/groups/img_group.py

@@ -9,7 +9,8 @@ from typing import Any
 from PIL import Image
 
 from ... import translations
-from ...tools import to_human_size
+from ...utilities import to_human_size
+from ..tools import accumulate_error, panic_type_error
 
 
 class ImgGroupMixin:
@@ -24,7 +25,7 @@ class ImgGroupMixin:
         value = field.value or None
 
         if not isinstance(value, (dict, type(None))):
-            self.panic_type_error("dict", params)  # type: ignore[attr-defined]
+            panic_type_error(params["full_model_name"], "dict | None", params)
 
         if not params["is_update"]:
             if value is None:
@@ -38,7 +39,7 @@ class ImgGroupMixin:
                 if value is None:
                     if field.required:
                         err_msg = translations._("Required field !")
-                        self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                        accumulate_error(params["full_model_name"], err_msg, params)
                     if params["is_save"]:
                         params["result_map"][field.name] = None
                     return
@@ -59,14 +60,14 @@ class ImgGroupMixin:
                             params["result_map"][field.name] = None
                     else:
                         err_msg = translations._("Required field !")
-                        self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                        accumulate_error(params["full_model_name"], err_msg, params)
                     return
             # Accumulate an error if the file size exceeds the maximum value.
             if value["size"] > field.max_size:
                 err_msg = translations._(
                     "Image size exceeds the maximum value %s !" % to_human_size(field.max_size)
                 )
-                self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                accumulate_error(params["full_model_name"], err_msg, params)
                 return
             # Return if there is no need to save.
             if not params["is_save"]:

ramifice/paladins/groups/num_group.py

@@ -7,6 +7,7 @@ Supported fields:
 from typing import Any
 
 from ... import translations
+from ..tools import accumulate_error, check_uniqueness, panic_type_error
 
 
 class NumGroupMixin:
@@ -26,15 +27,15 @@ class NumGroupMixin:
 
         if "Float" in field.field_type:
             if not isinstance(value, (float, type(None))):
-                self.panic_type_error("float", params)  # type: ignore[attr-defined]
+                panic_type_error(params["full_model_name"], "float | None", params)
         else:
             if not isinstance(value, (int, type(None))):
-                self.panic_type_error("int", params)  # type: ignore[attr-defined]
+                panic_type_error(params["full_model_name"], "int | None", params)
 
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                accumulate_error(params["full_model_name"], err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
@@ -44,18 +45,22 @@ class NumGroupMixin:
             err_msg = translations._(
                 "The value %d must not be greater than max=%d !" % value, max_number
             )
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         # Validation the `min_number` field attribute.
         min_number = field.min_number
         if min_number is not None and value < min_number:
             err_msg = translations._(
                 "The value %d must not be less than min=%d !" % value, min_number
             )
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         # Validation the `unique` field attribute.
-        if field.unique and not await self.check_uniqueness(value, params):  # type: ignore[attr-defined]
+        if field.unique and not await check_uniqueness(
+            self.__class__.META["is_migrate_model"],  # type: ignore[attr-defined]
+            value,
+            params,
+        ):
             err_msg = translations._("Is not unique !")
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         # Insert result.
         if params["is_save"]:
             params["result_map"][field.name] = value

ramifice/paladins/groups/pass_group.py

@@ -8,6 +8,7 @@ from typing import Any
 from argon2 import PasswordHasher
 
 from ... import translations
+from ..tools import accumulate_error, panic_type_error
 
 
 class PassGroupMixin:
@@ -27,24 +28,24 @@ class PassGroupMixin:
         value = field.value or None
 
         if not isinstance(value, (str, type(None))):
-            self.panic_type_error("str", params)  # type: ignore[attr-defined]
+            panic_type_error(params["full_model_name"], "str | None", params)
 
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                accumulate_error(params["full_model_name"], err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
         # Validation Passwor.
         if not field.is_valid(value):
             err_msg = translations._("Invalid Password !")
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
             chars = "a-z A-Z 0-9 - . _ ! \" ` ' # % & , : ; < > = @ { } ~ $ ( ) * + / \\ ? [ ] ^ |"
             err_msg = translations._("Valid characters: %s" % chars)
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
             err_msg = translations._("Number of characters: from 8 to 256")
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         # Insert result.
         if params["is_save"]:
             ph = PasswordHasher()

ramifice/paladins/groups/slug_group.py

@@ -1,6 +1,7 @@
 """Group for checking slug fields.
 
-Supported fields: SlugField
+Supported fields:
+    SlugField
 """
 
 from typing import Any
@@ -8,15 +9,17 @@ from typing import Any
 from slugify import slugify
 
 from ...errors import PanicError
+from ..tools import check_uniqueness
 
 
 class SlugGroupMixin:
     """Group for checking slug fields.
 
-    Supported fields: SlugField
+    Supported fields:
+        SlugField
     """
 
-    def slug_group(self, params: dict[str, Any]) -> None:
+    async def slug_group(self, params: dict[str, Any]) -> None:
         """Checking slug fields."""
         if not params["is_save"]:
             return
@@ -36,7 +39,7 @@ class SlugGroupMixin:
                     raw_str_list.append(value if field_name != "_id" else str(value))
                 else:
                     err_msg = (
-                        f"Model: `{self.full_model_name()}` > "  # type: ignore[attr-defined]
+                        f"Model: `{params['full_model_name']}` > "
                         + f"Field: `{field.name}` => "
                         + f"{field_name} - "
                         + "This field is specified in slug_sources. "
@@ -45,5 +48,20 @@ class SlugGroupMixin:
                     raise PanicError(err_msg)
         # Insert result.
         if params["is_save"]:
-            value = "-".join(raw_str_list)
-            params["result_map"][field.name] = slugify(value)
+            # Convert to slug.
+            value = slugify("-".join(raw_str_list))
+            # Validation of uniqueness of the value.
+            if not await check_uniqueness(
+                self.__class__.META["is_migrate_model"],  # type: ignore[attr-defined]
+                value,
+                params,
+            ):
+                err_msg = (
+                    f"Model: `{params['full_model_name']}` > "
+                    + f"Field: `{field.name}` > "
+                    + f"Parameter: `slug_sources` => "
+                    + "At least one field should be unique!"
+                )
+                raise PanicError(err_msg)
+            # Add value to map.
+            params["result_map"][field.name] = value

ramifice/paladins/groups/text_group.py

@@ -10,6 +10,7 @@ from typing import Any
 from email_validator import EmailNotValidError, validate_email
 
 from ... import translations
+from ..tools import accumulate_error, check_uniqueness, panic_type_error
 
 
 class TextGroupMixin:
@@ -27,12 +28,12 @@ class TextGroupMixin:
         value = field.value or field.default or None
 
         if not isinstance(value, (str, type(None))):
-            self.panic_type_error("str", params)  # type: ignore[attr-defined]
+            panic_type_error(params["full_model_name"], "str | None", params)
 
         if value is None:
             if field.required:
                 err_msg = translations._("Required field !")
-                self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                accumulate_error(params["full_model_name"], err_msg, params)
             if params["is_save"]:
                 params["result_map"][field.name] = None
             return
@@ -40,11 +41,15 @@ class TextGroupMixin:
         maxlength: int | None = field.__dict__.get("maxlength")
         if maxlength is not None and len(value) > maxlength:
             err_msg = translations._("The length of the string exceeds maxlength=%d !" % maxlength)
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         # Validation the `unique` field attribute.
-        if field.unique and not await self.check_uniqueness(value, params):  # type: ignore[attr-defined]
+        if field.unique and not await check_uniqueness(
+            self.__class__.META["is_migrate_model"],  # type: ignore[attr-defined]
+            value,
+            params,
+        ):
             err_msg = translations._("Is not unique !")
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         # Validation Email, Url, IP, Color, Phone.
         field_type = field.field_type
         if "Email" in field_type:
@@ -57,19 +62,19 @@ class TextGroupMixin:
                 params["field_data"].value = value
             except EmailNotValidError:
                 err_msg = translations._("Invalid Email address !")
-                self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+                accumulate_error(params["full_model_name"], err_msg, params)
         elif "URL" in field_type and not field.is_valid(value):
             err_msg = translations._("Invalid URL address !")
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         elif "IP" in field_type and not field.is_valid(value):
             err_msg = translations._("Invalid IP address !")
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         elif "Color" in field_type and not field.is_valid(value):
             err_msg = translations._("Invalid Color code !")
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         elif "Phone" in field_type and not field.is_valid(value):
             err_msg = translations._("Invalid Phone number !")
-            self.accumulate_error(err_msg, params)  # type: ignore[attr-defined]
+            accumulate_error(params["full_model_name"], err_msg, params)
         # Insert result.
         if params["is_save"]:
             params["result_map"][field.name] = value

ramifice/paladins/refrash.py

@@ -6,6 +6,7 @@ from pymongo.asynchronous.collection import AsyncCollection
 
 from .. import store
 from ..errors import PanicError
+from .tools import refresh_from_mongo_doc
 
 
 class RefrashMixin:
@@ -25,4 +26,4 @@ class RefrashMixin:
             )
             raise PanicError(msg)
         self.inject()  # type: ignore[attr-defined]
-        self.refrash_from_mongo_doc(mongo_doc)  # type: ignore[attr-defined]
+        refresh_from_mongo_doc(self, mongo_doc)

ramifice/paladins/save.py

@@ -7,6 +7,7 @@ from pymongo.asynchronous.collection import AsyncCollection
 
 from .. import store
 from ..errors import PanicError
+from .tools import ignored_fields_to_none, refresh_from_mongo_doc
 
 
 class SaveMixin:
@@ -33,7 +34,7 @@ class SaveMixin:
             result_check["is_valid"] = False
         # Leave the method if the check fails.
         if not result_check["is_valid"]:
-            self.ignored_fields_to_none()  # type: ignore[attr-defined]
+            ignored_fields_to_none(self)
             return False
         # Get data for document.
         checked_data: dict[str, Any] = result_check["data"]
@@ -48,8 +49,17 @@ class SaveMixin:
             # Run hook.
             await self.post_update()  # type: ignore[attr-defined]
             # Refresh Model.
-            mongo_doc = await collection.find_one({"_id": checked_data["_id"]})
-            self.refrash_from_mongo_doc(mongo_doc)  # type: ignore[attr-defined]
+            mongo_doc: dict[str, Any] | None = await collection.find_one(
+                {"_id": checked_data["_id"]}
+            )
+            if mongo_doc is None:
+                msg = (
+                    f"Model: `{self.full_model_name()}` > "  # type: ignore[attr-defined]
+                    + "Method: `save` => "
+                    + "Geted value is None - it is impossible to refresh the current Model."
+                )
+                raise PanicError(msg)
+            refresh_from_mongo_doc(self, mongo_doc)
         else:
             # Add date and time.
             today = datetime.now()
@@ -63,8 +73,15 @@ class SaveMixin:
             await self.post_create()  # type: ignore[attr-defined]
             # Refresh Model.
             mongo_doc = await collection.find_one({"_id": checked_data["_id"]})
+            if mongo_doc is None:
+                msg = (
+                    f"Model: `{self.full_model_name()}` > "  # type: ignore[attr-defined]
+                    + "Method: `save` => "
+                    + "Geted value is None - it is impossible to refresh the current Model."
+                )
+                raise PanicError(msg)
             if mongo_doc is not None:
-                self.refrash_from_mongo_doc(mongo_doc)  # type: ignore[attr-defined]
+                refresh_from_mongo_doc(self, mongo_doc)
             else:
                 msg = (
                     f"Model: `{self.full_model_name()}` > "  # type: ignore[attr-defined]

ramifice/paladins/tools.py

@@ -1,6 +1,5 @@
-"""Tools - A set of additional auxiliary methods for Paladins."""
+"""Tool of Paladins - A set of auxiliary methods."""
 
-from datetime import datetime
 from typing import Any
 
 from termcolor import colored
@@ -8,93 +7,57 @@ from termcolor import colored
 from ..errors import PanicError
 
 
-class ToolMixin:
-    """A set of additional auxiliary methods for Paladins."""
+def ignored_fields_to_none(inst_model: Any) -> None:
+    """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 and field_data.name != "_id":
+            field_data.value = None
 
-    async def is_valid(self) -> bool:
-        """Check data validity.
 
-        The main use is to check data from web forms.
-        """
-        result_check: dict[str, Any] = await self.check()  # type: ignore[attr-defined]
-        return result_check["is_valid"]
+def refresh_from_mongo_doc(inst_model: Any, mongo_doc: dict[str, Any]) -> None:
+    """Update object instance from Mongo document."""
+    for name, data in mongo_doc.items():
+        field = inst_model.__dict__[name]
+        field.value = data if field.group != "pass" else None
 
-    def print_err(self) -> None:
-        """Printing errors to the console.
 
-        Convenient to use during development.
-        """
-        is_err: bool = False
-        for field_name, field_data in self.__dict__.items():
-            if callable(field_data):
-                continue
-            if len(field_data.errors) > 0:
-                # title
-                if not is_err:
-                    print(colored("\nERRORS:", "red", attrs=["bold"]))
-                    print(colored("Model: ", "blue", attrs=["bold"]), end="")
-                    print(colored(f"`{self.full_model_name()}`", "blue"))  # type: ignore[attr-defined]
-                    is_err = True
-                # field name
-                print(colored("Field: ", "green", attrs=["bold"]), end="")
-                print(colored(f"`{field_name}`:", "green"))
-                # error messages
-                print(colored("\n".join(field_data.errors), "red"))
-        if len(self._id.alerts) > 0:  # type: ignore[attr-defined]
-            # title
-            print(colored("AlERTS:", "yellow", attrs=["bold"]))
-            # messages
-            print(colored("\n".join(self._id.alerts), "yellow"), end="\n\n")  # type: ignore[attr-defined]
-        else:
-            print(end="\n\n")
+def panic_type_error(model_name: str, value_type: str, params: dict[str, Any]) -> None:
+    """Unacceptable type of value."""
+    msg = (
+        f"Model: `{model_name}` > "
+        + f"Field: `{params['field_data'].name}` > "
+        + f"Parameter: `value` => Must be `{value_type}` type!"
+    )
+    raise PanicError(msg)
 
-    def accumulate_error(self, err_msg: str, params: dict[str, Any]) -> None:
-        """For 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"]:
-                params["is_error_symptom"] = True
-        else:
-            msg = (
-                f">>hidden field<< - Model: `{self.full_model_name()}` > "  # type: ignore[attr-defined]
-                + f"Field: `{params['field_data'].name}`"
-                + f" => {err_msg}"
-            )
-            raise PanicError(msg)
 
-    def panic_type_error(self, value_type: str, params: dict[str, Any]) -> None:
-        """Unacceptable type of value."""
+def accumulate_error(model_name: str, err_msg: str, params: dict[str, Any]) -> None:
+    """For 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"]:
+            params["is_error_symptom"] = True
+    else:
         msg = (
-            f"Model: `{self.full_model_name()}` > "  # type: ignore[attr-defined]
-            + f"Field: `{params['field_data'].name}` > "
-            + f"Parameter: `value` => Must be `{value_type}` type!"
+            f">>hidden field<< -> Model: `{model_name}` > "
+            + f"Field: `{params['field_data'].name}`"
+            + f" => {err_msg}"
         )
         raise PanicError(msg)
 
-    async def check_uniqueness(
-        self,
-        value: str | int | float | datetime,
-        params: dict[str, Any],
-    ) -> bool:
-        """Check the uniqueness of the value in the collection."""
-        if not self.__class__.META["is_migrate_model"]:  # type: ignore[attr-defined]
-            return True
-        q_filter = {
-            "$and": [
-                {"_id": {"$ne": params["doc_id"]}},
-                {params["field_data"].name: value},
-            ],
-        }
-        return await params["collection"].find_one(q_filter) is None
 
-    def ignored_fields_to_none(self) -> None:
-        """Reset the values of ignored fields to None."""
-        for _, field_data in self.__dict__.items():
-            if not callable(field_data) and field_data.ignored and field_data.name != "_id":
-                field_data.value = None
-
-    def refrash_from_mongo_doc(self, mongo_doc: dict[str, Any]) -> None:
-        """Update object instance from Mongo document."""
-        for name, data in mongo_doc.items():
-            field = self.__dict__[name]
-            field.value = data if field.group != "pass" else None
+async def check_uniqueness(
+    is_migrate_model: bool,
+    value: str | int | float,
+    params: dict[str, Any],
+) -> bool:
+    """Check the uniqueness of the value in the collection."""
+    if not is_migrate_model:
+        return True
+    q_filter = {
+        "$and": [
+            {"_id": {"$ne": params["doc_id"]}},
+            {params["field_data"].name: value},
+        ],
+    }
+    return await params["collection"].find_one(q_filter) is None

ramifice/paladins/validation.py

@@ -0,0 +1,47 @@
+"""Validation of Model and printing errors to console."""
+
+from typing import Any
+
+from termcolor import colored
+
+
+class ValidationMixin:
+    """Validation of Model and printing errors to console."""
+
+    async def is_valid(self) -> bool:
+        """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.
+        """
+        result_check: dict[str, Any] = await self.check()  # type: ignore[attr-defined]
+        return result_check["is_valid"]
+
+    def print_err(self) -> None:
+        """Printing errors to console.
+
+        Convenient to use during development.
+        """
+        is_err: bool = False
+        for field_name, field_data in self.__dict__.items():
+            if callable(field_data):
+                continue
+            if len(field_data.errors) > 0:
+                # title
+                if not is_err:
+                    print(colored("\nERRORS:", "red", attrs=["bold"]))
+                    print(colored("Model: ", "blue", attrs=["bold"]), end="")
+                    print(colored(f"`{self.full_model_name()}`", "blue"))  # type: ignore[attr-defined]
+                    is_err = True
+                # field name
+                print(colored("Field: ", "green", attrs=["bold"]), end="")
+                print(colored(f"`{field_name}`:", "green"))
+                # error messages
+                print(colored("\n".join(field_data.errors), "red"))
+        if len(self._id.alerts) > 0:  # type: ignore[attr-defined]
+            # title
+            print(colored("AlERTS:", "yellow", attrs=["bold"]))
+            # messages
+            print(colored("\n".join(self._id.alerts), "yellow"), end="\n\n")  # type: ignore[attr-defined]
+        else:
+            print(end="\n\n")

ramifice/translations.py

@@ -25,6 +25,7 @@ zh | zh_cn
 
 import copy
 import gettext as _gettext
+from gettext import NullTranslations
 from typing import Any
 
 # Language code by default.
@@ -35,7 +36,7 @@ CURRENT_LOCALE: str = copy.deepcopy(DEFAULT_LOCALE)
 LANGUAGES: list[str] = ["en", "ru"]
 
 # Add translations for Ramifice.
-ramifice_translations = {
+ramifice_translations: dict[str, NullTranslations] = {
     lang: _gettext.translation(
         domain="messages",
         localedir="config/translations/ramifice",
@@ -47,7 +48,7 @@ ramifice_translations = {
 }
 
 # Add translations for custom project.
-custom_translations = {
+custom_translations: dict[str, NullTranslations] = {
     lang: _gettext.translation(
         domain="messages",
         localedir="config/translations/custom",
@@ -104,11 +105,11 @@ def get_custom_translator(lang_code: str) -> Any:
 
 
 # The object of the current translation, for Ramifice.
-_ = get_ramifice_translator(DEFAULT_LOCALE).gettext
+_: Any = get_ramifice_translator(DEFAULT_LOCALE).gettext
 
 # The object of the current translation, for custom project.
-gettext = get_custom_translator(DEFAULT_LOCALE).gettext
-ngettext = get_custom_translator(DEFAULT_LOCALE).ngettext
+gettext: Any = get_custom_translator(DEFAULT_LOCALE).gettext
+ngettext: Any = get_custom_translator(DEFAULT_LOCALE).ngettext
 
 
 def change_locale(lang_code: str) -> None:
@@ -128,5 +129,6 @@ def change_locale(lang_code: str) -> None:
     if lang_code != CURRENT_LOCALE:
         CURRENT_LOCALE = lang_code if lang_code in LANGUAGES else DEFAULT_LOCALE
         _ = get_ramifice_translator(CURRENT_LOCALE).gettext
-        gettext = get_custom_translator(CURRENT_LOCALE).gettext
-        ngettext = get_custom_translator(CURRENT_LOCALE).ngettext
+        translator: NullTranslations = get_custom_translator(CURRENT_LOCALE)
+        gettext = translator.gettext
+        ngettext = translator.ngettext

ramifice/types.py

@@ -15,7 +15,7 @@ class Unit(JsonMixin):
     """Unit of information for `choices` parameter in dynamic field types.
 
     Attributes:
-        field -- The name of the field.
+        field -- The name of the dynamic field.
         title -- The name of the choice item.
         value -- The value of the choice item.
         is_delete -- True - if you need to remove the item of choice.

ramifice/{tools.py → utilities.py}

@@ -1,4 +1,4 @@
-"""Global collection of auxiliary tools."""
+"""Global collection of auxiliary methods."""
 
 import ipaddress
 import math

{ramifice-0.3.14.dist-info → ramifice-0.3.16.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ramifice
-Version: 0.3.14
+Version: 0.3.16
 Summary: ORM-like API MongoDB for Python language.
 Project-URL: Homepage, https://github.com/kebasyaty/ramifice
 Project-URL: Documentation, https://kebasyaty.github.io/ramifice/
@@ -181,7 +181,7 @@ class User:
         )
 
     async def add_validation(self) -> dict[str, str]:
-        """For additional validation of fields."""
+        """Additional validation of fields."""
         error_map: dict[str, str] = {}
         if self.password != self.сonfirm_password:
             error_map["password"] = "Passwords do not match!"
@@ -210,8 +210,7 @@ async def main():
     user.сonfirm_password.value = "12345678"
 
     if not await user.save():
-        # Convenient to use during development.
-        user.print_err()
+        user.print_err()  # Convenient to use during development.
 
     doc_count = await User.estimated_document_count()
     print(f"Document count: {doc_count}")  # => 1
@@ -220,9 +219,9 @@ async def main():
     user_details = await User.find_one_to_raw_doc({"_id": user._id.value})
     pprint.pprint(user_details)
 
-    # await user.delete()
-    # doc_count = await User.estimated_document_count()
-    # print(f"Document count: {doc_count}")  # => 0
+    await user.delete(remove_files=False)
+    doc_count = await User.estimated_document_count()
+    print(f"Document count: {doc_count}")  # => 0
 
     await client.close()
 
@@ -351,6 +350,155 @@ class User:
         )
 ```
 
+## Class methods
+
+_List of frequently used methods:_
+
+```python
+# Gets an estimate of the count of documents in a collection using collection metadata.
+count: int = await User.estimated_document_count()
+
+# Gets an estimate of the count of documents in a collection using collection metadata.
+q_filter = {"first_name": "John"}
+count: int = await User.count_documents(q_filter)
+
+# Runs an aggregation framework pipeline.
+from bson.bson import BSON
+pipeline = [
+    {"$unwind": "$tags"},
+    {"$group": {"_id": "$tags", "count": {"$sum": 1}}},
+    {"$sort": BSON([("count", -1), ("_id", -1)])},
+]
+docs = await User.aggregate(pipeline)
+
+# Finds the distinct values for a specified field across a single collection.
+q_filter = "key_name"
+values = await User.distinct(q_filter)
+
+# Get collection name.
+name = await User.collection_name()
+
+# The full name is of the form database_name.collection_name.
+name = await User.collection_full_name()
+
+# Get AsyncBatabase for the current Model.
+database = await User.database()
+
+# Get AsyncCollection for the current Model.
+collection = await User.collection()
+
+# Find a single document.
+q_filter = {"email": "John_Smith@gmail.com"}
+mongo_doc = await User.find_one(q_filter)
+
+# Find a single document and converting to raw document.
+q_filter = {"email": "John_Smith@gmail.com"}
+raw_doc = await User.find_one_to_raw_doc(q_filter)
+
+# Find a single document and convert it to a Model instance.
+q_filter = {"email": "John_Smith@gmail.com"}
+user = await User.find_one_to_instance(q_filter)
+
+# Find a single document and convert it to a JSON string.
+q_filter = {"email": "John_Smith@gmail.com"}
+json = await User.find_one_to_json(q_filter)
+
+# Find a single document and delete it.
+q_filter = {"email": "John_Smith@gmail.com"}
+delete_result = await User.delete_one(q_filter)
+
+# Find a single document and delete it, return original.
+q_filter = {"email": "John_Smith@gmail.com"}
+mongo_doc = await User.find_one_and_delete(q_filter)
+
+# Find documents.
+q_filter = {"first_name": "John"}
+mongo_docs = await User.find_many(q_filter)
+
+# Find documents and convert to a raw documents.
+q_filter = {"first_name": "John"}
+raw_docs = await User.find_many_to_raw_docs(q_filter)
+
+# Find documents and convert to a json string.
+q_filter = {"email": "John_Smith@gmail.com"}
+json = await User.find_many_to_json(q_filter)
+
+# Find documents matching with Model.
+q_filter = {"email": "John_Smith@gmail.com"}
+delete_result = await User.delete_many(q_filter)
+
+# Creates an index on this collection.
+from pymongo import ASCENDING
+keys = [("email", ASCENDING)]
+result: str = await User.create_index(keys, name="idx_email")
+
+# Drops the specified index on this collection.
+User.drop_index("idx_email")
+
+# Create one or more indexes on this collection.
+from pymongo import ASCENDING, DESCENDING
+index_1 = IndexModel([("username", DESCENDING), ("email", ASCENDING)], name="idx_username_email")
+index_2 = IndexModel([("first_name", DESCENDING)], name="idx_first_name")
+result: list[str] = await User.create_indexes([index_1, index_2])
+
+# Drops all indexes on this collection.
+User.drop_index()
+
+# Get information on this collection’s indexes.
+result = await User.index_information()
+
+# Get a cursor over the index documents for this collection.
+async for index in await User.list_indexes():
+    print(index)
+
+# Units Management.
+# Management for `choices` parameter in dynamic field types.
+# Units are stored in a separate collection.
+from ramifice.types import Unit
+unit = Unit(
+  field="field_name",  # The name of the dynamic field.
+  title="Title",  # The name of the choice item.
+  value="Some text ...",  # The value of the choice item.
+                          # Hint: float | int | str
+  is_delete=False, # True - if you need to remove the item of choice.
+                   # by default = False (add item to choice)
+)
+User.unit_manager(unit)
+```
+
+## Instance methods
+
+_List of frequently used methods:_
+
+```python
+# 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.
+user = User()
+if not await user.is_valid():
+    user.print_err()  # Convenient to use during development.
+
+# Create or update document in database.
+# This method pre-uses the `check` method.
+user = User()
+if not await user.save():
+    user.print_err()  # Convenient to use during development.
+
+# Delete document from database.
+user = User()
+await user.delete()
+# or
+await user.delete(remove_files=False)
+
+# Verification, replacement and recoverang of password.
+user = User()
+await user.verify_password(password="12345678")
+await user.update_password(  # uses verify_password
+  old_password="12345678",
+  new_password="O2eA4GIr38KGGlS",
+)
+```
+
 ## Contributing
 
 1. Fork it (<https://github.com/kebasyaty/ramifice/fork>)

{ramifice-0.3.14.dist-info → ramifice-0.3.16.dist-info}/RECORD

@@ -1,24 +1,24 @@
 ramifice/__init__.py,sha256=ISlaL2BprlJLE_N1fvtAqGrB3Dhniy9IZGoyWEYZhRU,678
-ramifice/add_valid.py,sha256=nXIB9SSNtc3a6amCRM4k7P03zrcTKRz9kf-3MrdjZ-A,331
-ramifice/decorators.py,sha256=Jy5KKSRBcnxNsRFmIRTbk9uKhPHhdfdFF5wkg8naGhA,5043
+ramifice/add_valid.py,sha256=kvpMg7snL9tor0A23XRdgwiXazRwHfb8baoJUNjM_4Y,327
+ramifice/decorators.py,sha256=hTivOrCbTqnnbbbicgoET3bLSICSjMzqctLKzf2YseM,6144
 ramifice/errors.py,sha256=iuhq7fzpUmsOyeXeg2fJjta8yAuqlXLKsZVMpfUhtHE,1901
 ramifice/fixtures.py,sha256=NtxOnZslYJb4yvRpZbs3ckugmTwHQFS_9iCt2zddOC0,3102
 ramifice/hooks.py,sha256=Ri-ISfMT-IHaLO2eAqg8CODCTs3HRTxSylqspUKnVf4,873
 ramifice/indexing.py,sha256=wQpX2qei5Zc7iIq5yIV93Skp8Aa8ZD0vybnEk7cRuXs,271
 ramifice/migration.py,sha256=lksHC2f_19pDHp6Sg9pdwqA14jKxMsS8T7gfBdzIsDw,10932
 ramifice/mixins.py,sha256=gKLmWQ-QrGO3K5_k-h1tDa08lkCql_dte2Jy05q1wsM,1125
-ramifice/model.py,sha256=7AWVvXdP2wBY2ffx1Kx_8Ao-8VD5WGo1eOEKkFrAP68,6533
+ramifice/model.py,sha256=eJCrwURQuZApY84IpxvecS6dHTvT4MK3BpGFTEWz-H4,6536
 ramifice/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ramifice/store.py,sha256=Kqd2Zw7Wj2vnn_0eE6KmIOkWJRhDc6AZ0ZyqxENBetQ,2730
-ramifice/tools.py,sha256=7TZqc9ds1M668M_PcYVjnO062CLJ_mkprMmVKzQ7W2k,2525
-ramifice/translations.py,sha256=zz-F0sdAw5itmih74Un5SUfef9BE3d8R32JhGNaKmcU,3913
-ramifice/types.py,sha256=qH6d3W3e2k40cFaCPTAvQlLI1kp0Kg6DuiykP6nB-0E,2382
+ramifice/translations.py,sha256=GNGE0ULAA0aOY5pTxUd3MQW-nVaKvp6BeXWEcsR0s0o,4048
+ramifice/types.py,sha256=ljo6VscUGWEJ4Km4JYo8GEfxd1YK1CUbS8CfHp_MlEA,2390
+ramifice/utilities.py,sha256=cX-qnNsGhP3ltA7wnhm5V8K5_FUKq2LpD-c5YdOHLJM,2527
 ramifice/commons/__init__.py,sha256=LHCsdpl4z8W-xUvAlOr1ad0ras9hspvCpuce4SAdfP0,472
 ramifice/commons/general.py,sha256=fTnIRA3IGbi0lMKBCgeqkI7BGJWTbZVu0nOJYoNRSRU,4571
 ramifice/commons/indexes.py,sha256=ABNRXeWZSreAE4_EDlsTN9aS8QiZbzhsatUJFn2EuOo,3849
 ramifice/commons/many.py,sha256=uxWgtXE40s0s6siLeqi55oAM3H9Z6S-1wKgNoJlVytg,8312
-ramifice/commons/one.py,sha256=v5hK_Ia-wPKGwk_3ydg1G8gy_LAuXIyw0y8N4dDCzYk,5600
-ramifice/commons/tools.py,sha256=x5Nv80guKyjp8YMmjvysdsrWPs88HalNdZOhfwNBYjE,2238
+ramifice/commons/one.py,sha256=XKWYYZn7SZ4At_yhjPSM1zXMoQzvt8wSM0F8kgWxhNU,5631
+ramifice/commons/tools.py,sha256=1oJHgb_WpWwoGtMcGQ-ta1oUMJLyN8QxuMbY83Sk36o,2220
 ramifice/commons/units.py,sha256=sYlRThKQPdBDJB3togJz8qyASpQ7gNZndbudUGDQEwE,4402
 ramifice/fields/__init__.py,sha256=yRfX7Tvpuh27Ggcx5u9e1RRYK7Wu59EVJYxxetmuP1w,1290
 ramifice/fields/bool_field.py,sha256=RUoHeU6L2wX5YfGyzsZBxg3OVlu3tP6eNhzWnHsU_G0,2041
@@ -56,25 +56,26 @@ ramifice/fields/general/field.py,sha256=Iwjx0idIUIFwcQw4TQEqejKct1EGaaJv1zZ1poSW
 ramifice/fields/general/file_group.py,sha256=n45KfPzFI_l5hXoKkPDG0Q-0mdC2obExV-3PJ-MN5tA,1071
 ramifice/fields/general/number_group.py,sha256=AqlCY-t6JHZ2QVBe7mk5nPt6z8M4VJ_RARRlSBoIxms,715
 ramifice/fields/general/text_group.py,sha256=gP6mUGXr-LTI1UegqgEMQ-5vtUJuJs0wDYKVkknW_5E,873
-ramifice/paladins/__init__.py,sha256=taMBhJw3UwM_Qqvzm-8iPWdUEDWu-uKtJV1LmWeeKvM,499
-ramifice/paladins/check.py,sha256=K2aAwVXxKORmLtNLA9bf5QAWCF5eSCfIur3Oli-LVag,6641
-ramifice/paladins/delete.py,sha256=EFhr5yJDrvv1Sy3Z_x5gYjuMCDLuSYlRFdPDkvOFhgg,3556
+ramifice/paladins/__init__.py,sha256=PIP3AXI2KBRXNcLJUF0d7ygJ7VLOAxlhb4HRKQ9MGYY,516
+ramifice/paladins/check.py,sha256=kseDMCMliRsYsldcRFo5itqroQQtHtcA_oNEd6wvfgU,6835
+ramifice/paladins/delete.py,sha256=RfCyew5tbBCT8u1c8nMgC2vIQlIWzu9Tvh6TuO7VBmM,3584
 ramifice/paladins/password.py,sha256=O1OvmeKuXbwtBX1sPTRVsoWYHPQn9isOe1rju6A3wbE,3264
-ramifice/paladins/refrash.py,sha256=bfVmpyxlDIY2ASOd-BnCWTnlMO7tbYvN-A83CaR_73s,1193
-ramifice/paladins/save.py,sha256=IeVBc3aLpJsdxNOS_O5GrnACZftWdbVP8qVpsd7pD1Y,3549
-ramifice/paladins/tools.py,sha256=Q1D678j-1jr5qsM75gz2pGJBtH-wIW12LmNsvz2B-Zw,4036
+ramifice/paladins/refrash.py,sha256=DfBFGjPB6yYjga57GuCiWFBNHalmDO3EfMjkhgoWnVI,1207
+ramifice/paladins/save.py,sha256=7KxocEisEVYWkZtBpHZyP6drGMyOVvF2vaymm4HNHmg,4276
+ramifice/paladins/tools.py,sha256=LlrY3rtKmBBGXOd6Lf8w84jMULA5C6nwzpHIoN16ibc,2094
+ramifice/paladins/validation.py,sha256=7lFDWjokUwMwVxWAVgd_GlWGpF4mukxIVpxvpdyA19A,1850
 ramifice/paladins/groups/__init__.py,sha256=hpqmWLsYAMvZHAbmMXluQSqLhkHOSTUAgLHyTM1LTYI,472
-ramifice/paladins/groups/bool_group.py,sha256=bTdubd6tmdNsxPsh92lgI9fLmg5ppyGAbWyOZkJiPmE,780
-ramifice/paladins/groups/choice_group.py,sha256=Wa60SLiF8AdFAKC1eYdqaAb-ZuO1ICAia8If0oXTx-U,1755
-ramifice/paladins/groups/date_group.py,sha256=KTOP_022SgVqQdiYoGR2T5RkI-Wdu3U3rjicn6BXU00,3813
-ramifice/paladins/groups/file_group.py,sha256=cnwbFaN3DueERBgw9HmRvDs2THLXAYJCUdCPNcxJFpY,3263
-ramifice/paladins/groups/id_group.py,sha256=H0YUJ5_7VO51Bs2JFcCVr9B5QjAXxzVqh6DKLlp9BbE,1313
-ramifice/paladins/groups/img_group.py,sha256=WZsihfivrConmlJ9B9hefpJyFAa-EUH3mvmsI4Ns5dI,5744
-ramifice/paladins/groups/num_group.py,sha256=b60uSdDRCNzdv10tXYazfeWdY9JfBdU_8-lngkASXqg,2381
-ramifice/paladins/groups/pass_group.py,sha256=89atp3RxvE45LIm4g_uGTFwfDRdSfOXY5s2vY0cqjgI,1929
-ramifice/paladins/groups/slug_group.py,sha256=AhTODxabYTWC41Xssnp9gqklUz9-GBS0lWyeHLXOYmw,1652
-ramifice/paladins/groups/text_group.py,sha256=ThZOcx0XCCZ_UZRS9FIix3T8zte2YlpHUZ61EwVMVGc,3397
-ramifice-0.3.14.dist-info/METADATA,sha256=9sk21Xb5YYxVcgzKWpaVF9fAJMCocvzouhkY7hdHFQk,14182
-ramifice-0.3.14.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ramifice-0.3.14.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
-ramifice-0.3.14.dist-info/RECORD,,
+ramifice/paladins/groups/bool_group.py,sha256=fpxCySJ5JL7w1dLFPX1025zEU8CRsWSyQyXb3Hr3Z2s,819
+ramifice/paladins/groups/choice_group.py,sha256=OJeZjpnqKnSF1_bechtNepCCPjmp54x1T0c28DAa11c,1777
+ramifice/paladins/groups/date_group.py,sha256=-IS9pAHXdWK7tO9KQ2UyG1uf7TA43DKYCOCtOM2_tZ0,3844
+ramifice/paladins/groups/file_group.py,sha256=oQ61TCGoRF8kArOY0F2IXXUTOiRyyu0oh3F1reV8rmU,3298
+ramifice/paladins/groups/id_group.py,sha256=tK3OL1pr-V8PHPyS7vmjmJi_sRU669EvkY_Fc4sRHzg,1352
+ramifice/paladins/groups/img_group.py,sha256=Yi2LG-RK_0NV5at8L8i_OYp--XDzqh66bw3xA9v2HeE,5779
+ramifice/paladins/groups/num_group.py,sha256=Jvb-lwHxapQybbLerC4t-_yO8N7Coo1fIlZ9eAGHcGs,2508
+ramifice/paladins/groups/pass_group.py,sha256=SEKpR2voNQtmywugDXJKY4XqPTL91CrJ87h0QNMqQqs,1952
+ramifice/paladins/groups/slug_group.py,sha256=_IRil2PwpY7cH7WaExNksKz61kQjvc27blrEufgUB30,2323
+ramifice/paladins/groups/text_group.py,sha256=nYZGwAIsJD-tX8RBtFlWvngO9RU4V0CnREUhxvV2UDo,3493
+ramifice-0.3.16.dist-info/METADATA,sha256=e2_MkRAQOyshI5iKiXLLcjPQA2UfLmZ5LCJ4jJHEC7I,18896
+ramifice-0.3.16.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ramifice-0.3.16.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
+ramifice-0.3.16.dist-info/RECORD,,