persidict 0.17.3__tar.gz → 0.18.0__tar.gz

{persidict-0.17.3 → persidict-0.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: persidict
-Version: 0.17.3
+Version: 0.18.0
 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
@@ -201,7 +201,7 @@ Binary installers for the latest released version are available at the Python pa
 
 Using uv :
 ```
-uv install persidict
+uv add persidict
 ```
 
 Using pip (legacy alternative to uv):

{persidict-0.17.3 → persidict-0.18.0}/README.md

@@ -168,7 +168,7 @@ Binary installers for the latest released version are available at the Python pa
 
 Using uv :
 ```
-uv install persidict
+uv add persidict
 ```
 
 Using pip (legacy alternative to uv):

{persidict-0.17.3 → persidict-0.18.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "persidict"
-version = "0.17.3"
+version = "0.18.0"
 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.17.3 → persidict-0.18.0}/src/persidict/file_dir_dict.py

@@ -12,6 +12,7 @@ from __future__ import annotations
 import os
 import random
 import time
+from abc import abstractmethod
 from typing import Any, Optional
 
 import joblib
@@ -110,6 +111,7 @@ class FileDirDict(PersiDict):
 
         return repr_str
 
+
     def get_params(self):
         """Return configuration parameters of the dictionary."""
         params = super().get_params()
@@ -119,9 +121,14 @@ class FileDirDict(PersiDict):
         params.update(additional_params)
         return params
 
+    @property
+    def base_url(self) -> str:
+        """Return dictionary's URL"""
+        return f"file://{self.base_dir}"
+
 
     def __len__(self) -> int:
-        """ Get number of key-value pairs in the dictionary."""
+        """ Get the number of key-value pairs in the dictionary."""
 
         num_files = 0
         suffix = "." + self.file_type

{persidict-0.17.3 → persidict-0.18.0}/src/persidict/persi_dict.py

@@ -102,6 +102,12 @@ class PersiDict(MutableMapping, ParameterizableClass):
         )
         return params
 
+    @property
+    @abstractmethod
+    def base_url(self):
+        """Return dictionary's URL"""
+        raise NotImplementedError
+
 
     def __repr__(self) -> str:
         """Return repr(self)"""

{persidict-0.17.3 → persidict-0.18.0}/src/persidict/s3_dict.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import os
+from abc import abstractmethod
 from typing import Any, Optional
 
 import boto3
@@ -107,6 +108,7 @@ class S3Dict(PersiDict):
 
         return repr_str
 
+
     def get_params(self):
         """Return configuration parameters of the object as a dictionary."""
         params = self.local_cache.get_params()
@@ -116,6 +118,13 @@ class S3Dict(PersiDict):
         return params
 
 
+    @property
+    def base_url(self):
+        """Return dictionary's URl"""
+        return f"s3://{self.bucket_name}/{self.root_prefix}"
+
+
+
     def _build_full_objectname(self, key:PersiDictKey) -> str:
         """ Convert PersiDictKey into an S3 objectname. """
         key = SafeStrTuple(key)