scruby 0.12.0__py3-none-any.whl → 0.12.3__py3-none-any.whl

scruby/db.py

@@ -11,7 +11,7 @@ import zlib
 from collections.abc import Callable
 from pathlib import Path as SyncPath
 from shutil import rmtree
-from typing import Any, Never, TypeVar, assert_never
+from typing import Any, Literal, Never, TypeVar, assert_never
 
 import orjson
 from anyio import Path, to_thread
@@ -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,21 +102,19 @@ 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 = meta.model_dump_json()
         await meta_path.write_text(meta_json, "utf-8")
 
-    async def _counter_documents(self, number: int) -> None:
+    async def _counter_documents(self, step: Literal[1, -1]) -> None:
         """Asynchronous method for management of documents in 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("utf-8")
         meta: _Meta = self.__meta.model_validate_json(meta_json)
-        meta.counter_documents += number
-        if meta.counter_documents < 0:
-            meta.counter_documents = 0
+        meta.counter_documents += step
         meta_json = meta.model_dump_json()
         await meta_path.write_text(meta_json, "utf-8")
 
@@ -142,22 +123,10 @@ 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
-        if meta.counter_documents < 0:
-            meta.counter_documents = 0
         meta_json = meta.model_dump_json()
         meta_path.write_text(meta_json, "utf-8")
 

{scruby-0.12.0.dist-info → scruby-0.12.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scruby
-Version: 0.12.0
+Version: 0.12.3
 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.12.0.dist-info → scruby-0.12.3.dist-info}/RECORD

@@ -1,9 +1,9 @@
 scruby/__init__.py,sha256=GOVcjXmcOEDBbJQJDJlQq-x3M-VGJaMSN278EXsl2po,884
 scruby/constants.py,sha256=3LZfcxcuRqwzoB0-iogLMjKBZRdxfWJmTbyPwVRhQgY,1007
-scruby/db.py,sha256=fFJKCvvDmHKXzQubghG2DoRV7xumd460sHGqCDCCgh0,21877
+scruby/db.py,sha256=H70ODq0SXtEBB6iTBFA_l-fZ0L1zFq5Nb_PT3Ad2TZs,20925
 scruby/errors.py,sha256=aHQri4LNcFVQrSHwjyzb1fL8O49SwjYEU4QgMOo4uyA,622
 scruby/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-scruby-0.12.0.dist-info/METADATA,sha256=Ok-HJBIDsQ-DktJRjoIORaC91Vbc8qt9UPc-VN9k57Q,10925
-scruby-0.12.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-scruby-0.12.0.dist-info/licenses/LICENSE,sha256=2zZINd6m_jNYlowdQImlEizyhSui5cBAJZRhWQURcEc,1095
-scruby-0.12.0.dist-info/RECORD,,
+scruby-0.12.3.dist-info/METADATA,sha256=C7rNCceHMaFezgzg4TEvUR_vOivfvGG3bpgPOQrucLg,10925
+scruby-0.12.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+scruby-0.12.3.dist-info/licenses/LICENSE,sha256=2zZINd6m_jNYlowdQImlEizyhSui5cBAJZRhWQURcEc,1095
+scruby-0.12.3.dist-info/RECORD,,