gws-builder 0.1.1

Build-time codegen from Google API Discovery: Rust types, method metadata, and serde helpers for Workspace agents.
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

//! Per-method query/path parameter structs.

use proc_macro2::TokenStream;
use quote::{format_ident, quote};

use crate::codegen::naming::field_ident_with_rename;
use crate::ir::types::{IrField, IrMethod, IrType};

/// Emit `Params` structs for each method (grouped later by resource module in actions).
pub fn emit_method_param_structs(methods: &[IrMethod]) -> Vec<TokenStream> {
    methods.iter().map(emit_one_method_params).collect()
}

fn emit_one_method_params(m: &IrMethod) -> TokenStream {
    let struct_name = format_ident!("{}Params", to_pascal(&m.rust_name));
    let doc = format!(
        "Query/path parameters for `{}`.",
        m.id
    );
    let mut fields: Vec<TokenStream> = Vec::new();
    for f in m.path_params.iter().chain(m.query_params.iter()) {
        fields.push(emit_param_field(f));
    }

    quote! {
        #[doc = #doc]
        #[derive(Debug, Clone, Default, serde::Serialize, serde::Deserialize)]
        #[serde(rename_all = "camelCase")]
        pub struct #struct_name {
            #( #fields )*
        }
    }
}

fn emit_param_field(f: &IrField) -> TokenStream {
    let (rust, serde_rename) = field_ident_with_rename(&f.rust_name, &f.original_name);
    let serde_rename = serde_rename.unwrap_or_else(|| quote!());
    let inner = ir_param_type(&f.field_type);
    let skip = quote!(#[serde(skip_serializing_if = "Option::is_none")]);
    quote! {
        #serde_rename
        #skip
        pub #rust: Option<#inner>,
    }
}

fn ir_param_type(ty: &IrType) -> TokenStream {
    match ty {
        IrType::String => quote!(String),
        IrType::I32 => quote!(i32),
        IrType::I64 => quote!(i64),
        IrType::U32 => quote!(u32),
        IrType::U64 => quote!(u64),
        IrType::F32 => quote!(f32),
        IrType::F64 => quote!(f64),
        IrType::Bool => quote!(bool),
        _ => quote!(String),
    }
}

fn to_pascal(s: &str) -> String {
    use heck::ToPascalCase;
    s.to_pascal_case()
}