ramifice 0.3.27__py3-none-any.whl → 0.3.29__py3-none-any.whl

ramifice/paladins/delete.py

@@ -6,8 +6,8 @@ from typing import Any
 
 from pymongo.asynchronous.collection import AsyncCollection
 
-from .. import store
-from ..errors import PanicError
+from ..utils import globals
+from ..utils.errors import PanicError
 
 
 class DeleteMixin:
@@ -27,26 +27,26 @@ class DeleteMixin:
         """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"]:  # type: ignore[attr-defined]
+        if not cls_model.META["is_delete_doc"]:
             msg = (
-                f"Model: `{cls_model.META['full_model_name']}` > "  # type: ignore[attr-defined]
+                f"Model: `{cls_model.META['full_model_name']}` > "
                 + "META param: `is_delete_doc` (False) => "
                 + "Documents of this Model cannot be removed from the database!"
             )
             raise PanicError(msg)
         # Get documet ID.
-        doc_id = self._id.value  # type: ignore[attr-defined]
+        doc_id = self._id.value
         if doc_id is None:
             msg = (
-                f"Model: `{cls_model.META['full_model_name']}` > "  # type: ignore[attr-defined]
+                f"Model: `{cls_model.META['full_model_name']}` > "
                 + "Field: `_id` > "
                 + "Param: `value` => ID is missing."
             )
             raise PanicError(msg)
         # Run hook.
-        await self.pre_delete()  # type: ignore[attr-defined]
+        await self.pre_delete()
         # Get collection for current Model.
-        collection: AsyncCollection = store.MONGO_DATABASE[cls_model.META["collection_name"]]  # type: ignore[index, attr-defined]
+        collection: AsyncCollection = globals.MONGO_DATABASE[cls_model.META["collection_name"]]
         # Delete document.
         mongo_doc: dict[str, Any] = {}
         mongo_doc = await collection.find_one_and_delete(
@@ -62,7 +62,7 @@ class DeleteMixin:
         # If the document failed to delete.
         if not bool(mongo_doc):
             msg = (
-                f"Model: `{cls_model.META['full_model_name']}` > "  # type: ignore[attr-defined]
+                f"Model: `{cls_model.META['full_model_name']}` > "
                 + "Method: `delete` => "
                 + "The document was not deleted, the document is absent in the database."
             )
@@ -86,6 +86,6 @@ class DeleteMixin:
                     file_data = None
             field_data.value = None
         # Run hook.
-        await self.post_delete()  # type: ignore[attr-defined]
+        await self.post_delete()
         #
         return mongo_doc

ramifice/paladins/groups/choice_group.py

@@ -9,7 +9,7 @@ Supported fields:
 
 from typing import Any
 
-from ... import translations
+from ...utils import translations
 from ..tools import accumulate_error
 
 

ramifice/paladins/groups/date_group.py

@@ -9,7 +9,7 @@ from typing import Any
 
 from babel.dates import format_date, format_datetime
 
-from ... import translations
+from ...utils import translations
 from ..tools import accumulate_error, panic_type_error
 
 

ramifice/paladins/groups/file_group.py

@@ -5,8 +5,8 @@ Supported fields: FileField
 
 from typing import Any
 
-from ... import translations
-from ...tools import to_human_size
+from ...utils import translations
+from ...utils.tools import to_human_size
 from ..tools import accumulate_error, panic_type_error
 
 

ramifice/paladins/groups/id_group.py

@@ -8,7 +8,7 @@ from typing import Any
 
 from bson.objectid import ObjectId
 
-from ... import translations
+from ...utils import translations
 from ..tools import accumulate_error, panic_type_error
 
 

ramifice/paladins/groups/img_group.py

@@ -7,8 +7,8 @@ from typing import Any
 
 from PIL import Image
 
-from ... import translations
-from ...tools import to_human_size
+from ...utils import translations
+from ...utils.tools import to_human_size
 from ..tools import accumulate_error, panic_type_error
 
 

ramifice/paladins/groups/num_group.py

@@ -6,7 +6,7 @@ Supported fields:
 
 from typing import Any
 
-from ... import translations
+from ...utils import translations
 from ..tools import accumulate_error, check_uniqueness, panic_type_error
 
 

ramifice/paladins/groups/pass_group.py

@@ -7,8 +7,8 @@ from typing import Any
 
 from argon2 import PasswordHasher
 
-from ... import translations
-from ...tools import is_password
+from ...utils import translations
+from ...utils.tools import is_password
 from ..tools import accumulate_error, panic_type_error
 
 

ramifice/paladins/groups/slug_group.py

@@ -8,7 +8,7 @@ from typing import Any
 
 from slugify import slugify
 
-from ...errors import PanicError
+from ...utils.errors import PanicError
 from ..tools import check_uniqueness
 
 

ramifice/paladins/groups/text_group.py

@@ -9,8 +9,8 @@ from typing import Any
 
 from email_validator import EmailNotValidError, validate_email
 
-from ... import translations
-from ...tools import is_color, is_ip, is_phone, is_url
+from ...utils import translations
+from ...utils.tools import is_color, is_ip, is_phone, is_url
 from ..tools import accumulate_error, check_uniqueness, panic_type_error
 
 
@@ -53,7 +53,7 @@ class TextGroupMixin:
             try:
                 emailinfo = validate_email(
                     str(value),
-                    check_deliverability=self.__class__.META["is_migrate_model"],  # type: ignore[attr-defined]
+                    check_deliverability=self.__class__.META["is_migrate_model"],
                 )
                 value = emailinfo.normalized
                 params["field_data"].value = value

ramifice/paladins/password.py

@@ -5,8 +5,8 @@ from typing import Any
 from argon2 import PasswordHasher
 from pymongo.asynchronous.collection import AsyncCollection
 
-from .. import store
-from ..errors import OldPassNotMatchError, PanicError
+from ..utils import globals
+from ..utils.errors import OldPassNotMatchError, PanicError
 
 
 class PasswordMixin:
@@ -20,30 +20,30 @@ class PasswordMixin:
         """For password verification."""
         cls_model = self.__class__
         # Get documet ID.
-        doc_id = self._id.value  # type: ignore[attr-defined]
+        doc_id = self._id.value
         if doc_id is None:
             msg = (
-                f"Model: `{cls_model.META['full_model_name']}` > "  # type: ignore[attr-defined]
+                f"Model: `{cls_model.META['full_model_name']}` > "
                 + "Method: `verify_password` => "
                 + "Cannot get document ID - ID field is empty."
             )
             raise PanicError(msg)
         # Get collection for current Model.
-        collection: AsyncCollection = store.MONGO_DATABASE[cls_model.META["collection_name"]]  # type: ignore[index, attr-defined]
+        collection: AsyncCollection = globals.MONGO_DATABASE[cls_model.META["collection_name"]]
         # Get document.
         mongo_doc: dict[str, Any] | None = await collection.find_one({"_id": doc_id})
         if mongo_doc is None:
             msg = (
-                f"Model: `{cls_model.META['full_model_name']}` > "  # type: ignore[attr-defined]
+                f"Model: `{cls_model.META['full_model_name']}` > "
                 + "Method: `verify_password` => "
-                + f"There is no document with ID `{self._id.value}` in the database."  # type: ignore[attr-defined]
+                + f"There is no document with ID `{self._id.value}` in the database."
             )
             raise PanicError(msg)
         # Get password hash.
         hash: str | None = mongo_doc.get(field_name)
         if hash is None:
             msg = (
-                f"Model: `{cls_model.META['full_model_name']}` > "  # type: ignore[attr-defined]
+                f"Model: `{cls_model.META['full_model_name']}` > "
                 + "Method: `verify_password` => "
                 + f"The model does not have a field `{field_name}`."
             )
@@ -73,9 +73,9 @@ class PasswordMixin:
         if not await self.verify_password(old_password, field_name):
             raise OldPassNotMatchError()
         # Get documet ID.
-        doc_id = self._id.value  # type: ignore[attr-defined]
+        doc_id = self._id.value
         # Get collection for current Model.
-        collection: AsyncCollection = store.MONGO_DATABASE[cls_model.META["collection_name"]]  # type: ignore[index, attr-defined]
+        collection: AsyncCollection = globals.MONGO_DATABASE[cls_model.META["collection_name"]]
         # Create hash of new passwor.
         ph = PasswordHasher()
         hash: str = ph.hash(new_password)

ramifice/paladins/refrash.py

@@ -4,8 +4,8 @@ from typing import Any
 
 from pymongo.asynchronous.collection import AsyncCollection
 
-from .. import store
-from ..errors import PanicError
+from ..utils import globals
+from ..utils.errors import PanicError
 from .tools import refresh_from_mongo_doc
 
 
@@ -16,14 +16,14 @@ class RefrashMixin:
         """Update Model instance from database."""
         cls_model = self.__class__
         # Get collection.
-        collection: AsyncCollection = store.MONGO_DATABASE[cls_model.META["collection_name"]]  # type: ignore[index, attr-defined]
-        mongo_doc: dict[str, Any] | None = await collection.find_one(filter={"_id": self._id.value})  # type: ignore[attr-defined]
+        collection: AsyncCollection = globals.MONGO_DATABASE[cls_model.META["collection_name"]]
+        mongo_doc: dict[str, Any] | None = await collection.find_one(filter={"_id": self._id.value})
         if mongo_doc is None:
             msg = (
-                f"Model: `{self.full_model_name()}` > "  # type: ignore[attr-defined]
+                f"Model: `{self.full_model_name()}` > "
                 + "Method: `refrash_from_db` => "
-                + f"A document with an identifier `{self._id.value}` is not exists in the database!"  # type: ignore[attr-defined]
+                + f"A document with an identifier `{self._id.value}` is not exists in the database!"
             )
             raise PanicError(msg)
-        self.inject()  # type: ignore[attr-defined]
+        self.inject()
         refresh_from_mongo_doc(self, mongo_doc)

ramifice/paladins/save.py

@@ -5,8 +5,8 @@ from typing import Any
 
 from pymongo.asynchronous.collection import AsyncCollection
 
-from .. import store
-from ..errors import PanicError
+from ..utils import globals
+from ..utils.errors import PanicError
 from .tools import ignored_fields_to_none, refresh_from_mongo_doc
 
 
@@ -20,17 +20,17 @@ class SaveMixin:
         """
         cls_model = self.__class__
         # Get collection.
