libredis

README

libredis

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.

Features

Redis Client

The client code is a fork from Goredis. The code is being cleaned up and rewritten for better performance and developer usability.

API Volatility

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.

Notables

• 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

Recent Major Updates

Phase 2: Major Feature Categories (22 New Commands)

Libredis now includes comprehensive support for Redis's most advanced features:

Redis Streams

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.

Geospatial Operations

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.

Phase 3: Security & Management Features (29 New Commands)

Enterprise-grade capabilities for production Redis deployments:

ACL Security Management

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.

Enhanced Pub/Sub & Monitoring

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

Database Administration

Professional database management tools:

• Database Operations: SWAPDB, REPLICAOF (modern replacement for SLAVEOF)
• Module Management: MODULE LIST

Phase 1: Core Missing Commands (24 New Commands)

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

Redis Info

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.

Sentinel Info

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.

Related Articles

• Redis Commands
• Redis Protocol
• Sentinel
• GoDoc

Running Tests

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

Running Benchmarks

go test -test.run=none -test.bench="Benchmark.*"