This release is a pre-release and may not be stable for production use.
Key to Multivalue Storage - kms
kms - a tiny side project tuned into a library.
JSON storage wrapper and editor. Created with love by Boss_1s.
Once upon a time, this was just a small project to solve a problem: the over-steep learning curve for scratchattach's database functionality. Now, I have decided to make it a library, something with humble beginnings with big hopes in its future.
This is, after all, the greatest piece of a CPython progam I have made. ;)
Badges
Download
Status
Info & Docs
Installation
Install with pip:
pip install -U key-multivalue-storage
Or, download the latest version of the .whl file in the releases page
You can also choose to download the development environment alongside the package:
pip install -U key-multivalue-storage[dev]
The development package includes Pylint and Griffe for testing and finding breaking changes. You can see the tests in the test folder.
Usage
- Create a Storage object to wrap the data to be stored:
>>> from key_multivalue_storage import Storage
>>> my_db = Storage("my_top_level_key", mysubkey="myvalue", myothersk="anotherval")
- To store the object, use
Storage.store().
>>> my_db.store("database.json")
Data stored successfully in 'database.json'.
- You can change certain global variables for each
Storageinstance.
>>> Storage.indent = 4 # indent size of JSON files
>>> Storage.encode = True # Whether to encode stored values
- Load the data back into a Storage object:
>>> import key_multivalue_storage as kms
>>> loaded_db = kms.Load.by_key("database.json", "my_top_level_key") # You can also use Storage.Load.by_key()
>>> loaded_db = my_db
True
- You can also cast a Storage object into a dictionary!
>>> dict_db = dict(my_db)
>>> dict_db
{"my_top_level_key":{"mysubkey":"myvalue","myothersk":"anotherval"}}
There's a lot more to this library that what meets the eye.
See the full documentation here!
Contribute
Roadmap
Report a Bug
Have a GREAT day/night! :)
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file key_multivalue_storage-1.3.2.20260826b1.tar.gz.
File metadata
- Download URL: key_multivalue_storage-1.3.2.20260826b1.tar.gz
- Upload date:
- Size: 49.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
636efd9c17677af825e94e199d306ff1321e9c17c9a7433390758b8b675ea7f1
|
|
| MD5 |
eb38a2419cc43917eacd1897bda7c924
|
|
| BLAKE2b-256 |
25bd27dd08d2a12438c3c9cf67b9cc85f389ecc35b808ac62799927d52e0510b
|
Provenance
The following attestation bundles were made for key_multivalue_storage-1.3.2.20260826b1.tar.gz:
Publisher:
release.yml on Boss-1s/key_multivalue_storage
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
key_multivalue_storage-1.3.2.20260826b1.tar.gz -
Subject digest:
636efd9c17677af825e94e199d306ff1321e9c17c9a7433390758b8b675ea7f1 - Sigstore transparency entry: 2608492339
- Sigstore integration time:
-
Permalink:
Boss-1s/key_multivalue_storage@8d3a157388debde928b0215a319e2e73b0ae3e3d -
Branch / Tag:
refs/tags/v1.3.2.20260826b1 - Owner: https://github.com/Boss-1s
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@8d3a157388debde928b0215a319e2e73b0ae3e3d -
Trigger Event:
release
-
Statement type:
File details
Details for the file key_multivalue_storage-1.3.2.20260826b1-py3-none-any.whl.
File metadata
- Download URL: key_multivalue_storage-1.3.2.20260826b1-py3-none-any.whl
- Upload date:
- Size: 37.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d258b1479c36b8bf963cca2099e3e6ea7d772b5e161153d8f47a98230538609a
|
|
| MD5 |
9a00b170cd3c901f59fd56201a1feb45
|
|
| BLAKE2b-256 |
bad1c7a3d2221378c8adc18aec1e38943202db89461f80922b97a0c1475c3db3
|
Provenance
The following attestation bundles were made for key_multivalue_storage-1.3.2.20260826b1-py3-none-any.whl:
Publisher:
release.yml on Boss-1s/key_multivalue_storage
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
key_multivalue_storage-1.3.2.20260826b1-py3-none-any.whl -
Subject digest:
d258b1479c36b8bf963cca2099e3e6ea7d772b5e161153d8f47a98230538609a - Sigstore transparency entry: 2608492446
- Sigstore integration time:
-
Permalink:
Boss-1s/key_multivalue_storage@8d3a157388debde928b0215a319e2e73b0ae3e3d -
Branch / Tag:
refs/tags/v1.3.2.20260826b1 - Owner: https://github.com/Boss-1s
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@8d3a157388debde928b0215a319e2e73b0ae3e3d -
Trigger Event:
release
-
Statement type:
