Libredis is a library for interacting with Redis. This includes (a '^' indicates features planned and/or in dev):
- client connection
- Sentinel interaction and management
- Support for SENTINEL commands
- Ability for client code to manage Sentinel
- Dedicated control methods^
- Redis INFO parsing
- Inbuilt Sentinel discovery support^
- Inbuilt Redis Cluster support^
- Tested under Go 1.24+ and Redis >= 2.8.13
Libredis is intended to be more than a simple client connection library. It will include Redis specific custom operations, Structures, and capabilities suitable for integrating with any Go code which interacts with Redis ranging from simple CRUD operations to service management.
The client code is a fork from Goredis. The code is being cleaned up and rewritten for better performance and developer usability.
The original API, while better than other libraries, did not meet what I felt the API should look like. The info command returned simple strings, any command which supported variadic arguments required them, and certain errors should be handled at a lower level and returned in a more formal manner at the API level.
As such, the API is currently under a bit of flux. Any command which
accepts variadic paramters such as ZAdd will be changing to be of the
simple form with Variadic added for the variadic call. For example, ZAdd
will take the key, score, and value while ZAddVariadic will take a
map[string]float64 to variadic commands. This pattern will spread
through the code as I find them or find the time to pre-emptively fix
them.
Where appropriate certain known errors will be converted from raw Redis errors to typed CommandErrors to provide simpler error handling. It is likely all commands will return a typed CommandError to provide commonality across the client API.
- Python Redis Client Like API
- Support Pipeling
- Support Transaction
- Support Publish Subscribe
- Support Lua Eval
- Support Connection Pool
- Support Dial URL-Like
- Support for Sentinel commands
- Support Parsing Redis Info commands into Maps and structs
- Support monitor, sort, scan, slowlog .etc
- SSL Support! If you have a provider or proxy providing an SSL endpoint you can now connect to it via libredis.
- Redis Streams Support - Complete implementation with consumer groups and stream management
- Geospatial Operations - Location-based operations with radius and area search capabilities
- ACL Security Management - Enterprise-grade user authentication and access control
- Performance Monitoring - Memory usage analysis and latency tracking
- Enhanced Pub/Sub - Information commands and sharded messaging for Redis 7.0+
- Comprehensive Command Coverage - 75 new commands added across all Redis feature categories
Libredis now includes comprehensive support for Redis's most advanced features:
Complete implementation of Redis Streams including:
- Basic Operations:
XADD,XREAD,XRANGE,XREVRANGE,XLEN,XDEL,XTRIM - Consumer Groups:
XGROUP CREATE/DESTROY/SETID,XREADGROUP,XACK,XCLAIM,XPENDING - Stream Information:
XINFO STREAM/GROUPS/CONSUMERS
Redis Streams provide powerful event streaming capabilities with consumer group semantics similar to Apache Kafka, enabling reliable message processing at scale.
Full geospatial support for location-based applications:
- Basic Operations:
GEOADD,GEODIST,GEOHASH,GEOPOS - Modern Search:
GEOSEARCH,GEOSEARCHSTORE(Redis 6.2+) - Legacy Search:
GEORADIUS,GEORADIUSBYMEMBER(deprecated but supported)
Geospatial operations enable proximity searches, distance calculations, and location-based queries with support for multiple distance units and search geometries.
Enterprise-grade capabilities for production Redis deployments:
Complete access control implementation for Redis 6.0+:
- User Management:
ACL SETUSER,ACL GETUSER,ACL DELUSER,ACL USERS - Permissions & Audit:
ACL CAT,ACL WHOAMI,ACL LOG,ACL DRYRUN - Configuration:
ACL LOAD,ACL SAVE,ACL LIST,ACL GENPASS
ACL features enable rule-based permissions, secure password generation, and comprehensive security audit trails for enterprise environments.
Advanced messaging and performance monitoring:
- Pub/Sub Information:
PUBSUB CHANNELS,PUBSUB NUMSUB,PUBSUB NUMPAT - Sharded Pub/Sub:
SPUBLISH,SSUBSCRIBE,SUNSUBSCRIBE(Redis 7.0+) - Memory Management:
MEMORY USAGE,MEMORY STATS,MEMORY DOCTOR,MEMORY PURGE - Latency Monitoring:
LATENCY LATEST,LATENCY GRAPH,LATENCY RESET
Professional database management tools:
- Database Operations:
SWAPDB,REPLICAOF(modern replacement for SLAVEOF) - Module Management:
MODULE LIST
Added essential Redis commands across all major data types:
- Lists:
LMOVE,BLMOVE,LPOS,LMPOP,BLMPOP - Sets:
SMISMEMBER - Sorted Sets:
ZPOPMAX,ZPOPMIN,BZPOPMAX,BZPOPMIN,ZRANDMEMBER,ZMSCORE - Hashes:
HSTRLEN,HRANDFIELD - Keys:
COPY,TOUCH,UNLINK,WAIT - Bitmaps:
BITFIELD,BITFIELD_RO,BITPOS - Connection: Enhanced
AUTH(ACL),HELLO,RESET
The info package provides functions for parsing the string results of an Redis info command. When using the libredis/client package these are unnecessary. This package is useful for those using other Redis client packages which return strings.
The arguments for INFO in Redis when being issued against a Sentinel
returned null for INFO all. This has been subsequently fixed to match
the Redis INFO all pattern. If using a Redis version of 2.8.13 or
older, use SentinelInfo instead of Info to handle this scenario.
normal test:
go test
coverage test:
go test -cover
coverage test with html result:
go test -coverprofile=cover.out
go tool cover -html=cover.out
go test -test.run=none -test.bench="Benchmark.*"