persidict 0.36.6__tar.gz → 0.36.8__tar.gz

{persidict-0.36.6 → persidict-0.36.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: persidict
-Version: 0.36.6
+Version: 0.36.8
 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
@@ -47,7 +47,10 @@ In contrast to traditional persistent dictionaries (e.g., Python’s `shelve)`,
 `persidict` is designed for distributed environments where multiple processes 
 on different machines concurrently work with the same store.
 
-## 2. Features
+## 2. Why Use It?
+
+## 2.1 Features
+
 * **Persistent Storage**: Save dictionaries to the local filesystem 
 (`FileDirDict`) or AWS S3 (`S3Dict`).
 * **Standard Dictionary API**: Use persidict objects like standard 
@@ -61,6 +64,23 @@ JSON (`json`), or plain text.
 instances of a specific class.
 * **Advanced Functionality**: Includes features like write-once dictionaries, 
 timestamping of entries, and tools for handling file-system-safe keys.
+* **Hierarchical Keys**: Keys can be sequences of strings, 
+creating a directory-like structure within the storage backend.
+
+## 2.2 Use Cases
+
+`persidict` is well-suited for a variety of applications, including:
+
+* **Caching**: Store results of expensive computations and retrieve them later, 
+even across different machines.
+* **Configuration Management**: Manage application settings 
+in a distributed environment, allowing for easy updates and access.
+* **Data Pipelines**: Share data between different stages 
+of a data processing pipeline.
+* **Distributed Task Queues**: Store task definitions and results 
+in a shared location.
+* **Memoization**: Cache function call results 
+in a persistent and distributed manner.
 
 ## 3. Usage
 
@@ -135,7 +155,7 @@ print(f"API Key: {cloud_config['api_key']}")
 ### 4.2 Differences 
 
 * **Persistence**: Data is saved between program executions.
-* **Keys**: Keys must be strings or sequences of URL/filename-safe strings.
+* **Keys**: Keys must be URL/filename-safe strings or their sequences.
 * **Values**: Values must be pickleable. 
 You can also constrain values to a specific class.
 * **Order**: Insertion order is not preserved.

{persidict-0.36.6 → persidict-0.36.8}/README.md

@@ -13,7 +13,10 @@ In contrast to traditional persistent dictionaries (e.g., Python’s `shelve)`,
 `persidict` is designed for distributed environments where multiple processes 
 on different machines concurrently work with the same store.
 
-## 2. Features
+## 2. Why Use It?
+
+## 2.1 Features
+
 * **Persistent Storage**: Save dictionaries to the local filesystem 
 (`FileDirDict`) or AWS S3 (`S3Dict`).
 * **Standard Dictionary API**: Use persidict objects like standard 
@@ -27,6 +30,23 @@ JSON (`json`), or plain text.
 instances of a specific class.
 * **Advanced Functionality**: Includes features like write-once dictionaries, 
 timestamping of entries, and tools for handling file-system-safe keys.
+* **Hierarchical Keys**: Keys can be sequences of strings, 
+creating a directory-like structure within the storage backend.
+
+## 2.2 Use Cases
+
+`persidict` is well-suited for a variety of applications, including:
+
+* **Caching**: Store results of expensive computations and retrieve them later, 
+even across different machines.
+* **Configuration Management**: Manage application settings 
+in a distributed environment, allowing for easy updates and access.
+* **Data Pipelines**: Share data between different stages 
+of a data processing pipeline.
+* **Distributed Task Queues**: Store task definitions and results 
+in a shared location.
+* **Memoization**: Cache function call results 
+in a persistent and distributed manner.
 
 ## 3. Usage
 
@@ -101,7 +121,7 @@ print(f"API Key: {cloud_config['api_key']}")
 ### 4.2 Differences 
 
 * **Persistence**: Data is saved between program executions.
-* **Keys**: Keys must be strings or sequences of URL/filename-safe strings.
+* **Keys**: Keys must be URL/filename-safe strings or their sequences.
 * **Values**: Values must be pickleable. 
 You can also constrain values to a specific class.
 * **Order**: Insertion order is not preserved.

{persidict-0.36.6 → persidict-0.36.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "persidict"
-version = "0.36.6"
+version = "0.36.8"
 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"