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. ;)
🚀 What's New in kms-calver2026.10.12 (kms-semver1.3.2)
- Patched breaking change of name change in
Delete.propkey— specifically the argument name change fromtop_level_keytotop_lv_key
📢 Upcoming Roadmap
- v1.3.3 Patch: Expected November 7, 2026 (focusing on upstream backports and refactors).
- v1.4.0 Major: Alpha scheduled for October 12, 2026, with a stable target of early January 2027.
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
Metadata
1 maintainer
Release files for key-multivalue-storage 1.3.2.20261012
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| key_multivalue_storage-1.3.2.20261012.tar.gz | 52.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| key_multivalue_storage-1.3.2.20261012-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 92.5 kB
Release files / key_multivalue_storage-1.3.2.20261012.tar.gz
| Download URL | key_multivalue_storage-1.3.2.20261012.tar.gz |
|---|---|
| Size | 52.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5da4630c86070b2460993a7f0cf72149096e7ca6c4e826448e1f43e20afa5ee8
|
|
BLAKE2b-256 checksum How to use checksums |
c416967d22d4a9920dc12633e6776f7e3115d36b22094dff9042e32ca24a8fbe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.
Transparency logRelease files / key_multivalue_storage-1.3.2.20261012-py3-none-any.whl
| Download URL | key_multivalue_storage-1.3.2.20261012-py3-none-any.whl |
|---|---|
| Size | 39.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2ec2fa240901e4903fe77caffb482ef37d024c05fa93db7f23038032f46af9bd
|
|
BLAKE2b-256 checksum How to use checksums |
368c3fd4b7043594e94234a0502a003e718f434bef87f1b1ed64796037f3c643
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.
Transparency log
