feign 0.3.0

Rest client of Rust
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

<h1 align="center">
Feign-RS (Rest client of Rust)
</h1>

### [Start to use](https://github.com/niuhuan/feign-rs/tree/master/guides)

## Examples

```rust
use serde_derive::Deserialize;
use serde_derive::Serialize;
use std::collections::HashMap;
use feign::{client, ClientResult, Args};

#[derive(Default, Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct User {
    pub id: i64,
    pub name: String,
}

#[derive(Args)]
pub struct PutUserArgs {
    #[feign_path]
    pub id: i64,
    #[feign_query]
    pub q: String,
    #[feign_json]
    pub data: User,
    #[feign_headers]
    pub headers: HashMap<String, String>,
}

#[client(host = "http://127.0.0.1:3000", path = "/user")]
pub trait UserClient {

    #[get(path = "/find_by_id/<id>")]
    async fn find_by_id(&self, #[path] id: i64) -> ClientResult<Option<User>>;

    #[post(path = "/new_user")]
    async fn new_user(&self, #[json] user: &User) -> ClientResult<Option<String>>;

    #[put(path = "/put_user/<id>")]
    async fn put_user(&self, #[args] args: PutUserArgs) -> ClientResult<User>;
}

#[tokio::main]
async fn main() {
    let user_client: UserClient = UserClient::new();

    match user_client.find_by_id(12).await {
        Ok(option) => match option {
            Some(user) => println!("user : {}", user.name),
            None => println!("none"),
        },
        Err(err) => panic!("{}", err),
    };
}
```

## Features

- Easy to use
- Asynchronous request
- Configurable agent
- Supports form, JSON
- Reconfig host
- Additional request processer
- Custom deserializer