10 "github.com/go-redis/redis/internal"
11 "github.com/go-redis/redis/internal/proto"
14 type Cmder interface {
19 readReply(rd *proto.Reader) error
22 readTimeout() *time.Duration
27 func setCmdsErr(cmds []Cmder, e error) {
28 for _, cmd := range cmds {
35 func cmdsFirstErr(cmds []Cmder) error {
36 for _, cmd := range cmds {
37 if err := cmd.Err(); err != nil {
44 func writeCmd(wr *proto.Writer, cmds ...Cmder) error {
45 for _, cmd := range cmds {
46 err := wr.WriteArgs(cmd.Args())
54 func cmdString(cmd Cmder, val interface{}) string {
56 for _, arg := range cmd.Args() {
57 ss = append(ss, fmt.Sprint(arg))
59 s := strings.Join(ss, " ")
60 if err := cmd.Err(); err != nil {
61 return s + ": " + err.Error()
64 switch vv := val.(type) {
66 return s + ": " + string(vv)
68 return s + ": " + fmt.Sprint(val)
75 func cmdFirstKeyPos(cmd Cmder, info *CommandInfo) int {
77 case "eval", "evalsha":
78 if cmd.stringArg(2) != "0" {
89 return int(info.FirstKeyPos)
92 //------------------------------------------------------------------------------
98 _readTimeout *time.Duration
101 var _ Cmder = (*Cmd)(nil)
103 func (cmd *baseCmd) Err() error {
107 func (cmd *baseCmd) Args() []interface{} {
111 func (cmd *baseCmd) stringArg(pos int) string {
112 if pos < 0 || pos >= len(cmd._args) {
115 s, _ := cmd._args[pos].(string)
119 func (cmd *baseCmd) Name() string {
120 if len(cmd._args) > 0 {
121 // Cmd name must be lower cased.
122 s := internal.ToLower(cmd.stringArg(0))
129 func (cmd *baseCmd) readTimeout() *time.Duration {
130 return cmd._readTimeout
133 func (cmd *baseCmd) setReadTimeout(d time.Duration) {
134 cmd._readTimeout = &d
137 func (cmd *baseCmd) setErr(e error) {
141 //------------------------------------------------------------------------------
149 func NewCmd(args ...interface{}) *Cmd {
151 baseCmd: baseCmd{_args: args},
155 func (cmd *Cmd) Val() interface{} {
159 func (cmd *Cmd) Result() (interface{}, error) {
160 return cmd.val, cmd.err
163 func (cmd *Cmd) String() (string, error) {
167 switch val := cmd.val.(type) {
171 err := fmt.Errorf("redis: unexpected type=%T for String", val)
176 func (cmd *Cmd) Int() (int, error) {
180 switch val := cmd.val.(type) {
184 return strconv.Atoi(val)
186 err := fmt.Errorf("redis: unexpected type=%T for Int", val)
191 func (cmd *Cmd) Int64() (int64, error) {
195 switch val := cmd.val.(type) {
199 return strconv.ParseInt(val, 10, 64)
201 err := fmt.Errorf("redis: unexpected type=%T for Int64", val)
206 func (cmd *Cmd) Uint64() (uint64, error) {
210 switch val := cmd.val.(type) {
212 return uint64(val), nil
214 return strconv.ParseUint(val, 10, 64)
216 err := fmt.Errorf("redis: unexpected type=%T for Uint64", val)
221 func (cmd *Cmd) Float64() (float64, error) {
225 switch val := cmd.val.(type) {
227 return float64(val), nil
229 return strconv.ParseFloat(val, 64)
231 err := fmt.Errorf("redis: unexpected type=%T for Float64", val)
236 func (cmd *Cmd) Bool() (bool, error) {
238 return false, cmd.err
240 switch val := cmd.val.(type) {
244 return strconv.ParseBool(val)
246 err := fmt.Errorf("redis: unexpected type=%T for Bool", val)
251 func (cmd *Cmd) readReply(rd *proto.Reader) error {
252 cmd.val, cmd.err = rd.ReadReply(sliceParser)
256 // Implements proto.MultiBulkParse
257 func sliceParser(rd *proto.Reader, n int64) (interface{}, error) {
258 vals := make([]interface{}, 0, n)
259 for i := int64(0); i < n; i++ {
260 v, err := rd.ReadReply(sliceParser)
263 vals = append(vals, nil)
266 if err, ok := err.(proto.RedisError); ok {
267 vals = append(vals, err)
273 switch v := v.(type) {
275 vals = append(vals, v)
277 vals = append(vals, v)
283 //------------------------------------------------------------------------------
285 type SliceCmd struct {
291 var _ Cmder = (*SliceCmd)(nil)
293 func NewSliceCmd(args ...interface{}) *SliceCmd {
295 baseCmd: baseCmd{_args: args},
299 func (cmd *SliceCmd) Val() []interface{} {
303 func (cmd *SliceCmd) Result() ([]interface{}, error) {
304 return cmd.val, cmd.err
307 func (cmd *SliceCmd) String() string {
308 return cmdString(cmd, cmd.val)
311 func (cmd *SliceCmd) readReply(rd *proto.Reader) error {
313 v, cmd.err = rd.ReadArrayReply(sliceParser)
317 cmd.val = v.([]interface{})
321 //------------------------------------------------------------------------------
323 type StatusCmd struct {
329 var _ Cmder = (*StatusCmd)(nil)
331 func NewStatusCmd(args ...interface{}) *StatusCmd {
333 baseCmd: baseCmd{_args: args},
337 func (cmd *StatusCmd) Val() string {
341 func (cmd *StatusCmd) Result() (string, error) {
342 return cmd.val, cmd.err
345 func (cmd *StatusCmd) String() string {
346 return cmdString(cmd, cmd.val)
349 func (cmd *StatusCmd) readReply(rd *proto.Reader) error {
350 cmd.val, cmd.err = rd.ReadString()
354 //------------------------------------------------------------------------------
362 var _ Cmder = (*IntCmd)(nil)
364 func NewIntCmd(args ...interface{}) *IntCmd {
366 baseCmd: baseCmd{_args: args},
370 func (cmd *IntCmd) Val() int64 {
374 func (cmd *IntCmd) Result() (int64, error) {
375 return cmd.val, cmd.err
378 func (cmd *IntCmd) String() string {
379 return cmdString(cmd, cmd.val)
382 func (cmd *IntCmd) readReply(rd *proto.Reader) error {
383 cmd.val, cmd.err = rd.ReadIntReply()
387 //------------------------------------------------------------------------------
389 type DurationCmd struct {
393 precision time.Duration
396 var _ Cmder = (*DurationCmd)(nil)
398 func NewDurationCmd(precision time.Duration, args ...interface{}) *DurationCmd {
400 baseCmd: baseCmd{_args: args},
401 precision: precision,
405 func (cmd *DurationCmd) Val() time.Duration {
409 func (cmd *DurationCmd) Result() (time.Duration, error) {
410 return cmd.val, cmd.err
413 func (cmd *DurationCmd) String() string {
414 return cmdString(cmd, cmd.val)
417 func (cmd *DurationCmd) readReply(rd *proto.Reader) error {
419 n, cmd.err = rd.ReadIntReply()
423 cmd.val = time.Duration(n) * cmd.precision
427 //------------------------------------------------------------------------------
429 type TimeCmd struct {
435 var _ Cmder = (*TimeCmd)(nil)
437 func NewTimeCmd(args ...interface{}) *TimeCmd {
439 baseCmd: baseCmd{_args: args},
443 func (cmd *TimeCmd) Val() time.Time {
447 func (cmd *TimeCmd) Result() (time.Time, error) {
448 return cmd.val, cmd.err
451 func (cmd *TimeCmd) String() string {
452 return cmdString(cmd, cmd.val)
455 func (cmd *TimeCmd) readReply(rd *proto.Reader) error {
457 v, cmd.err = rd.ReadArrayReply(timeParser)
461 cmd.val = v.(time.Time)
465 // Implements proto.MultiBulkParse
466 func timeParser(rd *proto.Reader, n int64) (interface{}, error) {
468 return nil, fmt.Errorf("got %d elements, expected 2", n)
471 sec, err := rd.ReadInt()
476 microsec, err := rd.ReadInt()
481 return time.Unix(sec, microsec*1000), nil
484 //------------------------------------------------------------------------------
486 type BoolCmd struct {
492 var _ Cmder = (*BoolCmd)(nil)
494 func NewBoolCmd(args ...interface{}) *BoolCmd {
496 baseCmd: baseCmd{_args: args},
500 func (cmd *BoolCmd) Val() bool {
504 func (cmd *BoolCmd) Result() (bool, error) {
505 return cmd.val, cmd.err
508 func (cmd *BoolCmd) String() string {
509 return cmdString(cmd, cmd.val)
512 func (cmd *BoolCmd) readReply(rd *proto.Reader) error {
514 v, cmd.err = rd.ReadReply(nil)
515 // `SET key value NX` returns nil when key already exists. But
516 // `SETNX key value` returns bool (0/1). So convert nil to bool.
517 // TODO: is this okay?
526 switch v := v.(type) {
534 cmd.err = fmt.Errorf("got %T, wanted int64 or string", v)
539 //------------------------------------------------------------------------------
541 type StringCmd struct {
547 var _ Cmder = (*StringCmd)(nil)
549 func NewStringCmd(args ...interface{}) *StringCmd {
551 baseCmd: baseCmd{_args: args},
555 func (cmd *StringCmd) Val() string {
559 func (cmd *StringCmd) Result() (string, error) {
560 return cmd.Val(), cmd.err
563 func (cmd *StringCmd) Bytes() ([]byte, error) {
564 return []byte(cmd.val), cmd.err
567 func (cmd *StringCmd) Int() (int, error) {
571 return strconv.Atoi(cmd.Val())
574 func (cmd *StringCmd) Int64() (int64, error) {
578 return strconv.ParseInt(cmd.Val(), 10, 64)
581 func (cmd *StringCmd) Uint64() (uint64, error) {
585 return strconv.ParseUint(cmd.Val(), 10, 64)
588 func (cmd *StringCmd) Float64() (float64, error) {
592 return strconv.ParseFloat(cmd.Val(), 64)
595 func (cmd *StringCmd) Scan(val interface{}) error {
599 return proto.Scan([]byte(cmd.val), val)
602 func (cmd *StringCmd) String() string {
603 return cmdString(cmd, cmd.val)
606 func (cmd *StringCmd) readReply(rd *proto.Reader) error {
607 cmd.val, cmd.err = rd.ReadString()
611 //------------------------------------------------------------------------------
613 type FloatCmd struct {
619 var _ Cmder = (*FloatCmd)(nil)
621 func NewFloatCmd(args ...interface{}) *FloatCmd {
623 baseCmd: baseCmd{_args: args},
627 func (cmd *FloatCmd) Val() float64 {
631 func (cmd *FloatCmd) Result() (float64, error) {
632 return cmd.Val(), cmd.Err()
635 func (cmd *FloatCmd) String() string {
636 return cmdString(cmd, cmd.val)
639 func (cmd *FloatCmd) readReply(rd *proto.Reader) error {
640 cmd.val, cmd.err = rd.ReadFloatReply()
644 //------------------------------------------------------------------------------
646 type StringSliceCmd struct {
652 var _ Cmder = (*StringSliceCmd)(nil)
654 func NewStringSliceCmd(args ...interface{}) *StringSliceCmd {
655 return &StringSliceCmd{
656 baseCmd: baseCmd{_args: args},
660 func (cmd *StringSliceCmd) Val() []string {
664 func (cmd *StringSliceCmd) Result() ([]string, error) {
665 return cmd.Val(), cmd.Err()
668 func (cmd *StringSliceCmd) String() string {
669 return cmdString(cmd, cmd.val)
672 func (cmd *StringSliceCmd) ScanSlice(container interface{}) error {
673 return proto.ScanSlice(cmd.Val(), container)
676 func (cmd *StringSliceCmd) readReply(rd *proto.Reader) error {
678 v, cmd.err = rd.ReadArrayReply(stringSliceParser)
682 cmd.val = v.([]string)
686 // Implements proto.MultiBulkParse
687 func stringSliceParser(rd *proto.Reader, n int64) (interface{}, error) {
688 ss := make([]string, 0, n)
689 for i := int64(0); i < n; i++ {
690 s, err := rd.ReadString()
693 } else if err != nil {
702 //------------------------------------------------------------------------------
704 type BoolSliceCmd struct {
710 var _ Cmder = (*BoolSliceCmd)(nil)
712 func NewBoolSliceCmd(args ...interface{}) *BoolSliceCmd {
713 return &BoolSliceCmd{
714 baseCmd: baseCmd{_args: args},
718 func (cmd *BoolSliceCmd) Val() []bool {
722 func (cmd *BoolSliceCmd) Result() ([]bool, error) {
723 return cmd.val, cmd.err
726 func (cmd *BoolSliceCmd) String() string {
727 return cmdString(cmd, cmd.val)
730 func (cmd *BoolSliceCmd) readReply(rd *proto.Reader) error {
732 v, cmd.err = rd.ReadArrayReply(boolSliceParser)
740 // Implements proto.MultiBulkParse
741 func boolSliceParser(rd *proto.Reader, n int64) (interface{}, error) {
742 bools := make([]bool, 0, n)
743 for i := int64(0); i < n; i++ {
744 n, err := rd.ReadIntReply()
748 bools = append(bools, n == 1)
753 //------------------------------------------------------------------------------
755 type StringStringMapCmd struct {
758 val map[string]string
761 var _ Cmder = (*StringStringMapCmd)(nil)
763 func NewStringStringMapCmd(args ...interface{}) *StringStringMapCmd {
764 return &StringStringMapCmd{
765 baseCmd: baseCmd{_args: args},
769 func (cmd *StringStringMapCmd) Val() map[string]string {
773 func (cmd *StringStringMapCmd) Result() (map[string]string, error) {
774 return cmd.val, cmd.err
777 func (cmd *StringStringMapCmd) String() string {
778 return cmdString(cmd, cmd.val)
781 func (cmd *StringStringMapCmd) readReply(rd *proto.Reader) error {
783 v, cmd.err = rd.ReadArrayReply(stringStringMapParser)
787 cmd.val = v.(map[string]string)
791 // Implements proto.MultiBulkParse
792 func stringStringMapParser(rd *proto.Reader, n int64) (interface{}, error) {
793 m := make(map[string]string, n/2)
794 for i := int64(0); i < n; i += 2 {
795 key, err := rd.ReadString()
800 value, err := rd.ReadString()
810 //------------------------------------------------------------------------------
812 type StringIntMapCmd struct {
818 var _ Cmder = (*StringIntMapCmd)(nil)
820 func NewStringIntMapCmd(args ...interface{}) *StringIntMapCmd {
821 return &StringIntMapCmd{
822 baseCmd: baseCmd{_args: args},
826 func (cmd *StringIntMapCmd) Val() map[string]int64 {
830 func (cmd *StringIntMapCmd) Result() (map[string]int64, error) {
831 return cmd.val, cmd.err
834 func (cmd *StringIntMapCmd) String() string {
835 return cmdString(cmd, cmd.val)
838 func (cmd *StringIntMapCmd) readReply(rd *proto.Reader) error {
840 v, cmd.err = rd.ReadArrayReply(stringIntMapParser)
844 cmd.val = v.(map[string]int64)
848 // Implements proto.MultiBulkParse
849 func stringIntMapParser(rd *proto.Reader, n int64) (interface{}, error) {
850 m := make(map[string]int64, n/2)
851 for i := int64(0); i < n; i += 2 {
852 key, err := rd.ReadString()
857 n, err := rd.ReadIntReply()
867 //------------------------------------------------------------------------------
869 type StringStructMapCmd struct {
872 val map[string]struct{}
875 var _ Cmder = (*StringStructMapCmd)(nil)
877 func NewStringStructMapCmd(args ...interface{}) *StringStructMapCmd {
878 return &StringStructMapCmd{
879 baseCmd: baseCmd{_args: args},
883 func (cmd *StringStructMapCmd) Val() map[string]struct{} {
887 func (cmd *StringStructMapCmd) Result() (map[string]struct{}, error) {
888 return cmd.val, cmd.err
891 func (cmd *StringStructMapCmd) String() string {
892 return cmdString(cmd, cmd.val)
895 func (cmd *StringStructMapCmd) readReply(rd *proto.Reader) error {
897 v, cmd.err = rd.ReadArrayReply(stringStructMapParser)
901 cmd.val = v.(map[string]struct{})
905 // Implements proto.MultiBulkParse
906 func stringStructMapParser(rd *proto.Reader, n int64) (interface{}, error) {
907 m := make(map[string]struct{}, n)
908 for i := int64(0); i < n; i++ {
909 key, err := rd.ReadString()
919 //------------------------------------------------------------------------------
921 type XMessage struct {
923 Values map[string]interface{}
926 type XMessageSliceCmd struct {
932 var _ Cmder = (*XMessageSliceCmd)(nil)
934 func NewXMessageSliceCmd(args ...interface{}) *XMessageSliceCmd {
935 return &XMessageSliceCmd{
936 baseCmd: baseCmd{_args: args},
940 func (cmd *XMessageSliceCmd) Val() []XMessage {
944 func (cmd *XMessageSliceCmd) Result() ([]XMessage, error) {
945 return cmd.val, cmd.err
948 func (cmd *XMessageSliceCmd) String() string {
949 return cmdString(cmd, cmd.val)
952 func (cmd *XMessageSliceCmd) readReply(rd *proto.Reader) error {
954 v, cmd.err = rd.ReadArrayReply(xMessageSliceParser)
958 cmd.val = v.([]XMessage)
962 // Implements proto.MultiBulkParse
963 func xMessageSliceParser(rd *proto.Reader, n int64) (interface{}, error) {
964 msgs := make([]XMessage, 0, n)
965 for i := int64(0); i < n; i++ {
966 _, err := rd.ReadArrayReply(func(rd *proto.Reader, n int64) (interface{}, error) {
967 id, err := rd.ReadString()
972 v, err := rd.ReadArrayReply(stringInterfaceMapParser)
977 msgs = append(msgs, XMessage{
979 Values: v.(map[string]interface{}),
990 // Implements proto.MultiBulkParse
991 func stringInterfaceMapParser(rd *proto.Reader, n int64) (interface{}, error) {
992 m := make(map[string]interface{}, n/2)
993 for i := int64(0); i < n; i += 2 {
994 key, err := rd.ReadString()
999 value, err := rd.ReadString()
1009 //------------------------------------------------------------------------------
1011 type XStream struct {
1016 type XStreamSliceCmd struct {
1022 var _ Cmder = (*XStreamSliceCmd)(nil)
1024 func NewXStreamSliceCmd(args ...interface{}) *XStreamSliceCmd {
1025 return &XStreamSliceCmd{
1026 baseCmd: baseCmd{_args: args},
1030 func (cmd *XStreamSliceCmd) Val() []XStream {
1034 func (cmd *XStreamSliceCmd) Result() ([]XStream, error) {
1035 return cmd.val, cmd.err
1038 func (cmd *XStreamSliceCmd) String() string {
1039 return cmdString(cmd, cmd.val)
1042 func (cmd *XStreamSliceCmd) readReply(rd *proto.Reader) error {
1044 v, cmd.err = rd.ReadArrayReply(xStreamSliceParser)
1048 cmd.val = v.([]XStream)
1052 // Implements proto.MultiBulkParse
1053 func xStreamSliceParser(rd *proto.Reader, n int64) (interface{}, error) {
1054 ret := make([]XStream, 0, n)
1055 for i := int64(0); i < n; i++ {
1056 _, err := rd.ReadArrayReply(func(rd *proto.Reader, n int64) (interface{}, error) {
1058 return nil, fmt.Errorf("got %d, wanted 2", n)
1061 stream, err := rd.ReadString()
1066 v, err := rd.ReadArrayReply(xMessageSliceParser)
1071 ret = append(ret, XStream{
1073 Messages: v.([]XMessage),
1084 //------------------------------------------------------------------------------
1086 type XPending struct {
1090 Consumers map[string]int64
1093 type XPendingCmd struct {
1098 var _ Cmder = (*XPendingCmd)(nil)
1100 func NewXPendingCmd(args ...interface{}) *XPendingCmd {
1101 return &XPendingCmd{
1102 baseCmd: baseCmd{_args: args},
1106 func (cmd *XPendingCmd) Val() *XPending {
1110 func (cmd *XPendingCmd) Result() (*XPending, error) {
1111 return cmd.val, cmd.err
1114 func (cmd *XPendingCmd) String() string {
1115 return cmdString(cmd, cmd.val)
1118 func (cmd *XPendingCmd) readReply(rd *proto.Reader) error {
1119 var info interface{}
1120 info, cmd.err = rd.ReadArrayReply(xPendingParser)
1124 cmd.val = info.(*XPending)
1128 func xPendingParser(rd *proto.Reader, n int64) (interface{}, error) {
1130 return nil, fmt.Errorf("got %d, wanted 4", n)
1133 count, err := rd.ReadIntReply()
1138 lower, err := rd.ReadString()
1139 if err != nil && err != Nil {
1143 higher, err := rd.ReadString()
1144 if err != nil && err != Nil {
1148 pending := &XPending{
1153 _, err = rd.ReadArrayReply(func(rd *proto.Reader, n int64) (interface{}, error) {
1154 for i := int64(0); i < n; i++ {
1155 _, err = rd.ReadArrayReply(func(rd *proto.Reader, n int64) (interface{}, error) {
1157 return nil, fmt.Errorf("got %d, wanted 2", n)
1160 consumerName, err := rd.ReadString()
1165 consumerPending, err := rd.ReadInt()
1170 if pending.Consumers == nil {
1171 pending.Consumers = make(map[string]int64)
1173 pending.Consumers[consumerName] = consumerPending
1183 if err != nil && err != Nil {
1190 //------------------------------------------------------------------------------
1192 type XPendingExt struct {
1199 type XPendingExtCmd struct {
1204 var _ Cmder = (*XPendingExtCmd)(nil)
1206 func NewXPendingExtCmd(args ...interface{}) *XPendingExtCmd {
1207 return &XPendingExtCmd{
1208 baseCmd: baseCmd{_args: args},
1212 func (cmd *XPendingExtCmd) Val() []XPendingExt {
1216 func (cmd *XPendingExtCmd) Result() ([]XPendingExt, error) {
1217 return cmd.val, cmd.err
1220 func (cmd *XPendingExtCmd) String() string {
1221 return cmdString(cmd, cmd.val)
1224 func (cmd *XPendingExtCmd) readReply(rd *proto.Reader) error {
1225 var info interface{}
1226 info, cmd.err = rd.ReadArrayReply(xPendingExtSliceParser)
1230 cmd.val = info.([]XPendingExt)
1234 func xPendingExtSliceParser(rd *proto.Reader, n int64) (interface{}, error) {
1235 ret := make([]XPendingExt, 0, n)
1236 for i := int64(0); i < n; i++ {
1237 _, err := rd.ReadArrayReply(func(rd *proto.Reader, n int64) (interface{}, error) {
1239 return nil, fmt.Errorf("got %d, wanted 4", n)
1242 id, err := rd.ReadString()
1247 consumer, err := rd.ReadString()
1248 if err != nil && err != Nil {
1252 idle, err := rd.ReadIntReply()
1253 if err != nil && err != Nil {
1257 retryCount, err := rd.ReadIntReply()
1258 if err != nil && err != Nil {
1262 ret = append(ret, XPendingExt{
1265 Idle: time.Duration(idle) * time.Millisecond,
1266 RetryCount: retryCount,
1277 //------------------------------------------------------------------------------
1279 //------------------------------------------------------------------------------
1281 type ZSliceCmd struct {
1287 var _ Cmder = (*ZSliceCmd)(nil)
1289 func NewZSliceCmd(args ...interface{}) *ZSliceCmd {
1291 baseCmd: baseCmd{_args: args},
1295 func (cmd *ZSliceCmd) Val() []Z {
1299 func (cmd *ZSliceCmd) Result() ([]Z, error) {
1300 return cmd.val, cmd.err
1303 func (cmd *ZSliceCmd) String() string {
1304 return cmdString(cmd, cmd.val)
1307 func (cmd *ZSliceCmd) readReply(rd *proto.Reader) error {
1309 v, cmd.err = rd.ReadArrayReply(zSliceParser)
1317 // Implements proto.MultiBulkParse
1318 func zSliceParser(rd *proto.Reader, n int64) (interface{}, error) {
1319 zz := make([]Z, n/2)
1320 for i := int64(0); i < n; i += 2 {
1325 z.Member, err = rd.ReadString()
1330 z.Score, err = rd.ReadFloatReply()
1338 //------------------------------------------------------------------------------
1340 type ZWithKeyCmd struct {
1346 var _ Cmder = (*ZWithKeyCmd)(nil)
1348 func NewZWithKeyCmd(args ...interface{}) *ZWithKeyCmd {
1349 return &ZWithKeyCmd{
1350 baseCmd: baseCmd{_args: args},
1354 func (cmd *ZWithKeyCmd) Val() ZWithKey {
1358 func (cmd *ZWithKeyCmd) Result() (ZWithKey, error) {
1359 return cmd.Val(), cmd.Err()
1362 func (cmd *ZWithKeyCmd) String() string {
1363 return cmdString(cmd, cmd.val)
1366 func (cmd *ZWithKeyCmd) readReply(rd *proto.Reader) error {
1368 v, cmd.err = rd.ReadArrayReply(zWithKeyParser)
1372 cmd.val = v.(ZWithKey)
1376 // Implements proto.MultiBulkParse
1377 func zWithKeyParser(rd *proto.Reader, n int64) (interface{}, error) {
1379 return nil, fmt.Errorf("got %d elements, expected 3", n)
1385 z.Key, err = rd.ReadString()
1389 z.Member, err = rd.ReadString()
1393 z.Score, err = rd.ReadFloatReply()
1400 //------------------------------------------------------------------------------
1402 type ScanCmd struct {
1408 process func(cmd Cmder) error
1411 var _ Cmder = (*ScanCmd)(nil)
1413 func NewScanCmd(process func(cmd Cmder) error, args ...interface{}) *ScanCmd {
1415 baseCmd: baseCmd{_args: args},
1420 func (cmd *ScanCmd) Val() (keys []string, cursor uint64) {
1421 return cmd.page, cmd.cursor
1424 func (cmd *ScanCmd) Result() (keys []string, cursor uint64, err error) {
1425 return cmd.page, cmd.cursor, cmd.err
1428 func (cmd *ScanCmd) String() string {
1429 return cmdString(cmd, cmd.page)
1432 func (cmd *ScanCmd) readReply(rd *proto.Reader) error {
1433 cmd.page, cmd.cursor, cmd.err = rd.ReadScanReply()
1437 // Iterator creates a new ScanIterator.
1438 func (cmd *ScanCmd) Iterator() *ScanIterator {
1439 return &ScanIterator{
1444 //------------------------------------------------------------------------------
1446 type ClusterNode struct {
1451 type ClusterSlot struct {
1457 type ClusterSlotsCmd struct {
1463 var _ Cmder = (*ClusterSlotsCmd)(nil)
1465 func NewClusterSlotsCmd(args ...interface{}) *ClusterSlotsCmd {
1466 return &ClusterSlotsCmd{
1467 baseCmd: baseCmd{_args: args},
1471 func (cmd *ClusterSlotsCmd) Val() []ClusterSlot {
1475 func (cmd *ClusterSlotsCmd) Result() ([]ClusterSlot, error) {
1476 return cmd.Val(), cmd.Err()
1479 func (cmd *ClusterSlotsCmd) String() string {
1480 return cmdString(cmd, cmd.val)
1483 func (cmd *ClusterSlotsCmd) readReply(rd *proto.Reader) error {
1485 v, cmd.err = rd.ReadArrayReply(clusterSlotsParser)
1489 cmd.val = v.([]ClusterSlot)
1493 // Implements proto.MultiBulkParse
1494 func clusterSlotsParser(rd *proto.Reader, n int64) (interface{}, error) {
1495 slots := make([]ClusterSlot, n)
1496 for i := 0; i < len(slots); i++ {
1497 n, err := rd.ReadArrayLen()
1502 err := fmt.Errorf("redis: got %d elements in cluster info, expected at least 2", n)
1506 start, err := rd.ReadIntReply()
1511 end, err := rd.ReadIntReply()
1516 nodes := make([]ClusterNode, n-2)
1517 for j := 0; j < len(nodes); j++ {
1518 n, err := rd.ReadArrayLen()
1522 if n != 2 && n != 3 {
1523 err := fmt.Errorf("got %d elements in cluster info address, expected 2 or 3", n)
1527 ip, err := rd.ReadString()
1532 port, err := rd.ReadString()
1537 nodes[j].Addr = net.JoinHostPort(ip, port)
1540 id, err := rd.ReadString()
1548 slots[i] = ClusterSlot{
1557 //------------------------------------------------------------------------------
1559 // GeoLocation is used with GeoAdd to add geospatial location.
1560 type GeoLocation struct {
1562 Longitude, Latitude, Dist float64
1566 // GeoRadiusQuery is used with GeoRadius to query geospatial index.
1567 type GeoRadiusQuery struct {
1569 // Can be m, km, ft, or mi. Default is km.
1575 // Can be ASC or DESC. Default is no sort order.
1581 type GeoLocationCmd struct {
1585 locations []GeoLocation
1588 var _ Cmder = (*GeoLocationCmd)(nil)
1590 func NewGeoLocationCmd(q *GeoRadiusQuery, args ...interface{}) *GeoLocationCmd {
1591 args = append(args, q.Radius)
1593 args = append(args, q.Unit)
1595 args = append(args, "km")
1598 args = append(args, "withcoord")
1601 args = append(args, "withdist")
1604 args = append(args, "withhash")
1607 args = append(args, "count", q.Count)
1610 args = append(args, q.Sort)
1613 args = append(args, "store")
1614 args = append(args, q.Store)
1616 if q.StoreDist != "" {
1617 args = append(args, "storedist")
1618 args = append(args, q.StoreDist)
1620 return &GeoLocationCmd{
1621 baseCmd: baseCmd{_args: args},
1626 func (cmd *GeoLocationCmd) Val() []GeoLocation {
1627 return cmd.locations
1630 func (cmd *GeoLocationCmd) Result() ([]GeoLocation, error) {
1631 return cmd.locations, cmd.err
1634 func (cmd *GeoLocationCmd) String() string {
1635 return cmdString(cmd, cmd.locations)
1638 func (cmd *GeoLocationCmd) readReply(rd *proto.Reader) error {
1640 v, cmd.err = rd.ReadArrayReply(newGeoLocationSliceParser(cmd.q))
1644 cmd.locations = v.([]GeoLocation)
1648 func newGeoLocationParser(q *GeoRadiusQuery) proto.MultiBulkParse {
1649 return func(rd *proto.Reader, n int64) (interface{}, error) {
1653 loc.Name, err = rd.ReadString()
1658 loc.Dist, err = rd.ReadFloatReply()
1664 loc.GeoHash, err = rd.ReadIntReply()
1670 n, err := rd.ReadArrayLen()
1675 return nil, fmt.Errorf("got %d coordinates, expected 2", n)
1678 loc.Longitude, err = rd.ReadFloatReply()
1682 loc.Latitude, err = rd.ReadFloatReply()
1692 func newGeoLocationSliceParser(q *GeoRadiusQuery) proto.MultiBulkParse {
1693 return func(rd *proto.Reader, n int64) (interface{}, error) {
1694 locs := make([]GeoLocation, 0, n)
1695 for i := int64(0); i < n; i++ {
1696 v, err := rd.ReadReply(newGeoLocationParser(q))
1700 switch vv := v.(type) {
1702 locs = append(locs, GeoLocation{
1706 locs = append(locs, *vv)
1708 return nil, fmt.Errorf("got %T, expected string or *GeoLocation", v)
1715 //------------------------------------------------------------------------------
1717 type GeoPos struct {
1718 Longitude, Latitude float64
1721 type GeoPosCmd struct {
1727 var _ Cmder = (*GeoPosCmd)(nil)
1729 func NewGeoPosCmd(args ...interface{}) *GeoPosCmd {
1731 baseCmd: baseCmd{_args: args},
1735 func (cmd *GeoPosCmd) Val() []*GeoPos {
1736 return cmd.positions
1739 func (cmd *GeoPosCmd) Result() ([]*GeoPos, error) {
1740 return cmd.Val(), cmd.Err()
1743 func (cmd *GeoPosCmd) String() string {
1744 return cmdString(cmd, cmd.positions)
1747 func (cmd *GeoPosCmd) readReply(rd *proto.Reader) error {
1749 v, cmd.err = rd.ReadArrayReply(geoPosSliceParser)
1753 cmd.positions = v.([]*GeoPos)
1757 func geoPosSliceParser(rd *proto.Reader, n int64) (interface{}, error) {
1758 positions := make([]*GeoPos, 0, n)
1759 for i := int64(0); i < n; i++ {
1760 v, err := rd.ReadReply(geoPosParser)
1763 positions = append(positions, nil)
1768 switch v := v.(type) {
1770 positions = append(positions, v)
1772 return nil, fmt.Errorf("got %T, expected *GeoPos", v)
1775 return positions, nil
1778 func geoPosParser(rd *proto.Reader, n int64) (interface{}, error) {
1782 pos.Longitude, err = rd.ReadFloatReply()
1787 pos.Latitude, err = rd.ReadFloatReply()
1795 //------------------------------------------------------------------------------
1797 type CommandInfo struct {
1807 type CommandsInfoCmd struct {
1810 val map[string]*CommandInfo
1813 var _ Cmder = (*CommandsInfoCmd)(nil)
1815 func NewCommandsInfoCmd(args ...interface{}) *CommandsInfoCmd {
1816 return &CommandsInfoCmd{
1817 baseCmd: baseCmd{_args: args},
1821 func (cmd *CommandsInfoCmd) Val() map[string]*CommandInfo {
1825 func (cmd *CommandsInfoCmd) Result() (map[string]*CommandInfo, error) {
1826 return cmd.Val(), cmd.Err()
1829 func (cmd *CommandsInfoCmd) String() string {
1830 return cmdString(cmd, cmd.val)
1833 func (cmd *CommandsInfoCmd) readReply(rd *proto.Reader) error {
1835 v, cmd.err = rd.ReadArrayReply(commandInfoSliceParser)
1839 cmd.val = v.(map[string]*CommandInfo)
1843 // Implements proto.MultiBulkParse
1844 func commandInfoSliceParser(rd *proto.Reader, n int64) (interface{}, error) {
1845 m := make(map[string]*CommandInfo, n)
1846 for i := int64(0); i < n; i++ {
1847 v, err := rd.ReadReply(commandInfoParser)
1851 vv := v.(*CommandInfo)
1858 func commandInfoParser(rd *proto.Reader, n int64) (interface{}, error) {
1863 return nil, fmt.Errorf("redis: got %d elements in COMMAND reply, wanted 6", n)
1866 cmd.Name, err = rd.ReadString()
1871 arity, err := rd.ReadIntReply()
1875 cmd.Arity = int8(arity)
1877 flags, err := rd.ReadReply(stringSliceParser)
1881 cmd.Flags = flags.([]string)
1883 firstKeyPos, err := rd.ReadIntReply()
1887 cmd.FirstKeyPos = int8(firstKeyPos)
1889 lastKeyPos, err := rd.ReadIntReply()
1893 cmd.LastKeyPos = int8(lastKeyPos)
1895 stepCount, err := rd.ReadIntReply()
1899 cmd.StepCount = int8(stepCount)
1901 for _, flag := range cmd.Flags {
1902 if flag == "readonly" {
1911 //------------------------------------------------------------------------------
1913 type cmdsInfoCache struct {
1914 fn func() (map[string]*CommandInfo, error)
1917 cmds map[string]*CommandInfo
1920 func newCmdsInfoCache(fn func() (map[string]*CommandInfo, error)) *cmdsInfoCache {
1921 return &cmdsInfoCache{
1926 func (c *cmdsInfoCache) Get() (map[string]*CommandInfo, error) {
1927 err := c.once.Do(func() error {