thinRedis

thinRedis is a high performance standalone cache server written by GO.
It implemented full RESP(Redis Serialization Protocol), so it supports all Redis clients.

Features

• Support all Clients based on RESP protocol
• Support String, List, Set, Hash data types
• Support TTL(Key-Value pair will be deleted after TTL)
• Full in-memory storage
• Support atomic operation for some needed commands(like INCR, DECR, INCRBY, MSET, SMOVE, etc.)

Usage

Build thinRedis from source code:

$ go build -o thinRedis main.go

Start thinRedis server:

$ ./thinRedis
[info][server.go:26] 2022/09/08 13:23:50 [Server Listen at  127.0.0.1 : 6379]

Use start option commands or config file to change default settings:

$ ./thinRedis -h
Usage of ./thinredis:
  -config string
        Appoint a config file: such as /etc/redis.conf
  -host string
        Bind host ip: default is 127.0.0.1 (default "127.0.0.1")
  -logdir string
        Set log directory: default is /tmp (default "./")
  -loglevel string
        Set log level: default is info (default "info")
  -port int
        Bind a listening port: default is 6379 (default 6379)

Communication with thinRedis server

Any redis client can communicate with thinRedis server.
For example, use redis-cli to communicate with thinRedis server:

# start a thinRedis server listening at 12345 port
$ ./thinredis -port 12345
[info][server.go:26] 2022/09/08 13:31:47 [Server Listen at  127.0.0.1 : 12345]
                      ...

# start a redis-cli and connect to thinRedis server
$ redis-cli -p 12345
127.0.0.1:12345> PING
PONG
127.0.0.1:12345> MSET key1 a key2 b
OK
127.0.0.1:12345> MGET key1 key2 nonekey
1) "a"
2) "b"
3) (nil)
127.0.0.1:12345> RPUSH list1 1 2 3 4 5
(integer) 5
127.0.0.1:12345> LRANGE list1 0 -1
1) "1"
2) "2"
3) "3"
4) "4"
5) "5"
127.0.0.1:12345> TYPE list1
list
127.0.0.1:12345> EXPIRE list1 100
(integer) 1
# wait for a few seconds
127.0.0.1:12345> TTL list1
(integer) 93
127.0.0.1:12345> PERSIST list1
(integer) 1
127.0.0.1:12345> TTL list1
(integer) -1

Benchmark

Benchmark result is based on redis-benchmark tool.
Testing on ThinkBook Laptop with AMD Ryzen 7 5800H@3.20GHz, 16.0 GB RAM, and on windows 11 wsl2 ubuntu 22.04 system.

benchmark -c 50 -n 200000 -t get

get: 168634.06 requests per second
set: 167644.59 requests per second
incr: 164068.91 requests per second
lpush: 165152.77 requests per second
rpush: 162601.62 requests per second
lpop: 165152.77 requests per second
rpop: 165562.92 requests per second
sadd: 161420.50 requests per second
hset: 162469.55 requests per second
spop: 168350.17 requests per second

lrange_100: 50620.10 requests per second
lrange_300: 20132.88 requests per second
lrange_500: 12051.10 requests per second
lrange_600: 11992.56 requests per second
mset: 109289.62 requests per second

Support Commands

All commands used as redis commands. You can use any redis client to communicate with thinRedis.

key	string	list	set	hash
del	set	llen	sadd	hdel
exists	get	lindex	scard	hexists
keys	getrange	lpos	sdiff	hget
expire	setrange	lpop	sdirrstore	hgetall
persist	mget	rpop	sinter	hincrby
ttl	mset	lpush	sinterstore	hincrbyfloat
type	setex	lpushx	sismember	hkeys
rename	setnx	rpush	smembers	hlen
	strlen	rpushx	smove	hmget
	incr	lset	spop	hset
	incrby	lrem	srandmember	hsetnx
	decr	ltrim	srem	hvals
	decrby	lrange	sunion	hstrlen
	incrbyfloat	lmove	sunionstore	hrandfield
	append