persidict 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

persidict/__init__.py

@@ -17,6 +17,9 @@ S3_Dict (inherited from PersiDict): a dictionary that
 stores key-value pairs as S3 objects on AWS.
 A key is used to compose an objectname, while a value is stored
 as a pickle or a json S3 object.
+
+The package also offers a helper function get_safe_chars(),
+which returns a set of URL/filename-safe characters permitted in keys.
 """
 
 from .safe_str_tuple import SafeStrTuple, get_safe_chars

persidict/persi_dict.py

@@ -6,10 +6,14 @@ Python's built-in Dict, with a few variations
 (e.g. insertion order is not preserved) and additional methods.
 
 PersiDict persistently stores key-value pairs.
+
 A key is a sequence of strings in a form of SafeStrTuple.
+Regular strings and their sequences can also be passed to PersiDict as keys,
+in this case they will be automatically converted to SafeStrTuple.
+
 A value can be any Python object.
 
-'Persstently' means that key-value pairs are saved in a durable storage,
+'Persistently' means that key-value pairs are saved in a durable storage,
 such as a local hard-drive or AWS S3 cloud, and can be retrieved
 even after the Python process that created the dictionary has terminated.
 """
@@ -22,11 +26,14 @@ from collections.abc import MutableMapping
 
 from .safe_str_tuple import SafeStrTuple
 
-PersiDictKey = Union[SafeStrTuple, str, Sequence[str]]
+PersiDictKey = Union[SafeStrTuple, Sequence[str], str]
 """ A value which can be used as a key for PersiDict. 
 
-PersiDictKey must be a string or a sequence of strings.
-The characters within strings must be to URL/filename-safe.
+PersiDict-s accept keys on a form of SafeStrTuple,
+or a string, or a sequence of strings.
+The characters within strings must be URL/filename-safe.
+If a string (or a sequence of strings) is passed to a PersiDict as a key,
+it will be automatically converted into SafeStrTuple.
 """
 
 class PersiDict(MutableMapping):
@@ -195,11 +202,12 @@ class PersiDict(MutableMapping):
             del self[k]
 
 
-    def quiet_delete(self, key:PersiDictKey):
+    def delete_if_exists(self, key:PersiDictKey) -> bool:
         """ Delete an item without raising an exception if it doesn't exist.
 
-        This method is absent in the original dict API, it is added here
-        to minimize network calls for (remote) persistent dictionaries.
+        Returns True if the item existed and was deleted, False otherwise.
+
+        This method is absent in the original dict API.
         """
 
         if self.immutable_items: # TODO: change to exceptions
@@ -207,21 +215,22 @@ class PersiDict(MutableMapping):
 
         key = SafeStrTuple(key)
 
-        try:
-            self.__delitem__(key)
-        except:
-            pass
+        if key in self:
+            del self[key]
+            return True
+        else:
+            return False
 
 
     def get_subdict(self, prefix_key:PersiDictKey) -> PersiDict:
-        """Get a subdictionary containing items with the same prefix_key.
+        """Get a sub-dictionary containing items with the same prefix_key.
 
         This method is absent in the original dict API.
         """
         raise NotImplementedError
 
     def subdicts(self) -> Dict[str, PersiDict]:
-        """Get a dictionary of subdictionaries.
+        """Get a dictionary of sub-dictionaries.
 
         This method is absent in the original dict API.
         """

