scruby 0.12.2__py3-none-any.whl → 0.13.1__py3-none-any.whl

scruby/aggregation.py

@@ -0,0 +1,76 @@
+"""Aggregation classes."""
+
+from __future__ import annotations
+
+__all__ = (
+    "Average",
+    "Max",
+    "Min",
+    "Sum",
+)
+
+from typing import Any
+
+
+class Average:
+    """Aggregation class for calculating the average value."""
+
+    def __init__(self) -> None:  # noqa: D107
+        self.value = 0.0
+        self.counter = 0.0
+
+    def set(self, number: int | float) -> None:
+        """Add value."""
+        self.value += float(number)
+        self.counter += 1.0
+
+    def get(self) -> float:
+        """Get arithmetic average value."""
+        return self.value / self.counter
+
+
+class Max:
+    """Aggregation class for calculating the maximum value."""
+
+    def __init__(self) -> None:  # noqa: D107
+        self.value: Any = 0
+
+    def set(self, number: int | float) -> None:
+        """Add value."""
+        if number > self.value:
+            self.value = number
+
+    def get(self) -> Any:
+        """Get maximum value."""
+        return self.value
+
+
+class Min:
+    """Aggregation class for calculating the minimum value."""
+
+    def __init__(self) -> None:  # noqa: D107
+        self.value: Any = 0
+
+    def set(self, number: int | float) -> None:
+        """Add value."""
+        if self.value == 0 or number < self.value:
+            self.value = number
+
+    def get(self) -> Any:
+        """Get minimum value."""
+        return self.value
+
+
+class Sum:
+    """Aggregation class for calculating sum of values."""
+
+    def __init__(self) -> None:  # noqa: D107
+        self.value: Any = 0
+
+    def set(self, number: int | float) -> None:
+        """Add value."""
+        self.value += number
+
+    def get(self) -> Any:
+        """Get sum of values."""
+        return self.value

scruby/db.py

@@ -45,7 +45,7 @@ class Scruby[T]:
         self.__class_model = class_model
         self.__db_root = constants.DB_ROOT
         self.__hash_reduce_left = constants.HASH_REDUCE_LEFT
-        # The maximum number of keys.
+        # The maximum number of branches.
         match self.__hash_reduce_left:
             case 0:
                 self.__max_branch_number = 4294967296
@@ -59,18 +59,18 @@ class Scruby[T]:
                 msg: str = f"{unreachable} - Unacceptable value for HASH_REDUCE_LEFT."
                 logger.critical(msg)
                 assert_never(Never(unreachable))
-        # 1.Create metadata if absent.
-        # 2.Check metadata.
-        self._create_metadata()
-
-    def _create_metadata(self) -> None:
-        """Create metadata for collection if absent.
-
-        This method is for internal use.
-        """
+        # Caching a pati for metadata in the form of a tuple.
+        # The zero branch is reserved for metadata.
         branch_number: int = 0