-        collection: AsyncCollection = store.MONGO_DATABASE[cls_model.META["collection_name"]]  # type: ignore[index, attr-defined]
+        collection: AsyncCollection = globals.MONGO_DATABASE[cls_model.META["collection_name"]]
         # Check Model.
-        result_check: dict[str, Any] = await self.check(is_save=True, collection=collection)  # type: ignore[attr-defined]
+        result_check: dict[str, Any] = await self.check(is_save=True, collection=collection)
         # Reset the alerts to exclude duplicates.
-        self._id.alerts = []  # type: ignore[attr-defined]
+        self._id.alerts = []
         # Check the conditions and, if necessary, define a message for the web form.
-        if not result_check["is_update"] and not cls_model.META["is_create_doc"]:  # type: ignore[attr-defined]
-            self._id.alerts.append("It is forbidden to create new documents !")  # type: ignore[attr-defined]
+        if not result_check["is_update"] and not cls_model.META["is_create_doc"]:
+            self._id.alerts.append("It is forbidden to create new documents !")
             result_check["is_valid"] = False
-        if result_check["is_update"] and not cls_model.META["is_update_doc"]:  # type: ignore[attr-defined]
-            self._id.alerts.append("It is forbidden to update documents !")  # type: ignore[attr-defined]
+        if result_check["is_update"] and not cls_model.META["is_update_doc"]:
+            self._id.alerts.append("It is forbidden to update documents !")
             result_check["is_valid"] = False
         # Leave the method if the check fails.
         if not result_check["is_valid"]:
