3 unstable releases
0.2.0 | Jun 14, 2024 |
---|---|
0.1.1 | Oct 29, 2023 |
0.1.0 | Oct 28, 2023 |
#218 in HTTP client
56KB
1K
SLoC
ergoreq
A human-centric web request client developed based on Reqwest.
- Automatically retry support
- Middleware support
- Automatically manage cookies per-request (instead of per-client)
- Automatically redirect management per-request
- Supports all features of
reqwest
tracing
support- Well tested
Example
#[tokio::main]
async fn main(){
// Create a reqwest client first
let client = reqwest::Client::builder()
.timeout(Duration::from_secs(30))
.user_agent("ergoreq/1.0")
.redirect(Policy::none()) // remember to disable the redirect!
.build()
.unwrap();
// Then create the ergo client
let client = ErgoClient::new(client).with_auto_redirect_count(5); // global auto redirect count
// Creates cookie store. You can impl a `CookieContainer` by your own.
let cookie_store = Arc::new(ErgoCookieContainer::new(false, false, false));
// Each request will automatically set and store cookie.
client
.get("https://httpbin.org/cookies/set/test_cookie/test_success")
.with_cookie_store_ref(&cookie_store)
.send()
.await
.unwrap();
client
.get("https://httpbin.org/cookies/set/test_cookie_1/test_success_1")
.with_cookie_store_ref(&cookie_store)
.send()
.await
.unwrap();
println!("Cookies: {:#?}", cookie_store.serialize_cookies());
let response = client
.get("https://httpbin.org/redirect/4") // last time it will redirect to /get, so 4 represents 5 redirect times
.send()
.await
.unwrap();
println!(
"Redirect {}",
if response.status().is_success() {
"success"
} else {
"fail"
}
)
}
More examples can be found in examples directory.
Requirement
The tested reqwest
version is 0.12. Using reqwest
older than 0.12 may cause compile error.
License
MIT
Thanks to
Dependencies
~7–19MB
~270K SLoC