scruby 0.28.3__py3-none-any.whl → 0.31.0__py3-none-any.whl

scruby/__init__.py

@@ -1,4 +1,3 @@
-#
 # .dP"Y8  dP""b8 88""Yb 88   88 88""Yb Yb  dP
 # `Ybo." dP   `" 88__dP 88   88 88__dP  YbdP
 # o.`Y8b Yb      88"Yb  Y8   8P 88""Yb   8P
@@ -6,7 +5,6 @@
 #
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 
 The library uses fractal-tree addressing and
@@ -28,7 +26,8 @@ from __future__ import annotations
 __all__ = (
     "settings",
     "Scruby",
+    "ScrubyModel",
 )
 
 from scruby import settings
-from scruby.db import Scruby
+from scruby.db import Scruby, ScrubyModel

scruby/aggregation.py

@@ -1,7 +1,6 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Aggregation classes."""
 
 from __future__ import annotations

scruby/db.py

@@ -1,17 +1,20 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Creation and management of the database."""
 
 from __future__ import annotations
 
-__all__ = ("Scruby",)
+__all__ = (
+    "Scruby",
+    "ScrubyModel",
+)
 
 import contextlib
 import logging
 import re
 import zlib
+from datetime import datetime
 from shutil import rmtree
 from typing import Any, Literal, Never, assert_never
 
@@ -31,6 +34,13 @@ class _Meta(BaseModel):
     counter_documents: int
 
 
