heroagent/pkg/servers/redisserver

Redis Server Package

A lightweight, in-memory Redis-compatible server implementation in Go. This package provides a Redis-like server that can be embedded in your Go applications.

Features

• Supports both TCP and Unix socket connections
• In-memory data storage with key expiration
• Implements common Redis commands
• Thread-safe operations
• Automatic cleanup of expired keys

Supported Commands

The server implements the following Redis commands:

• Basic: PING, SET, GET, DEL, KEYS, EXISTS, TYPE, TTL, INFO, INCR
• Hash operations: HSET, HGET, HDEL, HKEYS, HLEN
• List operations: LPUSH, RPUSH, LPOP, RPOP, LLEN, LRANGE
• Cursor-based iteration: SCAN, HSCAN

Usage

Basic Usage

import "github.com/freeflowuniverse/heroagent/pkg/redisserver"

// Create a new server with default configuration
server := redisserver.NewServer(redisserver.ServerConfig{
    TCPPort: "6379",                  // TCP port to listen on
    UnixSocketPath: "/tmp/redis.sock" // Unix socket path (optional)
})

// The server starts automatically and runs in background goroutines

Connecting to the Server

You can connect to the server using any Redis client. For example, using the go-redis package:

import "github.com/redis/go-redis/v9"

// Connect via TCP
client := redis.NewClient(&redis.Options{
    Addr: "localhost:6379",
})

// Or connect via Unix socket
unixClient := redis.NewClient(&redis.Options{
    Network: "unix",
    Addr:    "/tmp/redis.sock",
})