30 releases (6 stable)

2.0.7 Oct 22, 2023
2.0.4 May 23, 2023
1.0.1 May 31, 2022
1.0.0 Feb 22, 2022
0.5.0 Oct 30, 2019

#98 in Database interfaces

Download history 1116/week @ 2024-01-02 1353/week @ 2024-01-09 1359/week @ 2024-01-16 1276/week @ 2024-01-23 1140/week @ 2024-01-30 1191/week @ 2024-02-06 1131/week @ 2024-02-13 1313/week @ 2024-02-20 1503/week @ 2024-02-27 1275/week @ 2024-03-05 1666/week @ 2024-03-12 1611/week @ 2024-03-19 2091/week @ 2024-03-26 2337/week @ 2024-04-02 2285/week @ 2024-04-09 1685/week @ 2024-04-16

8,615 downloads per month
Used in 4 crates

BSD-3-Clause

255KB
6K SLoC

license Releases crates.io docs CircleCI

redismodule-rs

This crate provides an idiomatic Rust API for the Redis Modules API. It allows writing Redis modules in Rust, without needing to use raw pointers or unsafe code. See here for the most recent API documentation.

Running the example module

  1. Install Rust
  2. Install Redis, most likely using your favorite package manager (Homebrew on Mac, APT or YUM on Linux)
  3. Run cargo build --example hello
  4. Start a redis server with the hello module
    • Linux: redis-server --loadmodule ./target/debug/examples/libhello.so
    • Mac: redis-server --loadmodule ./target/debug/examples/libhello.dylib
  5. Open a Redis CLI, and run HELLO.MUL 31 11.

Writing your own module

See the examples directory for some sample modules.

This crate tries to provide high-level wrappers around the standard Redis Modules API, while preserving the API's basic concepts. Therefore, following the Redis Modules API documentation will be mostly relevant here as well.

Redis Modules based on this crate

The following are some modules that are built on this crate:

Several member of the community have written their own modules based on this.

Dependencies

~8–12MB
~238K SLoC