immukv 0.1.20

Lightweight immutable key-value store using S3 versioning

ImmuKV - Python Client

Lightweight immutable key-value store using S3 versioning.

Installation

pip install immukv

Quick Start

from immukv import ImmuKVClient, Config

config = Config(
    s3_bucket="your-bucket",
    s3_region="us-east-1",
    s3_prefix=""
)

# Identity functions for JSON values (use custom encoders/decoders for complex types)
def identity(x): return x

with ImmuKVClient(config, identity, identity) as client:
    # Write
    entry = client.set("key1", {"value": "data"})
    print(f"Committed: {entry.version_id}")

    # Read
    latest = client.get("key1")
    print(f"Latest: {latest.value}")

Features

• Immutable log - All writes append to global log
• Fast reads - Single S3 request for latest value
• Hash chain - Cryptographic integrity verification
• No database - Uses S3 versioning only
• Auto-repair - Orphaned entries repaired automatically

See the full documentation for more details.