+class ScrubyModel(BaseModel):
+    """Additional fields for models."""
+
+    created_at: datetime | None = None
+    updated_at: datetime | None = None
+
+
 class Scruby(
     mixins.Keys,
     mixins.Find,
@@ -53,13 +63,13 @@ class Scruby(
         # The maximum number of branches.
         match self._hash_reduce_left:
             case 0:
-                self._max_branch_number = 4294967296
+                self._max_number_branch = 4294967296
             case 2:
-                self._max_branch_number = 16777216
+                self._max_number_branch = 16777216
             case 4:
-                self._max_branch_number = 65536
+                self._max_number_branch = 65536
             case 6:
-                self._max_branch_number = 256
+                self._max_number_branch = 256
             case _ as unreachable:
                 msg: str = f"{unreachable} - Unacceptable value for HASH_REDUCE_LEFT."
                 logging.critical(msg)
@@ -70,42 +80,67 @@ class Scruby(
         """Get an object to access a collection.
 
         Args:
-            class_model: Class of Model (pydantic.BaseModel).
+            class_model (Any): Class of Model (ScrubyModel).
 
         Returns:
             Instance of Scruby for access a collection.
         """
-        assert BaseModel in class_model.__bases__, "`class_model` does not contain the base class `pydantic.BaseModel`!"
-
+        if __debug__:
+            # Check if the object belongs to the class `ScrubyModel`
+            if ScrubyModel not in class_model.__bases__:
+                msg = (
+                    "Method: `collection` => argument `class_model` " + "does not contain the base class `ScrubyModel`!"
+                )
+                raise AssertionError(msg)
+            # Checking the model for the presence of a key.
+            model_fields = list(class_model.model_fields.keys())
+            if "key" not in model_fields:
+                msg = f"Model: {class_model.__name__} => The `key` field is missing!"
+                raise AssertionError(msg)
+            if "created_at" not in model_fields:
+                msg = f"Model: {class_model.__name__} => The `created_at` field is missing!"
+                raise AssertionError(msg)
+            if "updated_at" not in model_fields:
+                msg = f"Model: {class_model.__name__} => The `updated_at` field is missing!"
+                raise AssertionError(msg)
+            # Check the length of the collection name for an acceptable size.
+            len_db_root_absolut_path = len(str(await Path(settings.DB_ROOT).resolve()).encode("utf-8"))
+            len_model_name = len(class_model.__name__)
+            len_full_path_leaf = len_db_root_absolut_path + len_model_name + 26
+            if len_full_path_leaf > 255:
+                excess = len_full_path_leaf - 255
+                msg = (
+                    f"Model: {class_model.__name__} => The collection name is too long, "
+                    + f"it exceeds the limit of {excess} characters!"
+                )
+                raise AssertionError(msg)
+        # Create instance of Scruby
         instance = cls()
+        # Add model class to Scruby
         instance.__dict__["_class_model"] = class_model
-        # Caching a pati for metadata.
-        # The zero branch is reserved for metadata.
-        branch_number: int = 0
-        branch_number_as_hash: str = f"{branch_number:08x}"[settings.HASH_REDUCE_LEFT :]
-        separated_hash: str = "/".join(list(branch_number_as_hash))
+        # Create a path for metadata.
         meta_dir_path_tuple = (
             settings.DB_ROOT,
             class_model.__name__,
-            separated_hash,
+            "meta",
         )
         instance.__dict__["_meta_path"] = Path(
             *meta_dir_path_tuple,
             "meta.json",
         )
         # Create metadata for collection, if missing.
-        branch_path = Path(*meta_dir_path_tuple)
-        if not await branch_path.exists():
-            await branch_path.mkdir(parents=True)
+        meta_dir_path = Path(*meta_dir_path_tuple)
+        if not await meta_dir_path.exists():
+            await meta_dir_path.mkdir(parents=True)
             meta = _Meta(
                 db_root=settings.DB_ROOT,
                 collection_name=class_model.__name__,
                 hash_reduce_left=settings.HASH_REDUCE_LEFT,
-                max_branch_number=instance.__dict__["_max_branch_number"],
+                max_branch_number=instance.__dict__["_max_number_branch"],
                 counter_documents=0,
             )
             meta_json = meta.model_dump_json()
-            meta_path = Path(*(branch_path, "meta.json"))
+            meta_path = Path(*(meta_dir_path, "meta.json"))
             await meta_path.write_text(meta_json, "utf-8")
         return instance
 

scruby/errors.py

@@ -1,7 +1,6 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Scruby Exceptions."""
 
 from __future__ import annotations

scruby/mixins/__init__.py

@@ -1,7 +1,6 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Mixins."""
 
 from __future__ import annotations

scruby/mixins/collection.py

@@ -1,7 +1,6 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Methods for working with collections."""
 
 from __future__ import annotations

scruby/mixins/count.py

@@ -1,7 +1,6 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Methods for counting the number of documents."""
 
 from __future__ import annotations
@@ -31,18 +30,19 @@ class Count:
     ) -> int:
         """Count the number of documents a matching the filter in this collection.
 
-        The search is based on the effect of a quantum loop.
-        The search effectiveness depends on the number of processor threads.
+        Attention:
+            - The search is based on the effect of a quantum loop.
+            - The search effectiveness depends on the number of processor threads.
 
         Args:
-            filter_fn: A function that execute the conditions of filtering.
+            filter_fn (Callable): A function that execute the conditions of filtering.
 
         Returns:
             The number of documents.
         """
         # Variable initialization
         search_task_fn: Callable = self._task_find
-        branch_numbers: range = range(1, self._max_branch_number)
+        branch_numbers: range = range(self._max_number_branch)
         hash_reduce_left: int = self._hash_reduce_left
         db_root: str = self._db_root
         class_model: Any = self._class_model

scruby/mixins/custom_task.py

@@ -1,7 +1,6 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Quantum methods for running custom tasks."""
 
 from __future__ import annotations
@@ -11,64 +10,35 @@ __all__ = ("CustomTask",)
 from collections.abc import Callable
 from typing import Any
 
-import orjson
-from anyio import Path
-
 
 class CustomTask:
     """Quantum methods for running custom tasks."""
 
-    @staticmethod
-    async def _task_get_docs(
-        branch_number: int,
-        hash_reduce_left: int,
-        db_root: str,
-        class_model: Any,
-    ) -> list[Any]:
-        """Get documents for custom task.
-
-        This method is for internal use.
-
-        Returns:
-            List of documents.
-        """
-        branch_number_as_hash: str = f"{branch_number:08x}"[hash_reduce_left:]
-        separated_hash: str = "/".join(list(branch_number_as_hash))
-        leaf_path: Path = Path(
-            *(
-                db_root,
-                class_model.__name__,
-                separated_hash,
-                "leaf.json",
-            ),
-        )
-        docs: list[Any] = []
-        if await leaf_path.exists():
-            data_json: bytes = await leaf_path.read_bytes()
-            data: dict[str, str] = orjson.loads(data_json) or {}
-            for _, val in data.items():
-                docs.append(class_model.model_validate_json(val))
-        return docs
-
-    async def run_custom_task(self, custom_task_fn: Callable, limit_docs: int = 1000) -> Any:
+    async def run_custom_task(
+        self,
+        custom_task_fn: Callable,
+        filter_fn: Callable = lambda _: True,
+        **kwargs,
+    ) -> Any:
         """Running custom task.
 
-        This method running a task created on the basis of a quantum loop.
-        Effectiveness running task depends on the number of processor threads.
+        Attention:
+            - The search is based on the effect of a quantum loop.
+            - The search effectiveness depends on the number of processor threads.
 
         Args:
-            custom_task_fn: A function that execute the custom task.
-            limit_docs: Limiting the number of documents. By default = 1000.
+            custom_task_fn (Callable): A function that execute the custom task.
 
         Returns:
             The result of a custom task.
         """
-        kwargs = {
-            "get_docs_fn": self._task_get_docs,
-            "branch_numbers": range(1, self._max_branch_number),
-            "hash_reduce_left": self._hash_reduce_left,
-            "db_root": self._db_root,
-            "class_model": self._class_model,
-            "limit_docs": limit_docs,
-        }
-        return await custom_task_fn(**kwargs)
+        return await custom_task_fn(
+            search_task_fn=self._task_find,
+            filter_fn=filter_fn,
+            branch_numbers=range(self._max_number_branch),
+            hash_reduce_left=self._hash_reduce_left,
+            db_root=self._db_root,
+            class_model=self._class_model,
+            max_workers=self._max_workers,
+            **kwargs,
+        )

scruby/mixins/delete.py

@@ -1,7 +1,6 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Methods for deleting documents."""
 
 from __future__ import annotations
@@ -64,18 +63,19 @@ class Delete:
     ) -> int:
         """Delete one or more documents matching the filter.
 
-        The search is based on the effect of a quantum loop.
-        The search effectiveness depends on the number of processor threads.
+        Attention:
+            - The search is based on the effect of a quantum loop.
+            - The search effectiveness depends on the number of processor threads.
 
         Args:
-            filter_fn: A function that execute the conditions of filtering.
+            filter_fn (Callable): A function that execute the conditions of filtering.
 
         Returns:
             The number of deleted documents.
         """
         # Variable initialization
         search_task_fn: Callable = self._task_delete
-        branch_numbers: range = range(1, self._max_branch_number)
+        branch_numbers: range = range(self._max_number_branch)
         hash_reduce_left: int = self._hash_reduce_left
         db_root: str = self._db_root
         class_model: Any = self._class_model

scruby/mixins/find.py

@@ -1,7 +1,6 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Quantum methods for searching documents."""
 
 from __future__ import annotations
@@ -34,7 +33,6 @@ class Find:
         Returns:
             List of documents or None.
         """
-        # Variable initialization
         branch_number_as_hash: str = f"{branch_number:08x}"[hash_reduce_left:]
         separated_hash: str = "/".join(list(branch_number_as_hash))
         leaf_path: Path = Path(
@@ -61,8 +59,9 @@ class Find:
     ) -> Any | None:
         """Find one document matching the filter.
 
-        The search is based on the effect of a quantum loop.
-        The search effectiveness depends on the number of processor threads.
+        Attention:
+            - The search is based on the effect of a quantum loop.
+            - The search effectiveness depends on the number of processor threads.
 
         Args:
             filter_fn (Callable): A function that execute the conditions of filtering.
@@ -72,7 +71,7 @@ class Find:
         """
         # Variable initialization
         search_task_fn: Callable = self._task_find
-        branch_numbers: range = range(1, self._max_branch_number)
+        branch_numbers: range = range(self._max_number_branch)
         hash_reduce_left: int = self._hash_reduce_left
         db_root: str = self._db_root
         class_model: Any = self._class_model
@@ -100,14 +99,15 @@ class Find:
     ) -> list[Any] | None:
         """Find many documents matching the filter.
 
-        The search is based on the effect of a quantum loop.
-        The search effectiveness depends on the number of processor threads.
+        Attention:
+            - The search is based on the effect of a quantum loop.
+            - The search effectiveness depends on the number of processor threads.
 
         Args:
             filter_fn (Callable): A function that execute the conditions of filtering.
                                   By default it searches for all documents.
             limit_docs (int): Limiting the number of documents. By default = 1000.
-            page_number (int): For pagination output. By default = 1.
+            page_number (int): For pagination. By default = 1.
                                Number of documents per page = limit_docs.
 
         Returns:
@@ -117,7 +117,7 @@ class Find:
         assert page_number > 0, "`find_many` => The `page_number` parameter must not be less than one."
         # Variable initialization
         search_task_fn: Callable = self._task_find
-        branch_numbers: range = range(1, self._max_branch_number)
+        branch_numbers: range = range(self._max_number_branch)
         hash_reduce_left: int = self._hash_reduce_left
         db_root: str = self._db_root
         class_model: Any = self._class_model

scruby/mixins/keys.py

@@ -1,7 +1,6 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Methods for working with keys."""
 
 from __future__ import annotations
