autapi 0.0.1

Automatic OpenAPI specification from function signatures
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

use http::StatusCode;
use pastey::paste;

use crate::{
    Registry,
    openapi::{self, Map, merge_responses_iter},
    response::{IntoResponse, Response},
};

macro_rules! define {
    ($status:ident) => {
        paste! {
            #[doc = concat!(
                "Converts all status codes returned by an `IntoResponse` type to `",
                stringify!($status),
                "`."
            )]
            #[doc = ""]
            #[doc = "If `T` produces multiple responses, they are merged. See [`merge_responses_iter`] for more details."]
            pub struct [< $status:camel >]<T>(pub T);

            impl<T: IntoResponse> IntoResponse for [<$status:camel>]<T> {
                fn openapi(registry: &mut Registry) -> openapi::Responses {
                    let mut responses = T::openapi(registry);
                    let merged = merge_responses_iter(responses.responses.into_values());
                    responses.responses = match merged {
                        None => Map::default(),
                        Some(response) => Map::from_iter([(StatusCode::$status.as_str().to_owned(), response)]),
                    };
                    responses
                }

                fn into_response(self) -> Response {
                    let mut response = self.0.into_response();
                    *response.status_mut() = StatusCode::$status;
                    response
                }
            }
        }
    };
}

define!(OK);
define!(CREATED);
define!(ACCEPTED);
define!(NOT_MODIFIED);
define!(UNAUTHORIZED);
define!(FORBIDDEN);