mirror of
https://github.com/hanzokv/go.git
synced 2026-09-24 00:31:51 +00:00
zeekay
6994cf05aa
We do not use Redis. The client was a go-redis fork and still said so
everywhere: `package redis`, `redis.NewClient`, `redis://`, `extra/redisotel`.
Consumers wrote `redis.Client` against a Valkey-backed store called KV.
package redis -> package kv (93 decls)
redis.X -> kv.X (2,794 call sites)
"redis: …" errors -> "kv: …" (206)
extra/redis{otel,cmd,prometheus,census} -> extra/kv{otel,cmd,prometheus,census}
redis:// , rediss:// -> kv:// , kvs:// (ParseURL)
Redis*/*Redis* idents -> KV*/*KV*
REDIS_VERSION, REDIS_ENDPOINTS_CONFIG_PATH -> KV_*
I previously argued this rename was unsafe because much of it was "wire
contract". That was wrong, and the categorisation shows why: RESP command names
are GET/SET/HSET — they never contain the word. Of 5,771 occurrences only two
kinds were server-visible at all: the ParseURL scheme (we choose what we pass;
our configs already use kv://) and the CLIENT SETINFO lib-name label, which the
server merely records. Nothing here changes a byte of protocol.
Two things deliberately keep the old spelling:
RediSearch — names a specific external module the FT.* commands map to.
StoreDist — contains the letters by accident (sto-reDis-t), not the word.
Breaking for consumers by design: every import site must move redis.X -> kv.X.
Minor bump, never a major — this module stays v9 forever.
85 lines
2.4 KiB
Go
85 lines
2.4 KiB
Go
package kv
|
|
|
|
import (
|
|
"context"
|
|
"crypto/sha1"
|
|
"encoding/hex"
|
|
"io"
|
|
)
|
|
|
|
type Scripter interface {
|
|
Eval(ctx context.Context, script string, keys []string, args ...interface{}) *Cmd
|
|
EvalSha(ctx context.Context, sha1 string, keys []string, args ...interface{}) *Cmd
|
|
EvalRO(ctx context.Context, script string, keys []string, args ...interface{}) *Cmd
|
|
EvalShaRO(ctx context.Context, sha1 string, keys []string, args ...interface{}) *Cmd
|
|
ScriptExists(ctx context.Context, hashes ...string) *BoolSliceCmd
|
|
ScriptLoad(ctx context.Context, script string) *StringCmd
|
|
}
|
|
|
|
var (
|
|
_ Scripter = (*Client)(nil)
|
|
_ Scripter = (*Ring)(nil)
|
|
_ Scripter = (*ClusterClient)(nil)
|
|
)
|
|
|
|
type Script struct {
|
|
src, hash string
|
|
}
|
|
|
|
func NewScript(src string) *Script {
|
|
h := sha1.New()
|
|
_, _ = io.WriteString(h, src)
|
|
return &Script{
|
|
src: src,
|
|
hash: hex.EncodeToString(h.Sum(nil)),
|
|
}
|
|
}
|
|
|
|
func (s *Script) Hash() string {
|
|
return s.hash
|
|
}
|
|
|
|
func (s *Script) Load(ctx context.Context, c Scripter) *StringCmd {
|
|
return c.ScriptLoad(ctx, s.src)
|
|
}
|
|
|
|
func (s *Script) Exists(ctx context.Context, c Scripter) *BoolSliceCmd {
|
|
return c.ScriptExists(ctx, s.hash)
|
|
}
|
|
|
|
func (s *Script) Eval(ctx context.Context, c Scripter, keys []string, args ...interface{}) *Cmd {
|
|
return c.Eval(ctx, s.src, keys, args...)
|
|
}
|
|
|
|
func (s *Script) EvalRO(ctx context.Context, c Scripter, keys []string, args ...interface{}) *Cmd {
|
|
return c.EvalRO(ctx, s.src, keys, args...)
|
|
}
|
|
|
|
func (s *Script) EvalSha(ctx context.Context, c Scripter, keys []string, args ...interface{}) *Cmd {
|
|
return c.EvalSha(ctx, s.hash, keys, args...)
|
|
}
|
|
|
|
func (s *Script) EvalShaRO(ctx context.Context, c Scripter, keys []string, args ...interface{}) *Cmd {
|
|
return c.EvalShaRO(ctx, s.hash, keys, args...)
|
|
}
|
|
|
|
// Run optimistically uses EVALSHA to run the script. If script does not exist
|
|
// it is retried using EVAL.
|
|
func (s *Script) Run(ctx context.Context, c Scripter, keys []string, args ...interface{}) *Cmd {
|
|
r := s.EvalSha(ctx, c, keys, args...)
|
|
if HasErrorPrefix(r.Err(), "NOSCRIPT") {
|
|
return s.Eval(ctx, c, keys, args...)
|
|
}
|
|
return r
|
|
}
|
|
|
|
// RunRO optimistically uses EVALSHA_RO to run the script. If script does not exist
|
|
// it is retried using EVAL_RO.
|
|
func (s *Script) RunRO(ctx context.Context, c Scripter, keys []string, args ...interface{}) *Cmd {
|
|
r := s.EvalShaRO(ctx, c, keys, args...)
|
|
if HasErrorPrefix(r.Err(), "NOSCRIPT") {
|
|
return s.EvalRO(ctx, c, keys, args...)
|
|
}
|
|
return r
|
|
}
|