reqwest-rate-limit 0.1.3

Rate-limit aware request helpers and optional wrapper ergonomics for reqwest.
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

# reqwest-rate-limit

Rate-limit helpers and optional wrapper ergonomics for `reqwest`.

## Highlights

- Small helpers to rate-limit any `reqwest::RequestBuilder`
- Optional wrapper `Client` with middleware hooks
- `ClientBuilder::configure` exposes all `reqwest::ClientBuilder` options

## Example

```rust
use governor::Quota;
use std::num::NonZeroU32;
use std::sync::Arc;

let rate_limiter = Arc::new(governor::RateLimiter::direct(Quota::per_hour(
    NonZeroU32::new(5_000).unwrap(),
)));

let client = reqwest_rate_limit::Client::builder()
    .user_agent("reqwest-rate-limit-readme")
    .configure(|b| b.timeout(std::time::Duration::from_secs(10)))
    .build()
    .unwrap();

let _request = client
    .get("https://api.example.com/health")
    .with_rate_limiter(rate_limiter)
    .send();
```

## Examples

- [examples/simple_rate_limit.rs](examples/simple_rate_limit.rs): Minimal rate limiting using a plain `reqwest::Client`.
- [examples/wrapper_ergonomics.rs](examples/wrapper_ergonomics.rs): Wrapper client ergonomics with builder configuration and per-request rate limits.
- [examples/github_rest_api.rs](examples/github_rest_api.rs): GitHub REST API rate-limit handling with a `ResponseMiddleware` implementation.