@@ -43,18 +43,18 @@ class SaveMixin:
             # Update date and time.
             checked_data["updated_at"] = datetime.now()
             # Run hook.
-            await self.pre_update()  # type: ignore[attr-defined]
+            await self.pre_update()
             # Update doc.
             await collection.update_one({"_id": checked_data["_id"]}, {"$set": checked_data})
             # Run hook.
-            await self.post_update()  # type: ignore[attr-defined]
+            await self.post_update()
             # Refresh Model.
             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]
+                    f"Model: `{self.full_model_name()}` > "
                     + "Method: `save` => "
                     + "Geted value is None - it is impossible to refresh the current Model."
                 )
@@ -66,16 +66,16 @@ class SaveMixin:
             checked_data["created_at"] = today
             checked_data["updated_at"] = today
             # Run hook.
-            await self.pre_create()  # type: ignore[attr-defined]
+            await self.pre_create()
             # Insert doc.
             await collection.insert_one(checked_data)
             # Run hook.
-            await self.post_create()  # type: ignore[attr-defined]
+            await self.post_create()
             # 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]
+                    f"Model: `{self.full_model_name()}` > "
                     + "Method: `save` => "
                     + "Geted value is None - it is impossible to refresh the current Model."
                 )
@@ -84,7 +84,7 @@ class SaveMixin:
                 refresh_from_mongo_doc(self, mongo_doc)
             else:
                 msg = (
-                    f"Model: `{self.full_model_name()}` > "  # type: ignore[attr-defined]
+                    f"Model: `{self.full_model_name()}` > "
                     + "Method: `save` => "
                     + "The document was not created."
                 )

