Fred

An async Redis client for Rust.

Example

use fred::prelude::*;

#[tokio::main]
async fn main() -> Result<(), RedisError> {
  let config = RedisConfig::default();
  let perf = PerformanceConfig::default();
  let policy = ReconnectPolicy::default();
  let client = RedisClient::new(config, perf, Some(policy));
  
  // connect to the server, returning a handle to the task that drives the connection
  let _ = client.connect();
  let _ = client.wait_for_connect().await?;
 
  // convert responses to many common Rust types
  let foo: Option<String> = client.get("foo").await?;
  assert!(foo.is_none());
  
  let _: () = client.set("foo", "bar", None, None, false).await?;
  // or use turbofish to declare response types
  println!("Foo: {:?}", client.get<String, _>("foo").await?);
  
  // or use a lower level interface for responses to defer parsing, etc
  let foo: RedisValue = client.get("foo").await?;
  assert_eq!(foo.as_str().unwrap(), "bar");
  
  let _ = client.quit().await?;
  Ok(())
}

See the examples for more.

Features

• Supports RESP2 and RESP3 protocol modes.
• Supports clustered, centralized, and sentinel Redis deployments.
• Optional built-in reconnection logic with multiple backoff policies.
• Publish-Subscribe and keyspace events interfaces.
• Supports transactions.
• Supports Lua scripts.
• Supports streaming results from the MONITOR command.
• Supports custom commands provided by third party modules.
• Supports TLS connections via native-tls and/or rustls.
• Supports streaming interfaces for scanning functions.
• Supports pipelining.
• Automatically retry requests under bad network conditions.
• Optional built-in tracking for network latency and payload size metrics.
• An optional client pooling interface to round-robin requests among a pool of clients.
• An optional sentinel client for interacting directly with sentinel nodes to manually fail over servers, etc.
• An optional pubsub subscriber client that will automatically manage channel subscriptions.
• An optional interface to override DNS resolution logic.
• Optional support for JSON values.

Build Time Features