@@ -9,7 +8,9 @@ from __future__ import annotations
 __all__ = ("Keys",)
 
 import logging
+from datetime import datetime
 from typing import Any
+from zoneinfo import ZoneInfo
 
 import orjson
 
@@ -26,7 +27,7 @@ class Keys:
         """Asynchronous method for adding document to collection.
 
         Args:
-            doc: Value of key. Type, derived from `BaseModel`.
+            doc (Any): Value of key. Type, derived from `ScrubyModel`.
 
         Returns:
             None.
@@ -42,6 +43,11 @@ class Keys:
             raise TypeError(msg)
         # The path to cell of collection.
         leaf_path, prepared_key = await self._get_leaf_path(doc.key)
+        # Init a `created_at` and `updated_at` fields
+        tz = ZoneInfo("UTC")
+        doc.created_at = datetime.now(tz)
+        doc.updated_at = datetime.now(tz)
+        # Convert doc to json
         doc_json: str = doc.model_dump_json()
         # Write key-value to collection.
         if await leaf_path.exists():
@@ -63,10 +69,10 @@ class Keys:
         await self._counter_documents(1)
 
     async def update_doc(self, doc: Any) -> None:
-        """Asynchronous method for updating key to collection.
+        """Asynchronous method for updating document to collection.
 
         Args:
-            doc: Value of key. Type `BaseModel`.
+            doc (Any): Value of key. Type `ScrubyModel`.
 
         Returns:
             None.
@@ -83,6 +89,9 @@ class Keys:
             raise TypeError(msg)
         # The path to cell of collection.
         leaf_path, prepared_key = await self._get_leaf_path(doc.key)
+        # Update a `updated_at` field
+        doc.updated_at = datetime.now(ZoneInfo("UTC"))
+        # Convert doc to json
         doc_json: str = doc.model_dump_json()
         # Update the existing key.
         if await leaf_path.exists():
@@ -98,14 +107,15 @@ class Keys:
                 logging.error(err.message)
                 raise err from None
         else:
-            logging.error("The key not exists.")
-            raise KeyError()
+            msg: str = f"`update_doc` - The key `{doc.key}` is missing!"
+            logging.error(msg)
+            raise KeyError(msg)
 
-    async def get_key(self, key: str) -> Any:
-        """Asynchronous method for getting value of key from collection.
+    async def get_doc(self, key: str) -> Any:
+        """Asynchronous method for getting document from collection the by key.
 
         Args:
-            key: Key name.
+            key (str): Key name.
 
         Returns:
             Value of key or KeyError.
@@ -118,15 +128,15 @@ class Keys:
             data: dict = orjson.loads(data_json) or {}
             obj: Any = self._class_model.model_validate_json(data[prepared_key])
             return obj
-        msg: str = "`get_key` - The unacceptable key value."
+        msg: str = f"`get_doc` - The key `{key}` is missing!"
         logging.error(msg)
-        raise KeyError()
+        raise KeyError(msg)
 
     async def has_key(self, key: str) -> bool:
         """Asynchronous method for checking presence of key in collection.
 
         Args:
