ortho_config_macros 0.9.0

Procedural macros for ortho_config.
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

//! Token generation helpers for field documentation metadata.

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

use crate::derive::parse::FieldAttrs;

use super::value_types::{ValueTypeModel, enum_variants};

/// Helper to build optional metadata tokens with a single string field.
pub(super) fn build_optional_doc_metadata(
    value: Option<&str>,
    struct_path: &TokenStream,
    field_name: &str,
) -> TokenStream {
    value.map_or_else(
        || quote! { None },
        |s| {
            let lit = syn::LitStr::new(s, proc_macro2::Span::call_site());
            let field_ident = syn::Ident::new(field_name, proc_macro2::Span::call_site());
            quote! {
                Some(#struct_path {
                    #field_ident: String::from(#lit),
                })
            }
        },
    )
}

/// Generates tokens for the default value metadata.
pub(super) fn default_tokens(attrs: &FieldAttrs, krate: &TokenStream) -> TokenStream {
    let display_str = attrs.default.as_ref().map_or_else(
        || {
            attrs
                .inferred_clap_default
                .as_ref()
                .map(|inferred| match inferred {
                    crate::derive::parse::ClapInferredDefault::Value(expr)
                    | crate::derive::parse::ClapInferredDefault::ValueT(expr)
                    | crate::derive::parse::ClapInferredDefault::ValuesT(expr) => {
                        expr.to_token_stream().to_string()
                    }
                })
        },
        |expr| Some(expr.to_token_stream().to_string()),
    );

    build_optional_doc_metadata(
        display_str.as_deref(),
        &quote! { #krate::docs::DefaultValue },
        "display",
    )
}

/// Generates tokens for the deprecation metadata.
pub(super) fn deprecated_tokens(attrs: &FieldAttrs, krate: &TokenStream) -> TokenStream {
    build_optional_doc_metadata(
        attrs.doc.deprecated_note_id.as_deref(),
        &quote! { #krate::docs::Deprecation },
        "note_id",
    )
}

/// Generates tokens for enum possible values.
pub(super) fn build_possible_values(value_type: Option<&ValueTypeModel>) -> Vec<TokenStream> {
    value_type
        .and_then(enum_variants)
        .map_or_else(Vec::new, |variants| {
            variants
                .iter()
                .map(|value| {
                    let lit = syn::LitStr::new(value, proc_macro2::Span::call_site());
                    quote! { String::from(#lit) }
                })
                .collect::<Vec<_>>()
        })
}