-        key_as_hash: str = f"{branch_number:08x}"[self.__hash_reduce_left :]
-        separated_hash: str = "/".join(list(key_as_hash))
+        branch_number_as_hash: str = f"{branch_number:08x}"[constants.HASH_REDUCE_LEFT :]
+        separated_hash: str = "/".join(list(branch_number_as_hash))
+        self.__meta_path_tuple = (
+            constants.DB_ROOT,
+            class_model.__name__,
+            separated_hash,
+            "meta.json",
+        )
+        # Create metadata for collection, if required.
         branch_path = SyncPath(
             *(
                 self.__db_root,
@@ -87,29 +87,12 @@ class Scruby[T]:
             meta_path = SyncPath(*(branch_path, "meta.json"))
             meta_path.write_text(meta_json, "utf-8")
 
-    async def _get_meta_path(self) -> Path:
-        """Asynchronous method for getting path to metadata of collection.
-
-        This method is for internal use.
-        """
-        branch_number: int = 0
-        branch_number_as_hash: str = f"{branch_number:08x}"[self.__hash_reduce_left :]
-        separated_hash: str = "/".join(list(branch_number_as_hash))
-        return Path(
-            *(
-                self.__db_root,
-                self.__class_model.__name__,
-                separated_hash,
-                "meta.json",
-            ),
-        )
-
     async def _get_meta(self) -> _Meta:
         """Asynchronous method for getting metadata of collection.
 
         This method is for internal use.
         """
-        meta_path = await self._get_meta_path()
+        meta_path = Path(*self.__meta_path_tuple)
         meta_json = await meta_path.read_text()
         meta: _Meta = self.__meta.model_validate_json(meta_json)
         return meta
@@ -119,8 +102,8 @@ class Scruby[T]:
 
         This method is for internal use.
         """
-        meta_path = await self._get_meta_path()
         meta_json = meta.model_dump_json()
+        meta_path = Path(*self.__meta_path_tuple)
         await meta_path.write_text(meta_json, "utf-8")
 
     async def _counter_documents(self, step: Literal[1, -1]) -> None:
@@ -128,7 +111,7 @@ class Scruby[T]:
 
         This method is for internal use.
         """
-        meta_path = await self._get_meta_path()
+        meta_path = Path(*self.__meta_path_tuple)
         meta_json = await meta_path.read_text("utf-8")
         meta: _Meta = self.__meta.model_validate_json(meta_json)
         meta.counter_documents += step
@@ -140,17 +123,7 @@ class Scruby[T]:
 
         This method is for internal use.
         """
-        branch_number: int = 0
-        branch_number_as_hash: str = f"{branch_number:08x}"[self.__hash_reduce_left :]
-        separated_hash: str = "/".join(list(branch_number_as_hash))
-        meta_path = SyncPath(
-            *(
-                self.__db_root,
-                self.__class_model.__name__,
-                separated_hash,
-                "meta.json",
-            ),
-        )
+        meta_path = SyncPath(*self.__meta_path_tuple)
         meta_json = meta_path.read_text("utf-8")
         meta: _Meta = self.__meta.model_validate_json(meta_json)
         meta.counter_documents += number
@@ -495,13 +468,13 @@ class Scruby[T]:
             leaf_path.write_bytes(orjson.dumps(new_data))
         return counter
 
-    def find_many_and_delete(
+    def delete_many(
         self,
         filter_fn: Callable,
         max_workers: int | None = None,
         timeout: float | None = None,
     ) -> int:
-        """Finds one or more documents matching the filter and deletes their.
+        """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.

{scruby-0.12.2.dist-info → scruby-0.13.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scruby
-Version: 0.12.2
+Version: 0.13.1
 Summary: A fast key-value storage library.
 Project-URL: Homepage, https://github.com/kebasyaty/scruby
 Project-URL: Repository, https://github.com/kebasyaty/scruby

scruby-0.13.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+scruby/__init__.py,sha256=GOVcjXmcOEDBbJQJDJlQq-x3M-VGJaMSN278EXsl2po,884
+scruby/aggregation.py,sha256=AdVZNl9fV59pWMBQez5upQEuodAg3HIw0ixOnM8FrKg,1762
+scruby/constants.py,sha256=3LZfcxcuRqwzoB0-iogLMjKBZRdxfWJmTbyPwVRhQgY,1007
+scruby/db.py,sha256=OXtMqq9y6RQkHHWOgFVXqI96v7g58SIoLUq-h09WxjI,20899
+scruby/errors.py,sha256=aHQri4LNcFVQrSHwjyzb1fL8O49SwjYEU4QgMOo4uyA,622
+scruby/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+scruby-0.13.1.dist-info/METADATA,sha256=LlJPM_ZrH1yhQA7Yk0owqfigwt72Z2gRIVlDFdJ1cL4,10925
+scruby-0.13.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+scruby-0.13.1.dist-info/licenses/LICENSE,sha256=2zZINd6m_jNYlowdQImlEizyhSui5cBAJZRhWQURcEc,1095
+scruby-0.13.1.dist-info/RECORD,,

scruby-0.12.2.dist-info/RECORD

@@ -1,9 +0,0 @@
-scruby/__init__.py,sha256=GOVcjXmcOEDBbJQJDJlQq-x3M-VGJaMSN278EXsl2po,884
-scruby/constants.py,sha256=3LZfcxcuRqwzoB0-iogLMjKBZRdxfWJmTbyPwVRhQgY,1007
-scruby/db.py,sha256=-xNn0S2fcIQoar4fYk6ER2p7dlDIeUY-BAD6LLYtFFo,21733
-scruby/errors.py,sha256=aHQri4LNcFVQrSHwjyzb1fL8O49SwjYEU4QgMOo4uyA,622
-scruby/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-scruby-0.12.2.dist-info/METADATA,sha256=YK-ZgnJEcS7y0R27hh7GTlRSAexq5H9olStIQKZL7sc,10925
-scruby-0.12.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-scruby-0.12.2.dist-info/licenses/LICENSE,sha256=2zZINd6m_jNYlowdQImlEizyhSui5cBAJZRhWQURcEc,1095
-scruby-0.12.2.dist-info/RECORD,,