-            key: Key name.
+            key (str): Key name.
 
         Returns:
             True, if the key is present.
@@ -144,11 +154,11 @@ class Keys:
                 return False
         return False
 
-    async def delete_key(self, key: str) -> None:
-        """Asynchronous method for deleting key from collection.
+    async def delete_doc(self, key: str) -> None:
+        """Asynchronous method for deleting document from collection the by key.
 
         Args:
-            key: Key name.
+            key (str): Key name.
 
         Returns:
             None.
@@ -163,6 +173,6 @@ class Keys:
             await leaf_path.write_bytes(orjson.dumps(data))
             await self._counter_documents(-1)
             return
-        msg: str = "`delete_key` - The unacceptable key value."
+        msg: str = f"`delete_doc` - The key `{key}` is missing!"
         logging.error(msg)
-        raise KeyError()
+        raise KeyError(msg)

scruby/mixins/update.py

@@ -1,7 +1,6 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Methods for updating documents."""
 
 from __future__ import annotations
@@ -62,24 +61,27 @@ class Update:
 
     async def update_many(
         self,
-        filter_fn: Callable,
         new_data: dict[str, Any],
+        filter_fn: Callable = lambda _: True,
     ) -> int:
-        """Updates one or more documents matching the filter.
+        """Updates many documents matching the filter.
 
-        The search is based on the effect of a quantum loop.
-        The search effectiveness depends on the number of processor threads.
+        Attention:
+            - For a complex case, a custom task may be needed.
+            - See documentation on creating custom tasks.
+            - The search is based on the effect of a quantum loop.
+            - The search effectiveness depends on the number of processor threads.
 
         Args:
-            filter_fn: A function that execute the conditions of filtering.
-            new_data: New data for the fields that need to be updated.
+            filter_fn (Callable): A function that execute the conditions of filtering.
+            new_data (dict[str, Any]): New data for the fields that need to be updated.
 
         Returns:
             The number of updated documents.
         """
         # Variable initialization
         update_task_fn: Callable = self._task_update