ramifice/paladins/tools.py

@@ -2,7 +2,7 @@
 
 from typing import Any
 
-from ..errors import PanicError
+from ..utils.errors import PanicError
 
 
 def ignored_fields_to_none(inst_model: Any) -> None:

ramifice/paladins/validation.py

@@ -14,7 +14,7 @@ class ValidationMixin:
         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]
+        result_check: dict[str, Any] = await self.check()
         return result_check["is_valid"]
 
     def print_err(self) -> None:
@@ -31,17 +31,17 @@ class ValidationMixin:
                 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]
+                    print(colored(f"`{self.full_model_name()}`", "blue"))
                     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]
+        if len(self._id.alerts) > 0:
             # title
             print(colored("AlERTS:", "yellow", attrs=["bold"]))
             # messages
-            print(colored("\n".join(self._id.alerts), "yellow"), end="\n\n")  # type: ignore[attr-defined]
+            print(colored("\n".join(self._id.alerts), "yellow"), end="\n\n")
         else:
             print(end="\n\n")

ramifice/utils/__init__.py

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

ramifice/{store.py → utils/globals.py}

@@ -1,8 +1,6 @@
-"""Global storage for caching auxiliary variables.
+"""Global variables.
 
-The purpose of caching is production optimization.
-
-The module contains the following elements:
+List of variables:
 
 - `DEBUG` - Caching a condition for the verification code.
 - `MONGO_CLIENT` - Caching a Mongo client.

ramifice/{migration.py → utils/migration.py}

@@ -11,25 +11,25 @@ from pymongo import AsyncMongoClient
 from pymongo.asynchronous.collection import AsyncCollection
 from termcolor import colored
 
-from . import store
+from ..models.model import Model
+from . import globals
 from .errors import DoesNotMatchRegexError, NoModelsForMigrationError, PanicError
 from .fixtures import apply_fixture
-from .model import Model
 
 
 class Monitor:
     """Monitoring and updating database state for application."""
 
     def __init__(self, database_name: str, mongo_client: AsyncMongoClient):  # noqa: D107
-        store.DEBUG = False
+        globals.DEBUG = False
         #
-        db_name_regex = store.REGEX["database_name"]
+        db_name_regex = globals.REGEX["database_name"]
         if db_name_regex.match(database_name) is None:
             raise DoesNotMatchRegexError("^[a-zA-Z][-_a-zA-Z0-9]{0,59}$")
         #
