Native, Simple Key-Value Store for Ruby.

PolyKV for Ruby is the simplest way to add persistence to your scripts and CLI tools. It provides a hash-like interface backed by a durable JSON file.

One API, Everywhere. This library is part of the PolyKV ecosystem. Use the same consistent API across 12+ languages.

• 💎 Ruby Way Feels just like a standard Ruby Hash, but data persists across runs.

• 📂 Standard Compliant Respects XDG Base Directory specs on Linux and standard AppData paths on Windows/macOS.

• 🚀 Fast & Simple No database servers to configure. Just a simple JSON file that you can inspect with any text editor.

gem install polykv

require 'polykv'

# Init
kv = PolyKV.new("MyScript")

# 1. Save
kv.set_string("status", "pending")
kv.set_number("pid", 101)

# 2. Read
puts "Status: #{kv.get_string("status")}"

# 3. Update
kv.set_string("status", "done")

# 4. Delete
kv.remove("pid")

# 5. Clear All
kv.clear

✅ Runtime Verified: Full CRUD operations verified via automated tests on actual devices/simulators.

MIT