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. ;)

(skip to content)

🚀 What's New in kms-semver1.3.2

💡 Features & Automation

• Version Bumping: Added a post-release script and automatic reminders to bump development versions (#153).
• Release Verification: Added automated checks to ensure the latest test deployment succeeds before completing a release (#153).
• Verbose Logging: Expanded release automation output for easier debugging.

🪲 Bug Fixes

• Workflow Tagging: Forced release tags onto the specific commits that modify the version number.
• Release Categorization: Corrected development builds to register as pre-alpha instead of beta.
• Fail-Safe Checks: Blocked scripts from continuing silently if required version environment variables are missing.
• Formatting: Fixed the layout format for release commit messages.

⏰ Infrastructure & CI

• Backports: Integrated multiple workflow stability fixes and commits backporting from the semver1.4.x branch.
• Permissions: Expanded release script access to read Actions runs and automatically generate version-bump issues.
• Security & Actions: Pinned third-party workflow actions (webfactory/ssh-agent, astral-sh/setup-uv, softprops/action-gh-release) to specific commits.

📢 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.

🔗 Full Changelog

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