KVAlchemy is a SQLAlchemy-based key-vault store. It has the ability to get/set values based off a string key, an optional string tag, and an optional expiration time. Additionally it has a built-in ability to memoize function results to the store.
from kvalchemy import KVAlchemy
# Setup. Supports any available sqlalchemy backend.
k = KVAlchemy('sqlite://')
# Set/Get
k.set("hello", "world")
assert k.get("hello") == "world"
# Default values
assert k.get("hello again", "default") == "default"
# memoize example
import time
@k.memoize()
def func():
time.sleep(1)
func() # Will sleep
func() # Won't sleep
func.cache_clear()
func() # Will sleep
# proxy example
proxy = k.get_proxy('pizza')
proxy.set('pie')
assert proxy.get() == 'pie'
proxy.delete()
assert proxy.get('default') == 'default'
On Python 3.8 or later:
pip install kvalchemy
Note that the database format is stable across the same patch version.
For example: Version 0.0.1 will be fully compatible with all releases in the 0.0.X family.
Though Version 0.1.0 may not be directly compatible without a manual data migration.
Make sure to pin the version family you want: kvalachemy<X.(Y+1).0
KVAlchemy is tested across multiple database backends including MySQL, Postgres, SQLite, and Oracle.
For more documentation visit: https://csm10495.github.io/kvalchemy
