How do I enable async support in redis-rs with tokio?

Add the 'tokio-comp' feature flag in your Cargo.toml: `redis = { version = "1.2", features = ["tokio-comp"] }`. Then, use the AsyncCommands or AsyncTypedCommands traits for non-blocking operations, and connections are cheaply cloneable for concurrent use.

What's the difference between redis-rs and async-redis crates?

redis-rs is the mainstream, feature-rich client with sync and async support, while async-redis is a lesser-known alternative focused solely on async. redis-rs offers more comprehensive features like TLS, clustering, and JSON, but async-redis might be simpler for pure async use cases without extra dependencies.

How to configure TLS for secure connections in redis-rs?

Enable the 'tls-native-tls' or 'tls-rustls' feature, and for rustls, install a crypto provider like `rustls::crypto::aws_lc_rs::default_provider().install_default()`. Use 'rediss://' URLs, and append '#insecure' for testing without certificate validation.

Does redis-rs work with Redis Sentinel for high availability?

No, redis-rs does not natively support Redis Sentinel; it focuses on Redis Cluster for high availability. For Sentinel, you'd need to implement custom logic or use a different client that includes Sentinel support.

How to use RedisJSON with redis-rs for storing JSON data?

Enable the 'json' feature and import the JsonCommands trait. Use methods like `json_set` to store JSON, but note that deserialization requires serde_json or the redis-macros crate for automatic handling, adding extra dependencies.

Best practices for connection pooling in redis-rs async applications?

For async, use MultiplexedConnection which is cheaply cloneable and thread-safe, so a single connection suffices. Enable the 'connection-manager' feature for automatic reconnections, and avoid blocking commands on shared connections to prevent stalls.

Open-Awesome

redis-rs

NOASSERTIONRustredis-1.4.1

A high-level Redis, Valkey, and RESP-compliant database client library for Rust with flexible type conversion.

Visit Website GitHub

4.2k stars683 forks0 contributors

What is redis-rs?

redis-rs is a Rust client library for Redis, Valkey, and any RESP-compliant database server. It provides high-level, type-safe access to Redis functionality through a flexible API with customizable type conversion, making Redis operations in Rust both powerful and ergonomic.

Target Audience

Rust developers building applications that require interaction with Redis, Valkey, or other RESP-compliant databases, particularly those needing async support, connection pooling, or advanced features like cluster compatibility and JSON integration.

Value Proposition

Developers choose redis-rs for its customizable type conversion via FromRedisValue and ToRedisArgs traits, comprehensive feature set including async support with tokio or smol, and flexibility that balances high-level ergonomics with low-level control for advanced use cases.

Overview

Redis library for rust

Use Cases

Best For

Building Rust applications that require type-safe, ergonomic interactions with Redis or Valkey databases.
Implementing async Redis clients in Rust using tokio or smol runtimes for non-blocking operations.
Developing applications that need Redis Cluster support for distributed data storage and high availability.
Integrating RedisJSON module functionality for storing and querying JSON data directly within Redis.
Securing Redis connections with TLS using native-tls or rustls, especially in cloud or enterprise environments.
Enabling token-based authentication with Azure Entra ID for Azure-hosted applications requiring dynamic credential management.

Not Ideal For

Applications built in languages other than Rust, where mature native clients like redis-py or node-redis offer better ecosystem integration.
Quick, interactive Redis debugging or scripting tasks that are better served by the Redis CLI or lightweight REPL tools without a full Rust compilation setup.
Embedded or resource-constrained environments with strict binary size limits, due to the library's feature-rich nature and optional dependency bloat.
Legacy systems relying on Redis versions older than 6.0, as compatibility is not tested and support may be limited.

Pros & Cons

Pros

Customizable Type Safety

Implements FromRedisValue and ToRedisArgs traits, allowing Redis operations to return results in user-defined types, ensuring compile-time type checks and reducing runtime errors.

Comprehensive Async Support

Offers optional async clients via tokio-comp or smol-comp features, with cheaply cloneable connections that are thread-safe, enabling efficient non-blocking I/O for high-concurrency applications.

Extensive Feature Set

Supports TLS with native-tls or rustls, Redis Cluster via cluster features, RedisJSON integration, and Azure Entra ID authentication, catering to enterprise and advanced use cases.

Flexible Connection Management

Provides sync connection pooling with r2d2 and async connections that are multiplexed and reusable, balancing performance and simplicity for different scaling needs.

Cons

WebAssembly Limitations

Async support is not enabled for WebAssembly targets, and builds are untested against databases, making it unreliable for browser-based or WASM-focused projects.

Complex TLS Configuration

Setting up TLS, especially with rustls, requires manual installation of crypto providers and specific feature flags, adding significant setup overhead compared to plug-and-play clients.

Feature Fragmentation

The library is split into numerous optional features (e.g., tokio-comp, smol-comp, various TLS backends), leading to dependency management complexity and a steeper learning curve.

Frequently Asked Questions

Related Projects

Qdrant

Qdrant - High-performance, massive-scale Vector Database and Vector Search Engine for the next generation of AI. Also available in the cloud https://cloud.qdrant.io/

Stars33,545

Forks2,520

Last commit9 hours ago

SurrealDB

A scalable, distributed, collaborative, document-graph database, for the realtime web

Stars32,748

Forks1,311

Last commit17 days ago

RustFS

🚀2.3x faster than MinIO for 4KB object payloads. RustFS is an open-source, S3-compatible high-performance object storage system supporting migration and coexistence with other S3-compatible platforms such as MinIO and Ceph.

Stars30,153

Forks1,326

Last commit7 hours ago

Turso

A SQL database in Rust: SQLite-compatible, now also speaking Postgres (experimental). The LLVM of databases.

Stars23,381

Forks1,201

Last commit13 hours ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub