Pre-release

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.

See more about tests here.

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 Storage instance.

>>> 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! :)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

key_multivalue_storage-1.3.2.20260826b2.tar.gz (49.2 kB view details)

Uploaded Aug 27, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

key_multivalue_storage-1.3.2.20260826b2-py3-none-any.whl (37.1 kB view details)

Uploaded Aug 27, 2026 Python 3

File details

Details for the file key_multivalue_storage-1.3.2.20260826b2.tar.gz.

File metadata

Download URL: key_multivalue_storage-1.3.2.20260826b2.tar.gz
Upload date: Aug 27, 2026
Size: 49.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for key_multivalue_storage-1.3.2.20260826b2.tar.gz
Algorithm	Hash digest
SHA256	`e686c66b612600b5906bd3b79ccc45a49cda3997be671d54d0cc46969b8b0061`
MD5	`e7cd2866ed33f0218bbad5c9914b8c47`
BLAKE2b-256	`7c1f465ec0bf0d45606c2581b234d2b1d5f5349fce15c78d5702398b72a769b2`

See more details on using hashes here.

Provenance

The following attestation bundles were made for key_multivalue_storage-1.3.2.20260826b2.tar.gz:

Publisher: release.yml on Boss-1s/key_multivalue_storage

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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.20260826b2.tar.gz
- Subject digest: e686c66b612600b5906bd3b79ccc45a49cda3997be671d54d0cc46969b8b0061
- Sigstore transparency entry: 2612402761
- Sigstore integration time: Aug 27, 2026
Source repository:
- Permalink: Boss-1s/key_multivalue_storage@de8d6fca9249305f682cb5122bf2fd99f5ed8ccf
- Branch / Tag: refs/tags/v1.3.2.20260826b2
- Owner: https://github.com/Boss-1s
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@de8d6fca9249305f682cb5122bf2fd99f5ed8ccf
- Trigger Event: release