daml-codegen 0.2.2

Daml GRPC Ledger API Code Generator
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

use proc_macro2::TokenStream;

use quote::quote;

use crate::renderer::data_renderer::full::quote_contract_struct::quote_contract_id_struct_name;
use crate::renderer::data_renderer::full::quote_method_arguments;
use crate::renderer::renderer_utils::quote_escaped_ident;
use crate::renderer::type_renderer::quote_type;
use crate::renderer::{IsRenderable, RenderContext};
use daml_lf::element::{DamlChoice, DamlField, DamlType};
use heck::ToSnakeCase;

pub fn quote_choice(ctx: &RenderContext<'_>, name: &str, items: &[DamlChoice<'_>]) -> TokenStream {
    let all_choice_methods_tokens = quote_all_choice_methods(ctx, name, items);
    let contract_struct_name_tokens = quote_contract_id_struct_name(name);
    quote!(
        impl #contract_struct_name_tokens {
            #all_choice_methods_tokens
        }
    )
}

/// Generate all choice methods within the parent `impl` block.
fn quote_all_choice_methods(ctx: &RenderContext<'_>, struct_name: &str, items: &[DamlChoice<'_>]) -> TokenStream {
    let all_choice_methods: Vec<_> = items.iter().map(|choice| quote_choice_method(ctx, struct_name, choice)).collect();
    quote!(
        #( #all_choice_methods )*
    )
}

/// Generate the `pub fn foo(&self, ...)` choice method.
fn quote_choice_method(ctx: &RenderContext<'_>, struct_name: &str, choice: &DamlChoice<'_>) -> TokenStream {
    let choice_name = &choice.name();
    let struct_name_tokens = quote_escaped_ident(struct_name);
    let method_name_command_tokens = quote_command_method_name(&choice.name().to_snake_case());
    let _method_name_tokens = quote_escaped_ident(&choice.name().to_snake_case());
    let choice_argument_tokens = quote_method_arguments(&choice.fields().iter().collect::<Vec<_>>());
    let supported_fields: Vec<_> =
        choice.fields().iter().filter(|&field| IsRenderable::new(ctx).check_type(field.ty())).collect();
    let all_choice_fields = quote_all_choice_fields(&supported_fields);
    quote!(
        pub fn #method_name_command_tokens(&self, #choice_argument_tokens) -> DamlExerciseCommand {
            let template_id = #struct_name_tokens::package_id();
            #all_choice_fields
            DamlExerciseCommand::new(
                template_id,
                self.contract_id().as_str(),
                #choice_name,
                params
            )
        }
    )
}

/// Generate the `DamlValue::Record` containing all choice fields.
fn quote_all_choice_fields(supported_fields: &[&DamlField<'_>]) -> TokenStream {
    let all_choice_fields = quote_declare_all_choice_fields(supported_fields);
    if all_choice_fields.is_empty() {
        quote!(
            let params = DamlValue::Record(DamlRecord::new(vec![], None::<DamlIdentifier>));
        )
    } else {
        quote!(
            let mut records = vec![];
            #all_choice_fields
            let params = DamlValue::Record(DamlRecord::new(records, None::<DamlIdentifier>));
        )
    }
}

/// Generate all choice fields.
fn quote_declare_all_choice_fields(choice_parameters: &[&DamlField<'_>]) -> TokenStream {
    choice_parameters.iter().map(|&field| quote_declare_choice_field(field.name(), field.ty())).collect()
}

/// Generate a choice field.
fn quote_declare_choice_field(field_name: &str, field_type: &DamlType<'_>) -> TokenStream {
    let field_source_tokens = quote_escaped_ident(field_name);
    let name_string = quote!(#field_name);
    let choice_type_tokens = quote_type(field_type);
    let serialize_value_tokens = quote!(
        <#choice_type_tokens as DamlSerializeInto<DamlValue>>::serialize_into(#field_source_tokens.into())
    );
    quote!(
        records.push(DamlRecordField::new(Some(#name_string), #serialize_value_tokens));
    )
}

fn quote_command_method_name(name: &str) -> TokenStream {
    quote_escaped_ident(format!("{}_command", name))
}