A SQLAlchemy based Key-Value store.
Project description
KVAlchemy
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.
Example
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'
Installation
On Python 3.8 or later:
pip install kvalchemy
Versioning
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
Testing
KVAlchemy is tested across multiple database backends including MySQL, Postgres, SQLite, and Oracle.
More Documentation
For more documentation visit: https://csm10495.github.io/kvalchemy
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
kvalchemy-0.2.2.tar.gz
(10.7 kB
view hashes)
Built Distribution
Close
Hashes for kvalchemy-0.2.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a11ac712905f5b59d166a0ecf9b5929e41e5d52c9470db0ead223679cce37405 |
|
MD5 | d859963857dd3a0f5e33cadf2456b2fc |
|
BLAKE2b-256 | 9c17c35333fbb02f9ca6e9242806ec359136c965538c2d2f3d49d6ccfef2db6c |