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.
130 lines
2.9 KiB
Go
130 lines
2.9 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
|
|
"github.com/davecgh/go-spew/spew"
|
|
|
|
"github.com/hanzokv/go/v9"
|
|
)
|
|
|
|
type Model struct {
|
|
Str1 string `kv:"str1"`
|
|
Str2 string `kv:"str2"`
|
|
Str3 *string `kv:"str3"`
|
|
Str4 *string `kv:"str4"`
|
|
Bytes []byte `kv:"bytes"`
|
|
Int int `kv:"int"`
|
|
Int2 *int `kv:"int2"`
|
|
Int3 *int `kv:"int3"`
|
|
Bool bool `kv:"bool"`
|
|
Bool2 *bool `kv:"bool2"`
|
|
Bool3 *bool `kv:"bool3"`
|
|
Bool4 *bool `kv:"bool4,omitempty"`
|
|
Time time.Time `kv:"time"`
|
|
Time2 *time.Time `kv:"time2"`
|
|
Time3 *time.Time `kv:"time3"`
|
|
Ignored struct{} `kv:"-"`
|
|
}
|
|
|
|
func main() {
|
|
ctx := context.Background()
|
|
|
|
rdb := kv.NewClient(&kv.Options{
|
|
Addr: ":6379",
|
|
})
|
|
|
|
_ = rdb.FlushDB(ctx).Err()
|
|
|
|
t := time.Date(2025, 02, 8, 0, 0, 0, 0, time.UTC)
|
|
|
|
data := Model{
|
|
Str1: "hello",
|
|
Str2: "world",
|
|
Str3: ToPtr("hello"),
|
|
Str4: nil,
|
|
Bytes: []byte("this is bytes !"),
|
|
Int: 123,
|
|
Int2: ToPtr(0),
|
|
Int3: nil,
|
|
Bool: true,
|
|
Bool2: ToPtr(false),
|
|
Bool3: nil,
|
|
Time: t,
|
|
Time2: ToPtr(t),
|
|
Time3: nil,
|
|
Ignored: struct{}{},
|
|
}
|
|
|
|
// Set some fields.
|
|
if _, err := rdb.Pipelined(ctx, func(rdb kv.Pipeliner) error {
|
|
rdb.HMSet(ctx, "key", data)
|
|
return nil
|
|
}); err != nil {
|
|
panic(err)
|
|
}
|
|
|
|
var model1, model2 Model
|
|
|
|
// Scan all fields into the model.
|
|
if err := rdb.HGetAll(ctx, "key").Scan(&model1); err != nil {
|
|
panic(err)
|
|
}
|
|
|
|
// Or scan a subset of the fields.
|
|
if err := rdb.HMGet(ctx, "key", "str1", "int").Scan(&model2); err != nil {
|
|
panic(err)
|
|
}
|
|
|
|
spew.Dump(model1)
|
|
// Output:
|
|
// (main.Model) {
|
|
// Str1: (string) (len=5) "hello",
|
|
// Str2: (string) (len=5) "world",
|
|
// Str3: (*string)(0xc000016970)((len=5) "hello"),
|
|
// Str4: (*string)(0xc000016980)(""),
|
|
// Bytes: ([]uint8) (len=15 cap=16) {
|
|
// 00000000 74 68 69 73 20 69 73 20 62 79 74 65 73 20 21 |this is bytes !|
|
|
// },
|
|
// Int: (int) 123,
|
|
// Int2: (*int)(0xc000014568)(0),
|
|
// Int3: (*int)(0xc000014560)(0),
|
|
// Bool: (bool) true,
|
|
// Bool2: (*bool)(0xc000014570)(false),
|
|
// Bool3: (*bool)(0xc000014548)(false),
|
|
// Bool4: (*bool)(<nil>),
|
|
// Time: (time.Time) 2025-02-08 00:00:00 +0000 UTC,
|
|
// Time2: (*time.Time)(0xc0000122a0)(2025-02-08 00:00:00 +0000 UTC),
|
|
// Time3: (*time.Time)(0xc000012288)(0001-01-01 00:00:00 +0000 UTC),
|
|
// Ignored: (struct {}) {
|
|
// }
|
|
// }
|
|
|
|
spew.Dump(model2)
|
|
// Output:
|
|
// (main.Model) {
|
|
// Str1: (string) (len=5) "hello",
|
|
// Str2: (string) "",
|
|
// Str3: (*string)(<nil>),
|
|
// Str4: (*string)(<nil>),
|
|
// Bytes: ([]uint8) <nil>,
|
|
// Int: (int) 123,
|
|
// Int2: (*int)(<nil>),
|
|
// Int3: (*int)(<nil>),
|
|
// Bool: (bool) false,
|
|
// Bool2: (*bool)(<nil>),
|
|
// Bool3: (*bool)(<nil>),
|
|
// Bool4: (*bool)(<nil>),
|
|
// Time: (time.Time) 0001-01-01 00:00:00 +0000 UTC,
|
|
// Time2: (*time.Time)(<nil>),
|
|
// Time3: (*time.Time)(<nil>),
|
|
// Ignored: (struct {}) {
|
|
// }
|
|
// }
|
|
}
|
|
|
|
func ToPtr[T any](v T) *T {
|
|
return &v
|
|
}
|