okapi-operation-macro 0.3.1

Macro implementation for okapi-operation
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

use darling::FromMeta;
use proc_macro2::TokenStream;
use quote::{ToTokens, quote};

use crate::{operation::parameters::ParameterStyle, utils::quote_option};

pub(super) static PATH_ATTRIBUTE_NAME: &str = "path";

/// Path parameter.
#[derive(Debug, FromMeta)]
pub(super) struct Path {
    name: String,
    #[darling(default)]
    description: Option<String>,
    #[darling(default)]
    deprecated: bool,
    #[darling(default)]
    style: Option<ParameterStyle>,
    schema: syn::Path,
    #[darling(default)]
    content: Option<String>,
}

impl Path {
    pub(super) fn name(&self) -> &str {
        &self.name
    }

    /// Build a path parameter inferred from a function argument.
    pub(super) fn new_inferred(name: String, schema: syn::Path) -> Self {
        Self {
            name,
            description: None,
            deprecated: false,
            style: None,
            schema,
            content: None,
        }
    }
}

impl ToTokens for Path {
    fn to_tokens(&self, tokens: &mut TokenStream) {
        let name = &self.name;
        let description = quote_option(&self.description);
        let deprecated = &self.deprecated;
        let ty = &self.schema;
        let value = if let Some(media_type) = &self.content {
            quote! {
                okapi::openapi3::ParameterValue::Content {
                    content: {
                        let mut __map = okapi::Map::new();
                        __map.insert(
                            #media_type.to_string(),
                            okapi::openapi3::MediaType {
                                schema: Some(components.schema_for::<#ty>()),
                                ..Default::default()
                            },
                        );
                        __map
                    },
                }
            }
        } else {
            let style = quote_option(&self.style);
            quote! {
                okapi::openapi3::ParameterValue::Schema {
                    style: #style,
                    explode: None,
                    allow_reserved: false,
                    schema: components.schema_for::<#ty>(),
                    example: Default::default(),
                    examples: Default::default(),
                }
            }
        };
        tokens.extend(quote! {
            okapi::openapi3::Parameter {
                name: #name.into(),
                location: "path".into(),
                description: #description,
                required: true,
                deprecated: #deprecated,
                allow_empty_value: false,
                value: { #value },
                extensions: Default::default(),
            }
        });
    }
}