okapi-operation 0.3.0

Procedural macro for generating OpenAPI operation specification (using okapi)
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

use axum::{Form, Json, response::Html};
use mime::{APPLICATION_JSON, APPLICATION_WWW_FORM_URLENCODED, TEXT_HTML};
use okapi::{
    Map, map,
    openapi3::{MediaType, RefOr, Response, Responses},
};

use crate::{
    Components, ToMediaTypes, ToResponses, impl_to_media_types_for_wrapper,
    impl_to_responses_for_wrapper,
};

// Json
impl_to_media_types_for_wrapper!(Json<T>, APPLICATION_JSON.to_string());
impl_to_responses_for_wrapper!(Json<T>);

// Form
impl_to_media_types_for_wrapper!(Form<T>, APPLICATION_WWW_FORM_URLENCODED.to_string());
impl_to_responses_for_wrapper!(Form<T>);

// Html
impl<T> ToMediaTypes for Html<T> {
    fn generate(_components: &mut Components) -> Result<Map<String, MediaType>, anyhow::Error> {
        Ok(map! {
            TEXT_HTML.to_string() => MediaType::default()
        })
    }
}

impl<T> ToResponses for Html<T> {
    fn generate(components: &mut Components) -> Result<Responses, anyhow::Error> {
        Ok(Responses {
            responses: map! {
                "200".into() =>  RefOr::Object(Response {
                    content: <Self as ToMediaTypes>::generate(components)?,
                    ..Default::default()
                }),
            },
            ..Default::default()
        })
    }
}