camber 0.1.6

Opinionated async Rust for IO-bound services on top of Tokio
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159

mod common;

use camber::RuntimeError;
use camber::http::rate_limit;
use camber::http::{Request, Response, Router};
use camber::runtime;
use std::time::Duration;

#[camber::test]
async fn rate_limit_allows_requests_within_limit() {
    let mut router = Router::new();
    router.use_middleware(rate_limit::per_second(10).unwrap());
    router.get("/ok", |_req: &Request| async { Response::text(200, "ok") });
    let addr = common::spawn_server(router);

    for _ in 0..5 {
        let resp = camber::http::get(&format!("http://{addr}/ok"))
            .await
            .unwrap();
        assert_eq!(resp.status(), 200);
    }

    runtime::request_shutdown();
}

#[camber::test]
async fn rate_limit_rejects_excess_requests() {
    let mut router = Router::new();
    router.use_middleware(rate_limit::per_second(2).unwrap());
    router.get("/ok", |_req: &Request| async { Response::text(200, "ok") });
    let addr = common::spawn_server(router);

    let mut statuses = Vec::new();
    for _ in 0..5 {
        let resp = camber::http::get(&format!("http://{addr}/ok"))
            .await
            .unwrap();
        statuses.push(resp.status());
    }

    let ok_count = statuses.iter().filter(|&&s| s == 200).count();
    let rejected_count = statuses.iter().filter(|&&s| s == 429).count();
    assert_eq!(ok_count, 2);
    assert_eq!(rejected_count, 3);

    runtime::request_shutdown();
}

#[camber::test]
async fn rate_limit_replenishes_over_time() {
    let mut router = Router::new();
    router.use_middleware(rate_limit::per_second(2).unwrap());
    router.get("/ok", |_req: &Request| async { Response::text(200, "ok") });
    let addr = common::spawn_server(router);

    // Exhaust tokens
    for _ in 0..2 {
        let resp = camber::http::get(&format!("http://{addr}/ok"))
            .await
            .unwrap();
        assert_eq!(resp.status(), 200);
    }

    // Wait for replenishment
    tokio::time::sleep(Duration::from_millis(1100)).await;

    // Should have tokens again
    for _ in 0..2 {
        let resp = camber::http::get(&format!("http://{addr}/ok"))
            .await
            .unwrap();
        assert_eq!(resp.status(), 200);
    }

    runtime::request_shutdown();
}

#[camber::test]
async fn rate_limit_builder_configures_burst() {
    let mut router = Router::new();
    router.use_middleware(
        rate_limit::builder()
            .tokens(2)
            .interval(Duration::from_secs(1))
            .burst(5)
            .build()
            .unwrap(),
    );
    router.get("/ok", |_req: &Request| async { Response::text(200, "ok") });
    let addr = common::spawn_server(router);

    // Burst allows 5 rapid requests
    for i in 0..5 {
        let resp = camber::http::get(&format!("http://{addr}/ok"))
            .await
            .unwrap();
        assert_eq!(
            resp.status(),
            200,
            "request {i} should succeed within burst"
        );
    }

    // 6th should be rejected
    let resp = camber::http::get(&format!("http://{addr}/ok"))
        .await
        .unwrap();
    assert_eq!(resp.status(), 429);

    runtime::request_shutdown();
}

#[camber::test]
async fn rate_limit_per_minute_works() {
    let mut router = Router::new();
    router.use_middleware(rate_limit::per_minute(3).unwrap());
    router.get("/ok", |_req: &Request| async { Response::text(200, "ok") });
    let addr = common::spawn_server(router);

    let mut statuses = Vec::new();
    for _ in 0..4 {
        let resp = camber::http::get(&format!("http://{addr}/ok"))
            .await
            .unwrap();
        statuses.push(resp.status());
    }

    assert_eq!(statuses[0], 200);
    assert_eq!(statuses[1], 200);
    assert_eq!(statuses[2], 200);
    assert_eq!(statuses[3], 429);

    runtime::request_shutdown();
}

#[test]
fn rate_limit_rejects_zero_tokens() {
    let result = rate_limit::per_second(0);
    assert!(matches!(result, Err(RuntimeError::InvalidArgument(_))));
}

#[test]
fn rate_limit_rejects_zero_interval() {
    let result = rate_limit::builder()
        .tokens(10)
        .interval(Duration::ZERO)
        .build();
    assert!(matches!(result, Err(RuntimeError::InvalidArgument(_))));
}

#[test]
fn rate_limit_rejects_burst_less_than_tokens() {
    let result = rate_limit::builder()
        .tokens(10)
        .interval(Duration::from_secs(1))
        .burst(5)
        .build();
    assert!(matches!(result, Err(RuntimeError::InvalidArgument(_))));
}