Fred

An async Redis client for Rust and Tokio.

Example

use fred::prelude::*;

#[tokio::main]
async fn main() -> Result<(), RedisError> {
  let client = RedisClient::default();
  client.init().await?;

  // convert responses to many common Rust types
  let foo: Option<String> = client.get("foo").await?;
  assert!(foo.is_none());

  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");

  client.quit().await?;
  Ok(())
}

See the examples for more.

Features

• RESP2 and RESP3 protocol modes.
• Clustered, centralized, and sentinel Redis deployments.
• TLS via native-tls or rustls.
• Unix sockets.
• Efficient automatic pipelining
• Zero-copy frame parsing
• Optional reconnection features.
• 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
• A RedisJSON interface.
• A round-robin cluster replica routing interface.
• A subscriber client that will automatically manage channel subscriptions.
• Tracing

Build Features

Interface Features

The Redis interface has many functions and compile times can add up quickly. Interface features begin with i- and control which public interfaces are built.

Debugging Features