minirpc 0.1.1

A minimalist RPC framework.
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

//! MINI-RPC Response.

use crate::{Failure, Success};

/// Response payload.
#[derive(Debug, PartialEq, Deserialize, Serialize)]
#[serde(untagged)]
pub enum Payload {
    /// Unsuccessful response.
    Failure(Failure),

    /// Successful response.
    Success(Success),
}

/// Response.
#[derive(Debug, PartialEq, Deserialize, Serialize)]
#[serde(untagged)]
pub enum Response {
    /// A batch of responses (payloads).
    Batch(Vec<Payload>),

    /// A single response (payload).
    Single(Payload),
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::{Error, Id};
    use serde_json::{self, Value};

    #[test]
    fn response_deserialization() {
        // Single Failure.
        let input = r#"{"error":{"code":-32700,"message":"Parse error"},"id":1}"#;
        let expected = Response::Single(Payload::Failure(Failure {
            error: Error::new_parse_error(),
            id: Some(Id::Number(1)),
        }));

        let result: Response = serde_json::from_str(input).unwrap();
        assert_eq!(result, expected);

        // Single Success.
        let input = r#"{"id":1,"result":true}"#;
        let expected = Response::Single(Payload::Success(Success {
            id: Id::Number(1),
            result: Value::Bool(true),
        }));

        let result: Response = serde_json::from_str(input).unwrap();
        assert_eq!(result, expected);

        // Batch Failure and Success.
        let input =
            r#"[{"error":{"code":-32700,"message":"Parse error"},"id":1},{"id":1,"result":true}]"#;
        let expected = Response::Batch(vec![
            Payload::Failure(Failure {
                error: Error::new_parse_error(),
                id: Some(Id::Number(1)),
            }),
            Payload::Success(Success {
                id: Id::Number(1),
                result: Value::Bool(true),
            }),
        ]);

        let result: Response = serde_json::from_str(input).unwrap();
        assert_eq!(result, expected);
    }

    #[test]
    fn response_serialization() {
        // Single Failure.
        let input = Response::Single(Payload::Failure(Failure {
            error: Error::new_parse_error(),
            id: Some(Id::Number(1)),
        }));
        let expected = r#"{"error":{"code":-32700,"message":"Parse error"},"id":1}"#;

        let result = serde_json::to_string(&input).unwrap();
        assert_eq!(result, expected);

        // Single Success.
        let input = Response::Single(Payload::Success(Success {
            id: Id::Number(1),
            result: Value::Bool(true),
        }));
        let expected = r#"{"id":1,"result":true}"#;

        let result = serde_json::to_string(&input).unwrap();
        assert_eq!(result, expected);

        // Batch Failure and Success.
        let input = Response::Batch(vec![
            Payload::Failure(Failure {
                error: Error::new_parse_error(),
                id: Some(Id::Number(1)),
            }),
            Payload::Success(Success {
                id: Id::Number(1),
                result: Value::Bool(true),
            }),
        ]);
        let expected =
            r#"[{"error":{"code":-32700,"message":"Parse error"},"id":1},{"id":1,"result":true}]"#;

        let result = serde_json::to_string(&input).unwrap();
        assert_eq!(result, expected);
    }
}