api-response 0.16.3

A consistent structure for API responses, including success and error handling.
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

use std::{
    convert::Infallible,
    ops::{ControlFlow, FromResidual, Try},
};

use crate::{ApiError, ApiResponse, ErrorResponse, SuccessResponse};

impl<Data, Meta> FromResidual<Result<Infallible, ErrorResponse<Meta>>> for ApiResponse<Data, Meta> {
    fn from_residual(residual: Result<Infallible, ErrorResponse<Meta>>) -> Self {
        ApiResponse::Error(residual.unwrap_err())
    }
}

impl<Data, Meta> FromResidual<Result<Infallible, ApiError>> for ApiResponse<Data, Meta> {
    fn from_residual(residual: Result<Infallible, ApiError>) -> Self {
        ApiResponse::Error(ErrorResponse::from_error(residual.unwrap_err()))
    }
}

impl<T, Meta> FromResidual<ApiResponse<Infallible, Meta>> for Result<T, ErrorResponse<Meta>> {
    fn from_residual(residual: ApiResponse<Infallible, Meta>) -> Self {
        Err(residual.unwrap_err())
    }
}

impl<T, Meta> FromResidual<ApiResponse<Infallible, Meta>> for Result<T, ApiError> {
    fn from_residual(residual: ApiResponse<Infallible, Meta>) -> Self {
        Err(residual.unwrap_err().error)
    }
}

impl<Data, Meta> Try for ApiResponse<Data, Meta> {
    type Output = SuccessResponse<Data, Meta>;

    type Residual = ApiResponse<Infallible, Meta>;

    fn from_output(output: Self::Output) -> Self {
        Self::Success(output)
    }

    fn branch(self) -> ControlFlow<Self::Residual, Self::Output> {
        match self {
            Self::Success(v) => ControlFlow::Continue(v),
            Self::Error(e) => ControlFlow::Break(ApiResponse::Error(e)),
        }
    }
}

impl<Data, Meta> FromResidual<ApiResponse<Infallible, Meta>> for ApiResponse<Data, Meta> {
    fn from_residual(residual: ApiResponse<Infallible, Meta>) -> Self {
        ApiResponse::Error(residual.unwrap_err())
    }
}

#[cfg(test)]
mod tests {
    use crate::*;
    fn from_result_residual<Data, Meta>() -> ApiResponse<Data, Meta> {
        Err(ErrorResponse::from_error_msg(1u32, "message"))?;
        Err(ApiError::new(1u32, "message"))?
    }
    fn from_self_residual<Data, Meta>() -> ApiResponse<Data, Meta> {
        let x: SuccessResponse<Data, Meta> = ApiResponse::from_error_msg(1u32, "message")?;
        x.into()
    }
    fn into_result_residual<Data, Meta>() -> ApiResult<Data, Meta> {
        let x: SuccessResponse<Data, Meta> = ApiResponse::from_error_msg(1u32, "message")?;
        x.into()
    }
    fn into_result_residual2<Data>() -> Result<Data, ApiError> {
        let x: SuccessResponse<_, ()> = ApiResponse::<_, ()>::from_error_msg(1u32, "message")?;
        x.into()
    }
    #[test]
    fn test_from_residual() {
        println!("{:?}", from_result_residual::<u8, u8>());
        println!("{:?}", from_self_residual::<u8, u8>());
        println!("{:?}", into_result_residual::<u8, u8>());
        println!("{:?}", into_result_residual2::<u8>());
    }
}