upstash-ratelimit

Crates.ioupstash-ratelimit
lib.rsupstash-ratelimit
version0.1.0
sourcesrc
created_at2023-07-07 11:04:32.047249
updated_at2023-07-07 11:04:32.047249
descriptionUpstash ratelimit compatible rate limiting library.
homepage
repository
max_upload_size
id910665
size10,473
Liam Kinne (liamkinne)

documentation

https://docs.rs/upstash-ratelimit

README

Redis Backed Rate Limit

This library is inspired by and designed to be compatible with the Upstash Rate Limit library. This means you can have multiple JavaScript and Rust services operate on the same Redis keys and use the same rate limiting algorithms.

Getting Started

Add the dependency

cargo add upstash-ratelimit

Use upstash_ratelimit to

use upstash_ratelimit::{Limiter, RateLimit, Response};

let redis = redis::Client::open("redis://127.0.0.1/")?;

let ratelimit = RateLimit::builder()
    .redis(REDIS.clone())
    .limiter(Limiter::FixedWindow {
        tokens: 30,
        window: Duration::from_millis(100),
    })
    .build()?;

let response = ratelimit.limit("unique-id");

match result {
    Response::Success { .. } => println!("Allow!")
    Response::Failure { .. } => println!("Rate limited!")
}

Running Unit Tests

Before running cargo test, spin up a Redis instance on localhost with docker-compose up -d. It's a good idea to restart Redis between test runs.

Feature Support

  • Single region Redis
  • Multi-region Redis
  • Fixed window limiting
  • Sliding window limiting
  • Token bucket limiting
  • Cached fixed window limiting
  • Arbitrary key prefix
  • Ephemeral (in-memory) cache
  • Block until ready
  • HTTP Redis connection
    • This will require substantial effort and should probably reside in a separate library.
  • Analytics
    • This will require substantial efford and should probably reside in a separate library.
Commit count: 0

cargo fmt