ergoreq 0.2.1

A human-centric web request client developed based on Reqwest, supporting automatic cookie management, automatic retries, and custom middleware.
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

# ergoreq

A human-centric web request client developed based on Reqwest.

* Friendly Url building
* 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

```rust
    use ergoreq::{ErgoClient, ErgoCookieContainer, StringUrlBuilderTrait, ErgoStringToRequestExt};
use reqwest::redirect::Policy;
use std::sync::Arc;
use std::time::Duration;

#[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_secure());

    // Each request will automatically set and store cookie.
    // You can build url by string directly
    "https://httpbin.org"
        .add_url_segment("cookies")
        .add_url_segment("set")
        .add_url_segment("test_cookie")
        .add_url_segment("test_success")
        .http_get(&client)
        .with_cookie_store_ref(&cookie_store)
        .send()
        .await
        .unwrap();

    // Or with batch url building
    "https://httpbin.org"
        .add_url_segments(&["cookies", "set", "test_cookie_1", "test_success_1"])
        .http_get(&client)
        .with_cookie_store_ref(&cookie_store)
        .send()
        .await
        .unwrap();

    // Traditional way to build url
    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](examples) directory.

# Requirement

The tested `reqwest` version is 0.12. Using `reqwest` older than 0.12 may cause compile error.

# License

MIT

# Thanks to

* [reqwest](https://github.com/seanmonstar/reqwest)