scruby 0.30.2__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

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,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
-#
 """Creation and management of the database."""
 
 from __future__ import annotations

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

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,46 +10,16 @@ __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) -> Any:
+    async def run_custom_task(
+        self,
+        custom_task_fn: Callable,
+        filter_fn: Callable = lambda _: True,
+        **kwargs,
+    ) -> Any:
         """Running custom task.
 
         Attention:
@@ -63,12 +32,13 @@ class CustomTask:
         Returns:
             The result of a custom task.
         """
-        kwargs = {
-            "get_docs_fn": self._task_get_docs,
-            "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,
-        }
-        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

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(
@@ -109,7 +107,7 @@ class Find:
             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:

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

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

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.30.2.dist-info → scruby-0.31.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scruby
-Version: 0.30.2
+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
@@ -150,7 +150,7 @@ async def main() -> None:
     user = User(
         first_name="John",
         last_name="Smith",
-        birthday=datetime.datetime(1970, 1, 1, tzinfo=ZoneInfo("UTC")),
+        birthday=datetime(1970, 1, 1, tzinfo=ZoneInfo("UTC")),
         email="John_Smith@gmail.com",
         phone="+447986123456",
     )
@@ -186,7 +186,6 @@ The search effectiveness depends on the number of processor threads.
 """
 
 import anyio
-from datetime import datetime
 from typing import Annotated
 from pydantic import Field
 from scruby import Scruby, ScrubyModel, settings
@@ -262,7 +261,6 @@ The search effectiveness depends on the number of processor threads.
 """
 
 import anyio
-from datetime import datetime
 from typing import Annotated
 from pydantic import Field
 from scruby import Scruby, ScrubyModel, settings

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.30.2.dist-info/RECORD

@@ -1,18 +0,0 @@
-scruby/__init__.py,sha256=WuIA27d3uUK0Vo0fXg92hge7i6v_2DBndhfepK16_y8,1046
-scruby/aggregation.py,sha256=bd70J1Xye6faNHD8LS3lVQoHWKtPdPV_cqT_i7oui38,3491
-scruby/db.py,sha256=4bSPMh0fYil0j9qhHhRu1g4U_0WaCuaGPthnmi2QpBI,8376
-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=YHjonxAtroSc5AlbDX1vpCvbe3vsTD0LfYnjEDB001A,2089
-scruby/mixins/custom_task.py,sha256=ENr3FkCsPWRblOWv8jGMkkGKw4hvp9mMP2YjQvIeqzE,2246
-scruby/mixins/delete.py,sha256=b7RYiTLUqVu70ep15CN1VTyKs13P7f-1YDGRc3ke-2g,3085
-scruby/mixins/find.py,sha256=-rpILkxhfywJ5E3ceYo9dSPabma47ouceGajUVNh23Q,5396
-scruby/mixins/keys.py,sha256=waxye5n0-oTWIhdDXGQkUTGaV9vLSCc9lCryTCuexkw,6179
-scruby/mixins/update.py,sha256=WeNk2qZToQS3-r1_ahazBc2ErLMU9K5RRNgCxbu3JMg,3416
-scruby-0.30.2.dist-info/METADATA,sha256=OgV4Foj3-X97NKFLpw_8Qb_osGwmYIINO2UZkgdLaY0,11032
-scruby-0.30.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-scruby-0.30.2.dist-info/licenses/LICENSE,sha256=mS0Wz0yGNB63gEcWEnuIb_lldDYV0sjRaO-o_GL6CWE,1074
-scruby-0.30.2.dist-info/RECORD,,