icydb-model-macros 0.216.2

Procedural macros for IcyDB application models
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

//! Module: imp::field_walk
//! Responsibility: generated implementation tokens.
//! Does not own: runtime trait semantics.
//! Boundary: parsed nodes to impl tokens.

use crate::prelude::*;

///
/// FieldWalkBinding
///
/// Shared derive-side lowering for one entity or record field walk step.
/// This keeps field-name, path-segment, and member-access expansion under one
/// owner so visit/normalize/validate generation do not each rebuild that shape
/// independently.
///

pub(crate) struct FieldWalkBinding {
    ident: Ident,
    name: String,
}

impl FieldWalkBinding {
    /// Build one field-walk binding from one schema field.
    #[must_use]
    pub fn from_field(field: &Field) -> Self {
        Self {
            ident: field.name.clone(),
            name: field.name.to_string(),
        }
    }

    /// Borrow this field by immutable reference from the provided receiver.
    #[must_use]
    pub fn member_ref_from(&self, receiver: TokenStream) -> TokenStream {
        let ident = &self.ident;

        quote!(&#receiver.#ident)
    }

    /// Borrow this field by mutable reference from the provided receiver.
    #[must_use]
    pub fn member_mut_from(&self, receiver: TokenStream) -> TokenStream {
        let ident = &self.ident;

        quote!(&mut #receiver.#ident)
    }

    /// Emit one field path-segment token for visitor issue reporting.
    #[must_use]
    pub fn path_segment(&self) -> TokenStream {
        let name = &self.name;

        quote!(::icydb_model::visitor::PathSegment::Field(#name))
    }

    /// Return the stable field name string used by visitor traversal.
    #[must_use]
    pub fn field_name(&self) -> &str {
        &self.name
    }

    /// Return one stable generated helper name for immutable traversal.
    #[must_use]
    pub fn visit_fn_ident(&self) -> Ident {
        format_ident!("__visit_field_{}", self.ident)
    }

    /// Return one stable generated helper name for mutable traversal.
    #[must_use]
    pub fn visit_mut_fn_ident(&self) -> Ident {
        format_ident!("__visit_field_{}_mut", self.ident)
    }

    /// Return one stable generated helper name for normalization dispatch.
    #[must_use]
    pub fn normalize_fn_ident(&self) -> Ident {
        format_ident!("__normalize_field_{}", self.ident)
    }

    /// Return one stable generated helper name for validation dispatch.
    #[must_use]
    pub fn validate_fn_ident(&self) -> Ident {
        format_ident!("__validate_field_{}", self.ident)
    }
}

/// Lower one entity or record field list into reusable field-walk bindings.
#[must_use]
pub(crate) fn field_walk_bindings(fields: &FieldList) -> Vec<FieldWalkBinding> {
    fields.iter().map(FieldWalkBinding::from_field).collect()
}