persidict 0.30.0__tar.gz → 0.31.1__tar.gz

{persidict-0.30.0 → persidict-0.31.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: persidict
-Version: 0.30.0
+Version: 0.31.1
 Summary: Simple persistent key-value store for Python. Values are stored as files on a disk or as S3 objects on AWS cloud.
 Keywords: persistence,dicts,distributed,parallel
 Author: Vlad (Volodymyr) Pavlov

{persidict-0.30.0 → persidict-0.31.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "persidict"
-version = "0.30.0"
+version = "0.31.1"
 description = "Simple persistent key-value store for Python. Values are stored as files on a disk or as S3 objects on AWS cloud."
 readme = "README.md"
 requires-python = ">=3.10"

{persidict-0.30.0 → persidict-0.31.1}/src/persidict/__init__.py

@@ -29,4 +29,5 @@ from .file_dir_dict import FileDirDict
 from .s3_dict import S3Dict
 from .write_once_dict import WriteOnceDict
 from .jokers import Joker, KeepCurrentFlag, DeleteCurrentFlag
-from .jokers import KEEP_CURRENT, DELETE_CURRENT
+from .jokers import KEEP_CURRENT, DELETE_CURRENT
+from .overlapping_multi_dict import OverlappingMultiDict

{persidict-0.30.0 → persidict-0.31.1}/src/persidict/file_dir_dict.py

@@ -19,6 +19,7 @@ import jsonpickle
 import jsonpickle.ext.numpy as jsonpickle_numpy
 import jsonpickle.ext.pandas as jsonpickle_pandas
 import parameterizable
+from parameterizable import sort_dict_by_keys
 
 from .jokers import KEEP_CURRENT, DELETE_CURRENT, Joker
 from .safe_chars import replace_unsafe_chars
@@ -124,7 +125,7 @@ class FileDirDict(PersiDict):
             base_dir=self.base_dir
             , file_type=self.file_type)
         params.update(additional_params)
-        sorted_params = dict(sorted(params.items()))
+        sorted_params = sort_dict_by_keys(params)
         return sorted_params
 
 

persidict-0.31.1/src/persidict/overlapping_multi_dict.py

@@ -0,0 +1,57 @@
+from .persi_dict import PersiDict
+
+class OverlappingMultiDict:
+    """A class that holds several PersiDict objects with different fyle_type-s.
+
+    The class is designed to be used as a container for several PersiDict objects
+    that have different file_type-s. All inner PersiDict objects
+    have the same dir_name attribute. Each inner PersiDict object is accessible
+    as an attribute of the OverlappingMultiDict object.
+    The attribute name is the same as the file_type
+    of the inner PersiDict object.
+
+    OverlappingMultiDict allows to store several PersiDict objects
+    in a single object, which can be useful for managing multiple types of data
+    in a single file directory or in an s3 bucket.
+
+    """
+    def __init__(self
+                 , dict_type:type
+                 , shared_subdicts_params:dict
+                 , **individual_subdicts_params):
+        assert issubclass(dict_type, PersiDict)
+        assert isinstance(shared_subdicts_params, dict)
+        self.dict_type = dict_type
+        self.shared_subdicts_params = shared_subdicts_params
+        self.individual_subdicts_params = individual_subdicts_params
+        self.subdicts_names = list(individual_subdicts_params.keys())
+        for subdict_name in individual_subdicts_params:
+            assert isinstance(individual_subdicts_params[subdict_name], dict)
+            self.__dict__[subdict_name] = dict_type(
+                **{**shared_subdicts_params
+                ,**individual_subdicts_params[subdict_name]
+                ,"file_type":subdict_name})
+
+        def __getstate__(self):
+            raise TypeError("OverlappingMultiDict cannot be pickled.")
+
+        def __setstate__(self, state):
+            raise TypeError("OverlappingMultiDict cannot be pickled.")
+
+        def __getitem__(self, key):
+            raise TypeError(
+                "OverlappingMultiDict does not support item access by key. "
+                "Individual items should be accessed through nested dicts, "
+                f"which are available via attributes {self.subdicts_names}")
+
+        def __setitem__(self, key, value):
+            raise TypeError(
+                "OverlappingMultiDict does not support item assignment by key. "
+                "Individual items should be accessed through nested dicts, "
+                 f"which are available via attributes {self.subdicts_names}")
+
+        def __delitem__(self, key):
+            raise TypeError(
+                "OverlappingMultiDict does not support item deletion by key. "
+                "Individual items can be deletedthrough nested dicts, "
+                f"which are available via attributes {self.subdicts_names}")

{persidict-0.30.0 → persidict-0.31.1}/src/persidict/persi_dict.py

@@ -22,7 +22,7 @@ from __future__ import annotations
 
 from abc import abstractmethod
 import random
-from parameterizable import ParameterizableClass
+from parameterizable import ParameterizableClass, sort_dict_by_keys
 from typing import Any, Sequence, Optional
 from collections.abc import MutableMapping
 
@@ -107,7 +107,7 @@ class PersiDict(MutableMapping, ParameterizableClass):
             , digest_len=self.digest_len
             , base_class_for_values=self.base_class_for_values
         )
-        sorted_params = dict(sorted(params.items()))
+        sorted_params = sort_dict_by_keys(params)
         return sorted_params
 
 

{persidict-0.30.0 → persidict-0.31.1}/src/persidict/s3_dict.py

@@ -5,6 +5,7 @@ from typing import Any, Optional
 
 import boto3
 import parameterizable
+from parameterizable.dict_sorter import sort_dict_by_keys
 
 from .safe_str_tuple import SafeStrTuple
 from .safe_str_tuple_signing import sign_safe_str_tuple, unsign_safe_str_tuple
@@ -119,7 +120,7 @@ class S3Dict(PersiDict):
         params["region"] = self.region
         params["bucket_name"] = self.bucket_name
         params["root_prefix"] = self.root_prefix
-        sorted_params = dict(sorted(params.items()))
+        sorted_params = sort_dict_by_keys(params)
         return sorted_params
 
 

{persidict-0.30.0 → persidict-0.31.1}/src/persidict/write_once_dict.py

@@ -3,7 +3,8 @@ from __future__ import annotations
 import time
 
 from deepdiff import DeepDiff
-from parameterizable import register_parameterizable_class
+from parameterizable import register_parameterizable_class, sort_dict_by_keys
+
 from .jokers import KEEP_CURRENT, KeepCurrentFlag
 from .persi_dict import PersiDict
 from .file_dir_dict import FileDirDict
@@ -103,7 +104,7 @@ class WriteOnceDict(PersiDict):
         params = dict(
             wrapped_dict = self._wrapped_dict,
             p_consistency_checks = self.p_consistency_checks)
-        sorted_params = dict(sorted(params.items()))
+        sorted_params = sort_dict_by_keys(params)
         return sorted_params
 
     def __setitem__(self, key, value):