How aknexad/limiter-rs works
limiter-rs is a Rust rate-limiting library whose principal workflow is to turn a service and caller identity into a storage key, check that key’s token-bucket state, allow or deny the requested token consumption, and persist updated state when allowed. The API supports synchronous in-memory and asynchronous Redis-backed checks. The graph includes the documented configuration capability and the storage abstraction as an internal layer. Some storage and configuration relationships are documented rather than demonstrated by sampled runtime calls, so unsupported links are omitted.
Main entry points: limiter_helper.rs Request handling · limiter.rs Rate limiter API · store.rs Storage interfaces · key.rs Key generation
Components 13
Request API
- Rate limiter API
crates/limiter_core/src/limiter.rs - Request handling
crates/limiter_core/src/limiter_helper.rs - Check input
crates/limiter_core/src/types.rs
Limiter Domain
- Key generation
crates/limiter_core/src/models/key.rs - Token bucket
crates/limiter_core/src/algorithms/token_bucket.rs - Bucket state
crates/limiter_core/src/models/bucket_state.rs - Time utilities
crates/limiter_core/src/utils/time.rs
Storage Layer
- Storage interfaces
crates/limiter_storage/src/store.rs - Memory store
crates/limiter_storage/src/memory/memory_store.rs - Redis storage
crates/limiter_storage/src/redis/redis_storage.rs
Configuration
- Policy configuration
crates/limiter_core/src/policy.rs
Other components
- Library caller
- Redis server
Connections 15
- Library caller → Key generation: builds key
README.md - Library caller → Rate limiter API: checks rate
README.md - Key generation → Rate limiter API: provides key
README.md - Rate limiter API → Request handling: dispatches check
crates/limiter_core/src/limiter.rs - Rate limiter API → Storage interfaces: reads bucket
crates/limiter_core/src/limiter.rs - Request handling → Token bucket: calculates tokens
crates/limiter_core/src/limiter_helper.rs - Request handling → Storage interfaces: writes state
crates/limiter_core/src/limiter_helper.rs - Request handling → Time utilities: timestamps state
crates/limiter_core/src/limiter_helper.rs - Request handling → Bucket state: updates state
crates/limiter_core/src/limiter_helper.rs - Rate limiter API → Check input: builds input
crates/limiter_core/src/limiter.rs - Token bucket → Time utilities: gets timestamp
crates/limiter_core/src/algorithms/token_bucket.rs - Storage interfaces → Memory store: implements interface
crates/limiter_storage/src/store.rs - Storage interfaces → Redis storage: implements interface
crates/limiter_storage/src/store.rs - Storage interfaces → Redis server: sends commands
crates/limiter_storage/src/store.rs - Redis storage → Redis server: opens connection
crates/limiter_storage/src/redis/redis_storage.rs