{persidict-0.2.0.dist-info → persidict-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: persidict
-Version: 0.2.0
+Version: 0.2.2
 Summary: Simple persistent key-value store for Python. Values are stored as files on a disk or as S3 objects on AWS cloud.
 Home-page: https://github.com/vladlpavlov/persidict
 Author: Vlad (Volodymyr) Pavlov
@@ -149,7 +149,7 @@ that simultaneously work with the same instance of a dictionary.
 * Values must be pickleable Python objects.
 * Insertion order is not preserved.
 * You can not assign initial key-value pairs to a dictionary in its constructor.
-* Methods `quiet_delete()`, `mtimestamp()`, `get_subdict()` and `subdicts()` 
+* Methods `delete_if_exists()`, `mtimestamp()`, `get_subdict()` and `subdicts()` 
 are available
 
 ## Fine Tuning

persidict-0.2.2.dist-info/RECORD

@@ -0,0 +1,11 @@
+persidict/__init__.py,sha256=bSOkH1e2bJuN4iFy2H4w6E3kmeODl0e7x3pUHExl_Uk,1030
+persidict/file_dir_dict.py,sha256=-MYpUFK2ysPcrNz-gmJZOQeU18lJqlkDSI54IBSHOoA,9048
+persidict/persi_dict.py,sha256=0waP8_soZ_msw_HfmxaaC8ZIPCPqhQnReMHLz706F5o,7908
+persidict/s3_dict.py,sha256=0bVKxCdLcYVSfPeFrsqST2CE2-KQ1WpiOaLlu2WDgTc,9389
+persidict/safe_str_tuple.py,sha256=Tia4O69QIn-htCM_WKQx_SyMNwOhLXrWcDlBRseCC2E,3547
+persidict/safe_str_tuple_signing.py,sha256=OvGyaNOhx_I518nTifz3sRbej-vxtuRWqd4w1aEp8FY,3743
+persidict-0.2.2.dist-info/LICENSE,sha256=oWpRWnm32aM5jVoboapPqgHi-drh1OPeZrrafyE1zTs,1113
+persidict-0.2.2.dist-info/METADATA,sha256=_JQTDQtrXu9JmS5K3yzz5t1y1p8VJEghoB9pVGe9WK4,7834
+persidict-0.2.2.dist-info/WHEEL,sha256=5sUXSg9e4bi7lTLOHcm6QEYwO5TIF1TNbTSVFVjcJcc,92
+persidict-0.2.2.dist-info/top_level.txt,sha256=7Kr8wnF-PGd513PbAORWUpp7Bi09VIZVTQS7ZN-dJXc,10
+persidict-0.2.2.dist-info/RECORD,,

persidict-0.2.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-persidict/__init__.py,sha256=_tTjdl8d2bTbJJZPuK8Td4hR5EeoNx_iPtkIng0XWl4,898
-persidict/file_dir_dict.py,sha256=-MYpUFK2ysPcrNz-gmJZOQeU18lJqlkDSI54IBSHOoA,9048
-persidict/persi_dict.py,sha256=4pWDX5wDyIs96EoSXRFWGdyVVfZs3yj-_sc5w1-eC5g,7568
-persidict/s3_dict.py,sha256=0bVKxCdLcYVSfPeFrsqST2CE2-KQ1WpiOaLlu2WDgTc,9389
-persidict/safe_str_tuple.py,sha256=Tia4O69QIn-htCM_WKQx_SyMNwOhLXrWcDlBRseCC2E,3547
-persidict/safe_str_tuple_signing.py,sha256=OvGyaNOhx_I518nTifz3sRbej-vxtuRWqd4w1aEp8FY,3743
-persidict-0.2.0.dist-info/LICENSE,sha256=oWpRWnm32aM5jVoboapPqgHi-drh1OPeZrrafyE1zTs,1113
-persidict-0.2.0.dist-info/METADATA,sha256=bTC16iN8LyUp1tz0hACMzrrJ_WjaP9tZ1o0CQy11ZxM,7830
-persidict-0.2.0.dist-info/WHEEL,sha256=5sUXSg9e4bi7lTLOHcm6QEYwO5TIF1TNbTSVFVjcJcc,92
-persidict-0.2.0.dist-info/top_level.txt,sha256=7Kr8wnF-PGd513PbAORWUpp7Bi09VIZVTQS7ZN-dJXc,10
-persidict-0.2.0.dist-info/RECORD,,