Fred

An async Redis client for Rust.

Example

use fred::prelude::*;

#[tokio::main]
async fn main() -> Result<(), RedisError> {
  let client = RedisClient::default();
  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

• RESP2 and RESP3 protocol modes.
• Clustered, centralized, and sentinel Redis deployments.
• TLS connections via native-tls and/or rustls.
• Optional reconnection logic with multiple backoff policies.
• Publish-Subscribe and keyspace events interfaces.
• A round-robin client pooling interface.
• Lua scripts or functions.
• Streaming results from the MONITOR command.
• Custom commands.
• Streaming interfaces for scanning functions.
• Transactions
• Pipelining
• Client Tracking
• An optional RedisJSON interface.
• A round-robin cluster replica routing interface.
• An optional pubsub subscriber client that will automatically manage channel subscriptions.
• Tracing

Build Features