550 lines
13 KiB
Go
550 lines
13 KiB
Go
package miniredis
|
|
|
|
// Commands to modify and query our databases directly.
|
|
|
|
import (
|
|
"errors"
|
|
"time"
|
|
)
|
|
|
|
var (
|
|
// ErrKeyNotFound is returned when a key doesn't exist.
|
|
ErrKeyNotFound = errors.New(msgKeyNotFound)
|
|
// ErrWrongType when a key is not the right type.
|
|
ErrWrongType = errors.New(msgWrongType)
|
|
// ErrIntValueError can returned by INCRBY
|
|
ErrIntValueError = errors.New(msgInvalidInt)
|
|
// ErrFloatValueError can returned by INCRBYFLOAT
|
|
ErrFloatValueError = errors.New(msgInvalidFloat)
|
|
)
|
|
|
|
// Select sets the DB id for all direct commands.
|
|
func (m *Miniredis) Select(i int) {
|
|
m.Lock()
|
|
defer m.Unlock()
|
|
m.selectedDB = i
|
|
}
|
|
|
|
// Keys returns all keys from the selected database, sorted.
|
|
func (m *Miniredis) Keys() []string {
|
|
return m.DB(m.selectedDB).Keys()
|
|
}
|
|
|
|
// Keys returns all keys, sorted.
|
|
func (db *RedisDB) Keys() []string {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
return db.allKeys()
|
|
}
|
|
|
|
// FlushAll removes all keys from all databases.
|
|
func (m *Miniredis) FlushAll() {
|
|
m.Lock()
|
|
defer m.Unlock()
|
|
m.flushAll()
|
|
}
|
|
|
|
func (m *Miniredis) flushAll() {
|
|
for _, db := range m.dbs {
|
|
db.flush()
|
|
}
|
|
}
|
|
|
|
// FlushDB removes all keys from the selected database.
|
|
func (m *Miniredis) FlushDB() {
|
|
m.DB(m.selectedDB).FlushDB()
|
|
}
|
|
|
|
// FlushDB removes all keys.
|
|
func (db *RedisDB) FlushDB() {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
db.flush()
|
|
}
|
|
|
|
// Get returns string keys added with SET.
|
|
func (m *Miniredis) Get(k string) (string, error) {
|
|
return m.DB(m.selectedDB).Get(k)
|
|
}
|
|
|
|
// Get returns a string key.
|
|
func (db *RedisDB) Get(k string) (string, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if !db.exists(k) {
|
|
return "", ErrKeyNotFound
|
|
}
|
|
if db.t(k) != "string" {
|
|
return "", ErrWrongType
|
|
}
|
|
return db.stringGet(k), nil
|
|
}
|
|
|
|
// Set sets a string key. Removes expire.
|
|
func (m *Miniredis) Set(k, v string) error {
|
|
return m.DB(m.selectedDB).Set(k, v)
|
|
}
|
|
|
|
// Set sets a string key. Removes expire.
|
|
// Unlike redis the key can't be an existing non-string key.
|
|
func (db *RedisDB) Set(k, v string) error {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
|
|
if db.exists(k) && db.t(k) != "string" {
|
|
return ErrWrongType
|
|
}
|
|
db.del(k, true) // Remove expire
|
|
db.stringSet(k, v)
|
|
return nil
|
|
}
|
|
|
|
// Incr changes a int string value by delta.
|
|
func (m *Miniredis) Incr(k string, delta int) (int, error) {
|
|
return m.DB(m.selectedDB).Incr(k, delta)
|
|
}
|
|
|
|
// Incr changes a int string value by delta.
|
|
func (db *RedisDB) Incr(k string, delta int) (int, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
|
|
if db.exists(k) && db.t(k) != "string" {
|
|
return 0, ErrWrongType
|
|
}
|
|
|
|
return db.stringIncr(k, delta)
|
|
}
|
|
|
|
// Incrfloat changes a float string value by delta.
|
|
func (m *Miniredis) Incrfloat(k string, delta float64) (float64, error) {
|
|
return m.DB(m.selectedDB).Incrfloat(k, delta)
|
|
}
|
|
|
|
// Incrfloat changes a float string value by delta.
|
|
func (db *RedisDB) Incrfloat(k string, delta float64) (float64, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
|
|
if db.exists(k) && db.t(k) != "string" {
|
|
return 0, ErrWrongType
|
|
}
|
|
|
|
return db.stringIncrfloat(k, delta)
|
|
}
|
|
|
|
// List returns the list k, or an error if it's not there or something else.
|
|
// This is the same as the Redis command `LRANGE 0 -1`, but you can do your own
|
|
// range-ing.
|
|
func (m *Miniredis) List(k string) ([]string, error) {
|
|
return m.DB(m.selectedDB).List(k)
|
|
}
|
|
|
|
// List returns the list k, or an error if it's not there or something else.
|
|
// This is the same as the Redis command `LRANGE 0 -1`, but you can do your own
|
|
// range-ing.
|
|
func (db *RedisDB) List(k string) ([]string, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
|
|
if !db.exists(k) {
|
|
return nil, ErrKeyNotFound
|
|
}
|
|
if db.t(k) != "list" {
|
|
return nil, ErrWrongType
|
|
}
|
|
return db.listKeys[k], nil
|
|
}
|
|
|
|
// Lpush is an unshift. Returns the new length.
|
|
func (m *Miniredis) Lpush(k, v string) (int, error) {
|
|
return m.DB(m.selectedDB).Lpush(k, v)
|
|
}
|
|
|
|
// Lpush is an unshift. Returns the new length.
|
|
func (db *RedisDB) Lpush(k, v string) (int, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
|
|
if db.exists(k) && db.t(k) != "list" {
|
|
return 0, ErrWrongType
|
|
}
|
|
return db.listLpush(k, v), nil
|
|
}
|
|
|
|
// Lpop is a shift. Returns the popped element.
|
|
func (m *Miniredis) Lpop(k string) (string, error) {
|
|
return m.DB(m.selectedDB).Lpop(k)
|
|
}
|
|
|
|
// Lpop is a shift. Returns the popped element.
|
|
func (db *RedisDB) Lpop(k string) (string, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
|
|
if !db.exists(k) {
|
|
return "", ErrKeyNotFound
|
|
}
|
|
if db.t(k) != "list" {
|
|
return "", ErrWrongType
|
|
}
|
|
return db.listLpop(k), nil
|
|
}
|
|
|
|
// Push add element at the end. Is called RPUSH in redis. Returns the new length.
|
|
func (m *Miniredis) Push(k string, v ...string) (int, error) {
|
|
return m.DB(m.selectedDB).Push(k, v...)
|
|
}
|
|
|
|
// Push add element at the end. Is called RPUSH in redis. Returns the new length.
|
|
func (db *RedisDB) Push(k string, v ...string) (int, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
|
|
if db.exists(k) && db.t(k) != "list" {
|
|
return 0, ErrWrongType
|
|
}
|
|
return db.listPush(k, v...), nil
|
|
}
|
|
|
|
// Pop removes and returns the last element. Is called RPOP in Redis.
|
|
func (m *Miniredis) Pop(k string) (string, error) {
|
|
return m.DB(m.selectedDB).Pop(k)
|
|
}
|
|
|
|
// Pop removes and returns the last element. Is called RPOP in Redis.
|
|
func (db *RedisDB) Pop(k string) (string, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
|
|
if !db.exists(k) {
|
|
return "", ErrKeyNotFound
|
|
}
|
|
if db.t(k) != "list" {
|
|
return "", ErrWrongType
|
|
}
|
|
|
|
return db.listPop(k), nil
|
|
}
|
|
|
|
// SetAdd adds keys to a set. Returns the number of new keys.
|
|
func (m *Miniredis) SetAdd(k string, elems ...string) (int, error) {
|
|
return m.DB(m.selectedDB).SetAdd(k, elems...)
|
|
}
|
|
|
|
// SetAdd adds keys to a set. Returns the number of new keys.
|
|
func (db *RedisDB) SetAdd(k string, elems ...string) (int, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if db.exists(k) && db.t(k) != "set" {
|
|
return 0, ErrWrongType
|
|
}
|
|
return db.setAdd(k, elems...), nil
|
|
}
|
|
|
|
// Members gives all set keys. Sorted.
|
|
func (m *Miniredis) Members(k string) ([]string, error) {
|
|
return m.DB(m.selectedDB).Members(k)
|
|
}
|
|
|
|
// Members gives all set keys. Sorted.
|
|
func (db *RedisDB) Members(k string) ([]string, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if !db.exists(k) {
|
|
return nil, ErrKeyNotFound
|
|
}
|
|
if db.t(k) != "set" {
|
|
return nil, ErrWrongType
|
|
}
|
|
return db.setMembers(k), nil
|
|
}
|
|
|
|
// IsMember tells if value is in the set.
|
|
func (m *Miniredis) IsMember(k, v string) (bool, error) {
|
|
return m.DB(m.selectedDB).IsMember(k, v)
|
|
}
|
|
|
|
// IsMember tells if value is in the set.
|
|
func (db *RedisDB) IsMember(k, v string) (bool, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if !db.exists(k) {
|
|
return false, ErrKeyNotFound
|
|
}
|
|
if db.t(k) != "set" {
|
|
return false, ErrWrongType
|
|
}
|
|
return db.setIsMember(k, v), nil
|
|
}
|
|
|
|
// HKeys returns all (sorted) keys ('fields') for a hash key.
|
|
func (m *Miniredis) HKeys(k string) ([]string, error) {
|
|
return m.DB(m.selectedDB).HKeys(k)
|
|
}
|
|
|
|
// HKeys returns all (sorted) keys ('fields') for a hash key.
|
|
func (db *RedisDB) HKeys(key string) ([]string, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if !db.exists(key) {
|
|
return nil, ErrKeyNotFound
|
|
}
|
|
if db.t(key) != "hash" {
|
|
return nil, ErrWrongType
|
|
}
|
|
return db.hashFields(key), nil
|
|
}
|
|
|
|
// Del deletes a key and any expiration value. Returns whether there was a key.
|
|
func (m *Miniredis) Del(k string) bool {
|
|
return m.DB(m.selectedDB).Del(k)
|
|
}
|
|
|
|
// Del deletes a key and any expiration value. Returns whether there was a key.
|
|
func (db *RedisDB) Del(k string) bool {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if !db.exists(k) {
|
|
return false
|
|
}
|
|
db.del(k, true)
|
|
return true
|
|
}
|
|
|
|
// TTL is the left over time to live. As set via EXPIRE, PEXPIRE, EXPIREAT,
|
|
// PEXPIREAT.
|
|
// 0 if not set.
|
|
func (m *Miniredis) TTL(k string) time.Duration {
|
|
return m.DB(m.selectedDB).TTL(k)
|
|
}
|
|
|
|
// TTL is the left over time to live. As set via EXPIRE, PEXPIRE, EXPIREAT,
|
|
// PEXPIREAT.
|
|
// 0 if not set.
|
|
func (db *RedisDB) TTL(k string) time.Duration {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
return db.ttl[k]
|
|
}
|
|
|
|
// SetTTL sets the TTL of a key.
|
|
func (m *Miniredis) SetTTL(k string, ttl time.Duration) {
|
|
m.DB(m.selectedDB).SetTTL(k, ttl)
|
|
}
|
|
|
|
// SetTTL sets the time to live of a key.
|
|
func (db *RedisDB) SetTTL(k string, ttl time.Duration) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
db.ttl[k] = ttl
|
|
db.keyVersion[k]++
|
|
}
|
|
|
|
// Type gives the type of a key, or ""
|
|
func (m *Miniredis) Type(k string) string {
|
|
return m.DB(m.selectedDB).Type(k)
|
|
}
|
|
|
|
// Type gives the type of a key, or ""
|
|
func (db *RedisDB) Type(k string) string {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
return db.t(k)
|
|
}
|
|
|
|
// Exists tells whether a key exists.
|
|
func (m *Miniredis) Exists(k string) bool {
|
|
return m.DB(m.selectedDB).Exists(k)
|
|
}
|
|
|
|
// Exists tells whether a key exists.
|
|
func (db *RedisDB) Exists(k string) bool {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
return db.exists(k)
|
|
}
|
|
|
|
// HGet returns hash keys added with HSET.
|
|
// This will return an empty string if the key is not set. Redis would return
|
|
// a nil.
|
|
// Returns empty string when the key is of a different type.
|
|
func (m *Miniredis) HGet(k, f string) string {
|
|
return m.DB(m.selectedDB).HGet(k, f)
|
|
}
|
|
|
|
// HGet returns hash keys added with HSET.
|
|
// Returns empty string when the key is of a different type.
|
|
func (db *RedisDB) HGet(k, f string) string {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
h, ok := db.hashKeys[k]
|
|
if !ok {
|
|
return ""
|
|
}
|
|
return h[f]
|
|
}
|
|
|
|
// HSet sets a hash key.
|
|
// If there is another key by the same name it will be gone.
|
|
func (m *Miniredis) HSet(k, f, v string) {
|
|
m.DB(m.selectedDB).HSet(k, f, v)
|
|
}
|
|
|
|
// HSet sets a hash key.
|
|
// If there is another key by the same name it will be gone.
|
|
func (db *RedisDB) HSet(k, f, v string) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
db.hashSet(k, f, v)
|
|
}
|
|
|
|
// HDel deletes a hash key.
|
|
func (m *Miniredis) HDel(k, f string) {
|
|
m.DB(m.selectedDB).HDel(k, f)
|
|
}
|
|
|
|
// HDel deletes a hash key.
|
|
func (db *RedisDB) HDel(k, f string) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
db.hdel(k, f)
|
|
}
|
|
|
|
func (db *RedisDB) hdel(k, f string) {
|
|
if _, ok := db.hashKeys[k]; !ok {
|
|
return
|
|
}
|
|
delete(db.hashKeys[k], f)
|
|
db.keyVersion[k]++
|
|
}
|
|
|
|
// HIncr increases a key/field by delta (int).
|
|
func (m *Miniredis) HIncr(k, f string, delta int) (int, error) {
|
|
return m.DB(m.selectedDB).HIncr(k, f, delta)
|
|
}
|
|
|
|
// HIncr increases a key/field by delta (int).
|
|
func (db *RedisDB) HIncr(k, f string, delta int) (int, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
return db.hashIncr(k, f, delta)
|
|
}
|
|
|
|
// HIncrfloat increases a key/field by delta (float).
|
|
func (m *Miniredis) HIncrfloat(k, f string, delta float64) (float64, error) {
|
|
return m.DB(m.selectedDB).HIncrfloat(k, f, delta)
|
|
}
|
|
|
|
// HIncrfloat increases a key/field by delta (float).
|
|
func (db *RedisDB) HIncrfloat(k, f string, delta float64) (float64, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
return db.hashIncrfloat(k, f, delta)
|
|
}
|
|
|
|
// SRem removes fields from a set. Returns number of deleted fields.
|
|
func (m *Miniredis) SRem(k string, fields ...string) (int, error) {
|
|
return m.DB(m.selectedDB).SRem(k, fields...)
|
|
}
|
|
|
|
// SRem removes fields from a set. Returns number of deleted fields.
|
|
func (db *RedisDB) SRem(k string, fields ...string) (int, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if !db.exists(k) {
|
|
return 0, ErrKeyNotFound
|
|
}
|
|
if db.t(k) != "set" {
|
|
return 0, ErrWrongType
|
|
}
|
|
return db.setRem(k, fields...), nil
|
|
}
|
|
|
|
// ZAdd adds a score,member to a sorted set.
|
|
func (m *Miniredis) ZAdd(k string, score float64, member string) (bool, error) {
|
|
return m.DB(m.selectedDB).ZAdd(k, score, member)
|
|
}
|
|
|
|
// ZAdd adds a score,member to a sorted set.
|
|
func (db *RedisDB) ZAdd(k string, score float64, member string) (bool, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if db.exists(k) && db.t(k) != "zset" {
|
|
return false, ErrWrongType
|
|
}
|
|
return db.ssetAdd(k, score, member), nil
|
|
}
|
|
|
|
// ZMembers returns all members by score
|
|
func (m *Miniredis) ZMembers(k string) ([]string, error) {
|
|
return m.DB(m.selectedDB).ZMembers(k)
|
|
}
|
|
|
|
// ZMembers returns all members by score
|
|
func (db *RedisDB) ZMembers(k string) ([]string, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if !db.exists(k) {
|
|
return nil, ErrKeyNotFound
|
|
}
|
|
if db.t(k) != "zset" {
|
|
return nil, ErrWrongType
|
|
}
|
|
return db.ssetMembers(k), nil
|
|
}
|
|
|
|
// SortedSet returns a raw string->float64 map.
|
|
func (m *Miniredis) SortedSet(k string) (map[string]float64, error) {
|
|
return m.DB(m.selectedDB).SortedSet(k)
|
|
}
|
|
|
|
// SortedSet returns a raw string->float64 map.
|
|
func (db *RedisDB) SortedSet(k string) (map[string]float64, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if !db.exists(k) {
|
|
return nil, ErrKeyNotFound
|
|
}
|
|
if db.t(k) != "zset" {
|
|
return nil, ErrWrongType
|
|
}
|
|
return db.sortedSet(k), nil
|
|
}
|
|
|
|
// ZRem deletes a member. Returns whether the was a key.
|
|
func (m *Miniredis) ZRem(k, member string) (bool, error) {
|
|
return m.DB(m.selectedDB).ZRem(k, member)
|
|
}
|
|
|
|
// ZRem deletes a member. Returns whether the was a key.
|
|
func (db *RedisDB) ZRem(k, member string) (bool, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if !db.exists(k) {
|
|
return false, ErrKeyNotFound
|
|
}
|
|
if db.t(k) != "zset" {
|
|
return false, ErrWrongType
|
|
}
|
|
return db.ssetRem(k, member), nil
|
|
}
|
|
|
|
// ZScore gives the score of a sorted set member.
|
|
func (m *Miniredis) ZScore(k, member string) (float64, error) {
|
|
return m.DB(m.selectedDB).ZScore(k, member)
|
|
}
|
|
|
|
// ZScore gives the score of a sorted set member.
|
|
func (db *RedisDB) ZScore(k, member string) (float64, error) {
|
|
db.master.Lock()
|
|
defer db.master.Unlock()
|
|
if !db.exists(k) {
|
|
return 0, ErrKeyNotFound
|
|
}
|
|
if db.t(k) != "zset" {
|
|
return 0, ErrWrongType
|
|
}
|
|
return db.ssetScore(k, member), nil
|
|
}
|