This is the third revision of this project, the previous one has been deprecated but can be found here.
This project's name was recently changed from
account for go's new module system. As long as you are using the
latest update of your major go version (1.9.7+, 1.10.3+, 1.11+) the module-aware
go get should work correctly with the new import path.
I'm sorry to anyone for whom this change broke their build, I tried very hard to not have to do it, but ultimately it was the only way that made sense for the future. Hopefully the only thing needed to fix the breakage is to change the import paths and re-run 'go get'.
Installation and Usage
go get github.com/mediocregopher/radix/v3 // import github.com/mediocregopher/radix/v3
Legacy GOPATH mode:
go get github.com/mediocregopher/radix // import github.com/mediocregopher/radix
# requires a redis server running on 127.0.0.1:6379 go test github.com/mediocregopher/radix/v3
Standard print-like API which supports all current and future redis commands
Support for using an io.Reader as a command argument and writing responses to an io.Writer.
Support for pubsub, as well as persistent pubsub wherein if a connection is lost a new one transparently replaces it.
Nearly all important types are interfaces, allowing for custom implementations of nearly anything.
Thanks to a huge amount of work put in by @nussjustin, and inspiration from the redispipe project and @funny-falcon, radix/v3 is significantly faster than most redis drivers, including redigo, for normal parallel workloads, and is pretty comparable for serial workloads.
# go test -v -run=XXX -bench=GetSet -benchmem >/tmp/radix.stat # benchstat radix.stat name time/op SerialGetSet/radix 89.1µs ± 7% SerialGetSet/redigo 87.3µs ± 7% ParallelGetSet/radix/default-8 5.47µs ± 2% <--- The good stuff ParallelGetSet/redigo-8 27.6µs ± 2% ParallelGetSet/redispipe-8 4.16µs ± 3% name alloc/op SerialGetSet/radix 67.0B ± 0% SerialGetSet/redigo 86.0B ± 0% ParallelGetSet/radix/default-8 73.0B ± 0% ParallelGetSet/redigo-8 138B ± 4% ParallelGetSet/redispipe-8 168B ± 0% name allocs/op SerialGetSet/radix 4.00 ± 0% SerialGetSet/redigo 5.00 ± 0% ParallelGetSet/radix/default-8 4.00 ± 0% ParallelGetSet/redigo-8 6.00 ± 0% ParallelGetSet/redispipe-8 8.00 ± 0%
Copyright and licensing
Unless otherwise noted, the source files are distributed under the MIT License found in the LICENSE.txt file.