Migrating from LiveDict

Practical setup guides, performance tuning for free-threaded Python, migration workflows, and upgrade notes.

v3.1.1

Updated from GitHub 10/18/2026

4. Migrating from LiveDict

If you are upgrading an existing codebase from the legacy livedict package, the primary change is the package and class name:

migration_diff.py

1# Before (LiveDict legacy)
2# from livedict import LiveDict
3# ld = LiveDict()
4
5# After (NimbusKV v3)
6from nimbuskv import NimbusKV
7
8with NimbusKV() as ld:
9    ld.set("session_key", {"user_id": 42}, ttl=3600)
10    print(ld.get("session_key"))

Drop-in Compatibility Note

NimbusKV supports both dictionary-style access (ld["key"] = val) and explicit method calls (ld.set(key, val, ttl=...)). For TTL expirations and reactive events, the explicit method syntax is recommended.