-        store.DATABASE_NAME = database_name
-        store.MONGO_CLIENT = mongo_client
-        store.MONGO_DATABASE = store.MONGO_CLIENT[store.DATABASE_NAME]
+        globals.DATABASE_NAME = database_name
+        globals.MONGO_CLIENT = mongo_client
+        globals.MONGO_DATABASE = globals.MONGO_CLIENT[globals.DATABASE_NAME]
         # Get Model list.
         self.model_list: list[Any] = [
             cls_model for cls_model in Model.__subclasses__() if cls_model.META["is_migrate_model"]
@@ -45,7 +45,7 @@ class Monitor:
         """
         # Get access to super collection.
         # (Contains Model state and dynamic field data.)
-        super_collection: AsyncCollection = store.MONGO_DATABASE[store.SUPER_COLLECTION_NAME]  # type: ignore[index]
+        super_collection: AsyncCollection = globals.MONGO_DATABASE[globals.SUPER_COLLECTION_NAME]
         # Switch the `is_model_exist` parameter in `False`.
         async for model_state in super_collection.find():
             q_filter = {"collection_name": model_state["collection_name"]}
@@ -56,7 +56,7 @@ class Monitor:
         """Get the state of the current model from a super collection."""
         # Get access to super collection.
         # (Contains Model state and dynamic field data.)
-        super_collection: AsyncCollection = store.MONGO_DATABASE[store.SUPER_COLLECTION_NAME]  # type: ignore[index]
+        super_collection: AsyncCollection = globals.MONGO_DATABASE[globals.SUPER_COLLECTION_NAME]
         # Get state of current Model.
         model_state: dict[str, Any] | None = await super_collection.find_one(
             {"collection_name": metadata["collection_name"]}
@@ -88,10 +88,10 @@ class Monitor:
         delete collections associated with those Models.
         """  # noqa: D205
         # Get access to database.
-        database = store.MONGO_DATABASE
+        database = globals.MONGO_DATABASE
         # Get access to super collection.
         # (Contains Model state and dynamic field data.)
-        super_collection: AsyncCollection = store.MONGO_DATABASE[store.SUPER_COLLECTION_NAME]  # type: ignore[index]
+        super_collection: AsyncCollection = globals.MONGO_DATABASE[globals.SUPER_COLLECTION_NAME]
         # Delete data for non-existent Models.
         async for model_state in super_collection.find():
             if model_state["is_model_exist"] is False:
@@ -113,9 +113,9 @@ class Monitor:
         # Switch the `is_model_exist` parameter in the condition `False`.
         await self.reset()
         # Get access to database.
-        database = store.MONGO_DATABASE
+        database = globals.MONGO_DATABASE
         # Get access to super collection.
-        super_collection: AsyncCollection = database[store.SUPER_COLLECTION_NAME]  # type: ignore[index]
+        super_collection: AsyncCollection = database[globals.SUPER_COLLECTION_NAME]
         #
         for cls_model in self.model_list:
             # Get metadata of current Model.
@@ -128,7 +128,7 @@ class Monitor:
                 # Get a list of new fields.
                 new_fields: list[str] = self.new_fields(metadata, model_state)
                 # Get collection for current Model.
-                model_collection: AsyncCollection = database[model_state["collection_name"]]  # type: ignore[index]
+                model_collection: AsyncCollection = database[model_state["collection_name"]]
                 # Add new fields with default value or
                 # update existing fields whose field type has changed.
                 async for mongo_doc in model_collection.find():
@@ -194,7 +194,7 @@ class Monitor:
             )
         #
         # Block the verification code.
-        store.DEBUG = False
+        globals.DEBUG = False
         #
         # Delete data for non-existent Models from a
         # super collection and delete collections associated with those Models.
@@ -206,8 +206,8 @@ class Monitor:
             # Apply fixture to current Model.
             fixture_name: str | None = cls_model.META["fixture_name"]
             if fixture_name is not None:
