satay-codegen 0.1.1

Generate Rust client code from OpenAPI 3.1 documents
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
102

use proc_macro2::TokenStream;
use quote::quote;
use syn::parse_quote;

use crate::model::{Field, Operation, TypeRef};

use super::super::types::structs;
use super::super::{
    ident, input_builder_arg_type, input_builder_value, input_fields, input_setter_name,
};

pub(super) fn render_input(operation: &Operation) -> syn::ItemStruct {
    let input_fields = input_fields(operation);

    structs::render_struct(
        &operation.input_name,
        operation.description.as_deref(),
        &input_fields,
        false,
    )
}

pub(super) fn render_input_impl(operation: &Operation) -> syn::ItemImpl {
    let input_name = ident(&operation.input_name);
    let fields = input_fields(operation);
    let required_fields = fields
        .iter()
        .filter(|field| field.required)
        .collect::<Vec<_>>();
    let new_args = required_fields.iter().map(|field| {
        let name = ident(&field.rust_name);
        let ty = input_builder_arg_type(&field.ty);
        quote!(#name: #ty)
    });
    let initializers = fields.iter().map(|field| {
        let name = ident(&field.rust_name);
        if field.required {
            if field.ty == TypeRef::String {
                let value = input_builder_value(quote!(#name), &field.ty);
                quote!(#name: #value)
            } else {
                quote!(#name)
            }
        } else {
            quote!(#name: None)
        }
    });
    let setters = fields
        .iter()
        .filter(|field| !field.required)
        .map(render_input_setter)
        .collect::<Vec<_>>();

    parse_quote!(
        impl #input_name {
            pub fn new(#(#new_args),*) -> Self {
                Self {
                    #(#initializers),*
                }
            }

            #(#setters)*
        }
    )
}

pub(super) fn render_input_default_impl(operation: &Operation) -> Option<syn::ItemImpl> {
    if input_fields(operation).iter().any(|field| field.required) {
        return None;
    }

    let input_name = ident(&operation.input_name);
    Some(parse_quote!(
        impl Default for #input_name {
            fn default() -> Self {
                Self::new()
            }
        }
    ))
}

fn render_input_setter(field: &Field) -> TokenStream {
    let setter_name = input_setter_name(field);
    let name = ident(&field.rust_name);
    let ty = input_builder_arg_type(&field.ty);
    if field.ty.is_option() {
        quote!(
            pub fn #setter_name(mut self, #name: #ty) -> Self {
                self.#name = #name;
                self
            }
        )
    } else {
        let value = input_builder_value(quote!(#name), &field.ty);
        quote!(
            pub fn #setter_name(mut self, #name: #ty) -> Self {
                self.#name = Some(#value);
                self
            }
        )
    }
}