-        branch_numbers: range = range(1, self._max_branch_number)
+        branch_numbers: range = range(self._max_number_branch)
         hash_reduce_left: int = self._hash_reduce_left
         db_root: str = self._db_root
         class_model: Any = self._class_model

scruby/settings.py

@@ -1,7 +1,6 @@
 # Scruby - Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 # Copyright (c) 2025 Gennady Kostyunin
 # SPDX-License-Identifier: MIT
-#
 """Database settings.
 
 The module contains the following parameters:

{scruby-0.28.3.dist-info → scruby-0.31.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scruby
-Version: 0.28.3
+Version: 0.31.0
 Summary: Asynchronous library for building and managing a hybrid database, by scheme of key-value.
 Project-URL: Homepage, https://kebasyaty.github.io/scruby/
 Project-URL: Repository, https://github.com/kebasyaty/scruby
@@ -99,6 +99,15 @@ Online browsable documentation is available at [https://kebasyaty.github.io/scru
 uv add scruby
 ```
 
+## Run
+
+```shell
+# Run Development:
+uv run python main.py
+# Run Production:
+uv run python -OOP main.py
+```
+
 ## Usage
 
 See more examples here [https://kebasyaty.github.io/scruby/latest/pages/usage/](https://kebasyaty.github.io/scruby/latest/pages/usage/ "Examples").
@@ -107,24 +116,25 @@ See more examples here [https://kebasyaty.github.io/scruby/latest/pages/usage/](
 """Working with keys."""
 
 import anyio
-import datetime
+from datetime import datetime
+from zoneinfo import ZoneInfo
 from typing import Annotated
-from pydantic import BaseModel, EmailStr, Field
+from pydantic import EmailStr, Field
 from pydantic_extra_types.phone_numbers import PhoneNumber, PhoneNumberValidator
-from scruby import Scruby, settings
+from scruby import Scruby, ScrubyModel, settings
 
 settings.DB_ROOT = "ScrubyDB"  # By default = "ScrubyDB"
 settings.HASH_REDUCE_LEFT = 6  # By default = 6
 settings.MAX_WORKERS = None  # By default = None
 
-class User(BaseModel):
+class User(ScrubyModel):
     """User model."""
     first_name: str = Field(strict=True)
     last_name: str = Field(strict=True)
-    birthday: datetime.datetime = Field(strict=True)
+    birthday: datetime = Field(strict=True)
     email: EmailStr = Field(strict=True)
     phone: Annotated[PhoneNumber, PhoneNumberValidator(number_format="E164")] = Field(frozen=True)
-    # The key is always at the bottom
+    # key is always at bottom
     key: str = Field(
         strict=True,
         frozen=True,
@@ -140,7 +150,7 @@ async def main() -> None:
     user = User(
         first_name="John",
         last_name="Smith",
-        birthday=datetime.datetime(1970, 1, 1),
+        birthday=datetime(1970, 1, 1, tzinfo=ZoneInfo("UTC")),
         email="John_Smith@gmail.com",
         phone="+447986123456",
     )
@@ -149,15 +159,15 @@ async def main() -> None:
 
     await user_coll.update_doc(user)
 
-    await user_coll.get_key("+447986123456")  # => user
-    await user_coll.get_key("key missing")  # => KeyError
+    await user_coll.get_doc("+447986123456")  # => user
+    await user_coll.get_doc("key missing")  # => KeyError
 
     await user_coll.has_key("+447986123456")  # => True
     await user_coll.has_key("key missing")  # => False
 
-    await user_coll.delete_key("+447986123456")
-    await user_coll.delete_key("+447986123456")  # => KeyError
-    await user_coll.delete_key("key missing")  # => KeyError
+    await user_coll.delete_doc("+447986123456")
+    await user_coll.delete_doc("+447986123456")  # => KeyError
+    await user_coll.delete_doc("key missing")  # => KeyError
 
     # Full database deletion.
     # Hint: The main purpose is tests.
@@ -176,10 +186,9 @@ The search effectiveness depends on the number of processor threads.
 """
 
 import anyio