-                collection: AsyncCollection = store.MONGO_DATABASE[
-                    cls_model.META["collection_name"]  # type: ignore[index]
+                collection: AsyncCollection = globals.MONGO_DATABASE[
+                    cls_model.META["collection_name"]
                 ]
                 if await collection.estimated_document_count() == 0:
                     await apply_fixture(

ramifice/utils/mixins/__init__.py

@@ -0,0 +1,6 @@
+"""A set of mixins for Ramifice."""
+
+from .add_valid import AddValidMixin
+from .hooks import HooksMixin
+from .indexing import IndexMixin
+from .json_converter import JsonMixin

ramifice/{add_valid.py → utils/mixins/add_valid.py}

@@ -1,10 +1,10 @@
-"""Additional validation of fields."""
+"""AddValidMixin - Contains an abstract method for additional validation of fields."""
 
 from abc import ABCMeta
 
 
 class AddValidMixin(metaclass=ABCMeta):
-    """Additional validation of fields."""
+    """Contains an abstract method for additional validation of fields."""
 
     async def add_validation(self) -> dict[str, str]:
         """Additional validation of fields."""

ramifice/{hooks.py → utils/mixins/hooks.py}

@@ -1,10 +1,10 @@
-"""Hook methods."""
+"""HooksMixin - Contains abstract methods for creating hooks."""
 
 from abc import ABCMeta
 
 
 class HooksMixin(metaclass=ABCMeta):
-    """Hook methods and additional validation of fields."""
+    """A set of abstract methods for creating hooks."""
 
     async def pre_create(self) -> None:
         """Called before a new document is created in the database."""

ramifice/utils/mixins/indexing.py

@@ -0,0 +1,11 @@
+"""IndexMixin - Contains abstract method for indexing the model in the database."""
+
+from abc import ABCMeta
+
+
+class IndexMixin(metaclass=ABCMeta):
+    """Contains the method for indexing the model in the database."""
+
+    @classmethod
+    async def indexing(cls) -> None:
+        """For set up and start indexing."""

ramifice/{mixins.py → utils/mixins/json_converter.py}

@@ -1,14 +1,11 @@
-"""Complect of mixins."""
+"""JsonMixin - Contains the methods for converting Fields to JSON and back."""
 
 import json
 from typing import Any
 
 
 class JsonMixin:
-    """Complect of methods for converting Fields to JSON and back.
-
-    For fields FileField and ImageField is used FileJsonMixin.
-    """
+    """Contains the methods for converting Fields to JSON and back."""
 
     def to_dict(self) -> dict[str, Any]:
         """Convert object instance to a dictionary."""

ramifice/{tools.py → utils/tools.py}

@@ -10,7 +10,7 @@ import phonenumbers
 from bson.objectid import ObjectId
 from email_validator import EmailNotValidError, validate_email
 
-from .store import REGEX
+from .globals import REGEX
 
 
 def is_password(password: str | None) -> bool:

ramifice/{types.py → utils/unit.py}

@@ -1,14 +1,7 @@
-"""Auxiliary types collection.
-
-These types are used to transfer information.
-
-The module contains the following types:
-
-- `Unit` - Used for data management in dynamic fields.
-"""
+"""Unit - Data management in dynamic fields."""
 
 from .errors import PanicError
-from .mixins import JsonMixin
+from .mixins.json_converter import JsonMixin
 
 
 class Unit(JsonMixin):

{ramifice-0.3.27.dist-info → ramifice-0.3.29.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ramifice
-Version: 0.3.27
+Version: 0.3.29
 Summary: ORM-like API MongoDB for Python language.
 Project-URL: Homepage, https://github.com/kebasyaty/ramifice
 Project-URL: Documentation, https://kebasyaty.github.io/ramifice/
@@ -134,9 +134,8 @@ import pprint
 from datetime import datetime
 
 from pymongo import AsyncMongoClient
-from ramifice import model, translations
+from ramifice import model, translations, migration
 from ramifice.fields import DateField, EmailField, ImageField, PasswordField, TextField
-from ramifice.migration import Monitor
 
 
 @model(service_name="Accounts")
@@ -192,7 +191,7 @@ class User:
 async def main():
     client = AsyncMongoClient()
 
-    await Monitor(
+    await migration.Monitor(
         database_name="test_db",
         mongo_client=client,
     ).migrat()
@@ -474,7 +473,7 @@ async for index in await User.list_indexes():
 # Units Management.
 # Management for `choices` parameter in dynamic field types.
 # Units are stored in a separate collection.
-from ramifice.types import Unit
+from ramifice.utils.unit import Unit
 unit = Unit(
   field="field_name",  # The name of the dynamic field.
   title="Title",  # The name of the choice item.
@@ -522,7 +521,7 @@ await user.update_password(  # + verify_password
 ## General auxiliary methods
 
 ```python
-from ramifice.tools import (
+from ramifice.utils.tools import (
     get_file_size,
     hash_to_obj_id,
     is_color,