tur-valkey

Valkey/Redis client for Turmeric via hiredis. Connect, run commands, walk reply trees, and subscribe to pub/sub channels.

Overview

tur-valkey is a cmake-dep spice that wraps hiredis. It speaks the Valkey/Redis RESP protocol, so it works against both Valkey and any Redis-compatible server. The surface is intentionally small: a client handle, a generic cmd plus typed helpers (cmd-get, cmd-set, cmd-incr, hash and list commands), a recursive reply accessor, and a pubsub module for subscribe/publish workflows.

Use it for caching, rate limiting, ephemeral state, and pub/sub messaging in Turmeric services.

Install

:spices {
  "valkey" {:url    "https://github.com/rjungemann/turmeric-spices"
            :ref    "valkey-v0.1.0"
            :subdir "spices/valkey"}
}

(import valkey/client :refer [client-connect client-close])
(import valkey/cmd    :refer [cmd-set cmd-get])
(import valkey/reply  :refer [reply-string reply-free])

(let [c (ok-val (client-connect "127.0.0.1" 6379))]
  (cmd-set c "greeting" "hello")
  (let [r (cmd-get c "greeting")]
    (println (reply-string r))
    (reply-free r))
  (client-close c))

#lang sweet-exp
import valkey/client :refer [client-connect client-close]
import valkey/cmd    :refer [cmd-set cmd-get]
import valkey/reply  :refer [reply-string reply-free]

let [c ok-val(client-connect("127.0.0.1" 6379))]
  cmd-set(c "greeting" "hello")
  let [r cmd-get(c "greeting")]
    println $ reply-string r
    reply-free(r)
  client-close(c)

See also

• API reference
• Source: https://github.com/rjungemann/turmeric-spices/tree/main/spices/valkey