-import datetime
 from typing import Annotated
-from pydantic import BaseModel, Field
-from scruby import Scruby, settings
+from pydantic import Field
+from scruby import Scruby, ScrubyModel, settings
 from pprint import pprint as pp
 
 settings.DB_ROOT = "ScrubyDB"  # By default = "ScrubyDB"
@@ -187,13 +196,13 @@ settings.HASH_REDUCE_LEFT = 6  # By default = 6
 settings.MAX_WORKERS = None  # By default = None
 
 
-class Phone(BaseModel):
+class Phone(ScrubyModel):
     """Phone model."""
     brand: str = Field(strict=True, frozen=True)
     model: str = Field(strict=True, frozen=True)
     screen_diagonal: float = Field(strict=True)
     matrix_type: str = Field(strict=True)
-    # The key is always at the bottom
+    # key is always at bottom
     key: str = Field(
         strict=True,
         frozen=True,
@@ -252,10 +261,9 @@ The search effectiveness depends on the number of processor threads.
 """
 
 import anyio
-import datetime
 from typing import Annotated
-from pydantic import BaseModel, Field
-from scruby import Scruby, settings
+from pydantic import Field
+from scruby import Scruby, ScrubyModel, settings
 from pprint import pprint as pp
 
 settings.DB_ROOT = "ScrubyDB"  # By default = "ScrubyDB"
@@ -263,13 +271,13 @@ settings.HASH_REDUCE_LEFT = 6  # By default = 6
 settings.MAX_WORKERS = None  # By default = None
 
 
-class Car(BaseModel):
+class Car(ScrubyModel):
     """Car model."""
     brand: str = Field(strict=True, frozen=True)
     model: str = Field(strict=True, frozen=True)
     year: int = Field(strict=True)
     power_reserve: int = Field(strict=True)
-    # The key is always at the bottom
+    # key is always at bottom
     key: str = Field(
         strict=True,
         frozen=True,

scruby-0.31.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+scruby/__init__.py,sha256=m5VkmOTqVzfHsLb7eIfGTdBpWPwEayrRDpAilUuksGc,1042
+scruby/aggregation.py,sha256=ooDN2KShP_JwIpIqxz7wL6gtBdd4oCSFk_3BhnD2o50,3489
+scruby/db.py,sha256=EVrMfHYWZr9ZEyU7b2fMBqSKeh0fEJnjbihQhMNVJak,8374
+scruby/errors.py,sha256=F51l5eyJuuMrwPeiIy6IGc1GqMsrGuS6l_B0e0Y6xWs,1295
+scruby/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+scruby/settings.py,sha256=g2AYH8QorjoTYxMceWotFL9X3F2mQnKDl9dlgmSLa5c,1578
+scruby/mixins/__init__.py,sha256=9geOyHcfWV4hilYs76whiEUOK2aZtgeC0fg2K0qvUOk,625
+scruby/mixins/collection.py,sha256=SZ2yvPPPPu_Cg9pfqu_RM0YB6hkhikwmuE13sATeUtE,1380
+scruby/mixins/count.py,sha256=gYX7ttHjHINZjSWa6FjzMZnqwEQO9kj5Ehl7Hkcs-2E,2087
+scruby/mixins/custom_task.py,sha256=tHZSo6IdZL5Yu46S-c7Ac3ImxGhwzPoQm4Dp4O8bqLs,1320
+scruby/mixins/delete.py,sha256=ng0xXM9mKQy5iq04WCyDm2AseETzEV7PgQOeDzUe-uU,3083
+scruby/mixins/find.py,sha256=5X0PNvLtsPq8s9J-lNFrhT9Pmqn4qSYUmSsV9yCl3VE,5353
+scruby/mixins/keys.py,sha256=ybCHefGgxXNCYMKxgRhlXXW1CLcv2BGKff3S8E1y2JI,6177
+scruby/mixins/update.py,sha256=PWrF1lvuMOHIlsrfXMB6jfCFEGbpqXor-CzH5X0b3VE,3414
+scruby-0.31.0.dist-info/METADATA,sha256=f1Ad9XPgW1euUdbxe0SbxpKQ0qjiybSMADCu_e4QxPw,10963
+scruby-0.31.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+scruby-0.31.0.dist-info/licenses/LICENSE,sha256=mS0Wz0yGNB63gEcWEnuIb_lldDYV0sjRaO-o_GL6CWE,1074
+scruby-0.31.0.dist-info/RECORD,,

scruby-0.28.3.dist-info/RECORD

@@ -1,18 +0,0 @@
-scruby/__init__.py,sha256=bw2Le5ULYlf2nFQT_617rmEumu66Ll-QCLCxqDFERWw,1014
-scruby/aggregation.py,sha256=bd70J1Xye6faNHD8LS3lVQoHWKtPdPV_cqT_i7oui38,3491
-scruby/db.py,sha256=djo4JkfuKCcV3jRbd2L3mIwENS3ptqJBt7SlAuiRhGY,6794
-scruby/errors.py,sha256=D0jisudUsZk9iXp4nRSymaSMwyqHPVshsSlxx4HDVVk,1297
-scruby/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-scruby/settings.py,sha256=_uVdZIGWoi6q9zcu0c2PS51OBEBNASRRrxfzaF7Nwy0,1580
-scruby/mixins/__init__.py,sha256=XPMjJvOZN7dLpTE1FfGMBGQ_0421HXug-0rWKMU5fRQ,627
-scruby/mixins/collection.py,sha256=coF-IOhicV_EihDwnYf6SW5Mfi3nOFR0gAhCc619NmI,1382
-scruby/mixins/count.py,sha256=PGzRtgLvseQnHg6wt-A81s30pnsdY1d8cr-EQRnbfyU,2050
-scruby/mixins/custom_task.py,sha256=ZhvCDiYnJ8BTIWlnRu6cTH-9G9o7dHSixjMIsxAtDpw,2316
-scruby/mixins/delete.py,sha256=B2loiowj8ToO0euumDRxpHUVrLQx0iTcRys0jszn-rA,3046
-scruby/mixins/find.py,sha256=gnHjnm0MZbzMHmWOBUJbMm8LZFBqdJ6yWA6Pxfap51Q,5340
-scruby/mixins/keys.py,sha256=OUByWbHfNVWJVkUrhCsJZdVqf0zez_an6Gti2n5iKnM,5671
-scruby/mixins/update.py,sha256=YkUiz1gcVtNXdgf7Mmda-0g3vJm3jL09v-msGy2tAWg,3229
-scruby-0.28.3.dist-info/METADATA,sha256=DoDzTEj_wrZu3EfAhBcKBtCfbr9pb74FS3spyDpFfzY,10849
-scruby-0.28.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-scruby-0.28.3.dist-info/licenses/LICENSE,sha256=mS0Wz0yGNB63gEcWEnuIb_lldDYV0sjRaO-o_GL6CWE,1074
-scruby-0.28.3.dist-info/RECORD,,