rust-api-kit 0.1.2

A type-safe API definition toolkit for Rust — define your API once and share it across client and server, with compile-time guarantees.
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

#[macro_export]
macro_rules! define_http_routes {
    (
        $(
            group (
                path $path_prefix:literal;
                $(auth $auth_ty:ty;)?
                error $unexpected:ty;

                $(
                    $method:ident $path:literal $req:ty => $res:ty | $err:ty;
                )*
            );
        )*
    ) => {
        $(
            $crate::define_http_routes!(@impl_group $(auth $auth_ty;)? $unexpected; $path_prefix; $(($method, $path, $req, $res, $err))*);
        )*
    };

    (@impl_group auth $auth_ty:ty; $unexpected:ty; $path_prefix:literal; $(($method:ident, $path:literal, $req:ty, $res:ty, $err:ty))*) => {
        $(
            impl $crate::http::client::HttpRequest<$res, $err, $unexpected> for $req {
                const ENDPOINT: &'static str = concat!("/", $path_prefix, "/", $path);
                const METHOD: $crate::http::client::RequestMethod = $crate::http::client::RequestMethod::$method;
            }

            impl Into<$crate::http::client::Response<$res, $err, $unexpected>> for $res
            {
                fn into(
                    self,
                ) -> $crate::http::client::Response<$res, $err, $unexpected>
                {
                    $crate::http::client::Response::Ok(self)
                }
            }

            impl Into<$crate::http::client::Response<$res, $err,$unexpected>> for $err
            {
                fn into(
                    self,
                ) -> $crate::http::client::Response<$res, $err,$unexpected>
                {
                    $crate::http::client::Response::Error(self)
                }
            }

        impl Into<$crate::http::client::Response<$res, $err, $unexpected>> for $unexpected
        {
            fn into(
                self,
            ) -> $crate::http::client::Response<$res, $err, $unexpected>
            {
                $crate::http::client::Response::UnexpectedError(self)
            }
        }


        impl $crate::http::client::AuthenticatedHttpRequest<$auth_ty> for $req {}
        )*
    };

    (@impl_group $unexpected:ty; $path_prefix:literal; $(($method:ident, $path:literal, $req:ty, $res:ty, $err:ty))*) => {
        $(
            impl $crate::http::client::HttpRequest<$res, $err, $unexpected> for $req {
                const ENDPOINT: &'static str = concat!("/", $path_prefix, "/", $path);
                const METHOD: $crate::http::client::RequestMethod = $crate::http::client::RequestMethod::$method;
            }

            impl Into<$crate::http::client::Response<$res, $err, $unexpected>> for $res
            {
                fn into(
                    self,
                ) -> $crate::http::client::Response<$res, $err, $unexpected>
                {
                    $crate::http::client::Response::Ok(self)
                }
            }

            impl Into<$crate::http::client::Response<$res, $err,$unexpected>> for $err
            {
                fn into(
                    self,
                ) -> $crate::http::client::Response<$res, $err,$unexpected>
                {
                    $crate::http::client::Response::Error(self)
                }
            }

        impl Into<$crate::http::client::Response<$res, $err, $unexpected>> for $unexpected
        {
            fn into(
                self,
            ) -> $crate::http::client::Response<$res, $err, $unexpected>
            {
                $crate::http::client::Response::UnexpectedError(self)
            }
        }
        )*
    };
}