trypema 1.1.0

High-performance rate limiting primitives in Rust, designed for concurrency safety, low overhead, and predictable latency.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

use crate::{HardLimitFactor, RateGroupSizeMs, RateLimit, WindowSizeSeconds};

#[test]
fn rate_limit_try_from_validates_positive() {
    let rl = RateLimit::try_from(1f64).unwrap();
    assert_eq!(*rl, 1f64);

    assert_eq!(
        RateLimit::try_from(0f64).unwrap_err().to_string(),
        "invalid rate limit: rate limit must be greater than 0"
    );
    assert_eq!(
        RateLimit::try_from(-1f64).unwrap_err().to_string(),
        "invalid rate limit: rate limit must be greater than 0"
    );

    assert!(*RateLimit::max() > 0f64);
}

#[test]
fn window_size_seconds_try_from_validates_min_1() {
    let w = WindowSizeSeconds::try_from(1u64).unwrap();
    assert_eq!(*w, 1u64);

    assert_eq!(
        WindowSizeSeconds::try_from(0u64).unwrap_err().to_string(),
        "invalid window size: Window size must be at least 1"
    );
}

#[test]
fn rate_group_size_ms_try_from_validates_nonzero() {
    let g = RateGroupSizeMs::try_from(1u64).unwrap();
    assert_eq!(*g, 1u64);

    assert_eq!(
        RateGroupSizeMs::try_from(0u64).unwrap_err().to_string(),
        "invalid rate group size: Rate group size must be greater than 0"
    );
}

#[test]
fn hard_limit_factor_default_and_try_from_validate_at_least_one() {
    let d = HardLimitFactor::default();
    assert_eq!(*d, 1f64);

    let h = HardLimitFactor::try_from(2f64).unwrap();
    assert_eq!(*h, 2f64);

    // Exactly 1.0 is valid (the minimum)
    let h = HardLimitFactor::try_from(1f64).unwrap();
    assert_eq!(*h, 1f64);

    // Below 1.0 is invalid
    assert_eq!(
        HardLimitFactor::try_from(0f64).unwrap_err().to_string(),
        "invalid hard limit factor: Hard limit factor must be greater than or equal to 1"
    );
    assert_eq!(
        HardLimitFactor::try_from(0.5f64).unwrap_err().to_string(),
        "invalid hard limit factor: Hard limit factor must be greater than or equal to 1"
    );
    assert_eq!(
        HardLimitFactor::try_from(-1f64).unwrap_err().to_string(),
        "invalid hard limit factor: Hard limit factor must be greater than or equal to 1"
    );
}