LeaderboardDB

LeaderboardDB is storage for sorted lists with custom field filters. Leaderboard uses the Redis RESP protocol.

Installation

OS X & Linux:

go get -u github.com/fatihkahveci/leaderboard-db
cd $GOPATH/github.com/fatihkahveci/leaderboard-db
go install
leaderboard-db

Flags

Flag	Desc
addr	LeaderboardDB port --> Default: :6488
dbPath	LeaderboardDB dbpath --> Default: leaderboard.db

Commands

Command	Params	Example
add	leaderboardKey, memberKey, score, [fields] (optional)	add diablo_3 user_1 123 character demon_hunter
leaderboard	leaderboardKey, start, stop, [fields] (optional)	leaderboard diablo_3 0 -1 character demon_hunter
del	leaderboardKey	del diablo_3
delmember	leaderboardKey, key	del diablo_3 user_1
updatescore	leaderboardKey, key, score	updatescore diablo_3 user_1 3
score	leaderboardKey, key	score diablo_3 user_1
rank	leaderboardKey, key	rank diablo_3 user_1

Examples

Let's say you need to store Diablo 3 player scores and need to filter character and country.

First we need to connect LeaderboardDB with resp.

redis-cli -p 6488

And then we need to add users to diablo_3 leaderboard.

add diablo_3 user_1 100 character wizard country tr
add diablo_3 user_2 105 character monk country tr
add diablo_3 user_3 95 character monk country tr
add diablo_3 user_4 95 character monk country us
add diablo_3 user_5 96 character demon_hunter country us

If you need to get all users in this leaderboard playing monk.

leaderboard diablo_3 0 -1 character monk

Response will be:

1) "user_2"
2) "user_3"
3) "user_4"

Or maybe you need to get all monk player in some country.

leaderboard diablo_3 0 -1 character monk country tr

Then response will be:

1) "user_2"
2) "user_3"

Or maybe you don't need any filter

leaderboard diablo_3 0 -1

Then response will be:

1) "user_2"
2) "user_1"
3) "user_5"
4) "user_3"
5) "user_4"

Benchmark

goos: darwin
goarch: amd64
pkg: github.com/fatihkahveci/leaderboard-db
BenchmarkStore_AddMember-12            	 7140470	       169 ns/op
BenchmarkStore_UpdateMemberScore-12    	 9780445	       124 ns/op
BenchmarkStore_GetSort-12              	 3768985	       383 ns/op
BenchmarkStore_GetSortWithFilter-12    	 1391335	       809 ns/op
BenchmarkStore_MemberRank-12           	13890780	        92.1 ns/op
BenchmarkStore_MemberScore-12          	14312134	        71.9 ns/op

Todos

• Docker Container for LeaderboardDB
• Maybe Raft support?

Thanks

Thanks for logo @eraydemirok