$ show 2881099/FreeRedis
FreeRedis is a comprehensive .NET Redis client library that supports a wide range of Redis deployment modes including standalone, cluster, sentinel, and pooling. It provides both synchronous and asynchronous APIs for virtually all standard Redis commands (strings, hashes, lists, sets, sorted sets, streams, keys, etc.) and extends into advanced features such as distributed locks with automatic extension (watchdog), delayed queues, client-side caching, and Redis Stack modules like RediSearch, RedisJSON, and Bloom filters. The library also includes an OpenTelemetry integration for distributed tracing and a distributed cache adapter for ASP.NET Core's IDistributedCache interface. The architecture is centered around the `RedisClient` class, which uses a pluggable adapter pattern to handle different connection strategies (e.g., `PoolingAdapter`, `ClusterAdapter`, `SentinelAdapter`). Low-level socket communication is abstracted via `IRedisSocket`, and connection pooling is managed by a generic `ObjectPool<T>` with circuit breaker and health checks. The library also includes an `IdleBus` container for managing multiple connections per endpoint. Command building is handled by `CommandPacket`, which supports key prefixing and AOP interception. The RediSearch module provides a fluent builder pattern and an ORM-like `FtDocumentRepository` that translates C# expressions into RediSearch queries. Key entry points include the `RedisClient` constructors (for pooling, cluster, sentinel, and standalone), the `IRedisClient` interface, and the `FreeRedis.OpenTelemetry` extension for tracing. External dependencies are minimal: the core library targets .NET Standard 2.0, .NET Framework 4.0+, and .NET 8, with optional dependencies on `Microsoft.Extensions.Caching.Abstractions` and `OpenTelemetry`. The library is designed for high performance and low latency, with benchmarks showing competitive throughput against StackExchange.Redis and CSRedisCore.
The LLM identified 5 files worth highlighting for reuse:
A generic, thread-safe object pool with configurable policies for pool size, idle timeout, async queue capacity, and a circuit breaker state machine (Healthy → Observing → Unavailable). It supports lifecycle hooks (OnCreate, OnDestroy, OnGet, OnReturn) and health checks. This component is fully self-contained and can be extracted for use in any .NET project requiring connection pooling or resource reuse.
A generic container for managing short-lived or long-lived resources (e.g., Redis connections) with automatic creation, disposal, and background scanning for idle release. It supports expansion/contraction and is used internally for cluster node connections. The pattern is reusable for any scenario requiring a pool of named, lazily-initialized resources with cleanup.
An attribute-based ORM for RediSearch indexes that maps C# classes to Redis search documents. It uses expression trees to translate LINQ queries (e.g., `a => a.Title == "word" && a.Tags.Contains("user1")`) into RediSearch query syntax. The repository caches schema metadata and supports CRUD operations. This component is reusable for any .NET project that needs typed access to RediSearch indexes.
A Redis-backed delay queue implementation using sorted sets and Lua scripts for atomic enqueue/dequeue operations. Supports absolute and relative delays, and consumer-side polling. The pattern is self-contained and can be reused in any .NET application needing a distributed delay queue.
A distributed lock implementation using Redis SET NX with automatic extension (watchdog) to prevent lock expiration during long operations. Returns a disposable `LockController` that handles lost tokens and can be used with `using` blocks. This component is reusable for any .NET project requiring distributed locking with reliability.