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

//! Shared parser and token helpers for declarative generator tests.

use std::str::FromStr;

use anyhow::{Result, anyhow};
use proc_macro2::TokenStream as TokenStream2;
use quote::quote;
use syn::parse_str;

use crate::derive::build::CollectionStrategies;
use crate::derive::generate::declarative::{
    generate_declarative_merge_impl, generate_declarative_state_struct,
};

pub(super) fn parse_ident(src: &str) -> Result<syn::Ident> {
    parse_str(src).map_err(|err| anyhow!(err))
}

pub(super) fn parse_type(src: &str) -> Result<syn::Type> {
    parse_str(src).map_err(|err| anyhow!(err))
}

pub(super) fn default_krate() -> TokenStream2 {
    quote! { ortho_config }
}

/// Returns the expected `DeclarativeMerge` impl for an empty `append_fields`
/// case.
///
/// # Examples
///
/// ```rust,ignore
/// let tokens = expected_declarative_merge_impl_empty();
/// assert!(tokens.to_string().contains("DeclarativeMerge"));
/// ```
pub(super) fn expected_declarative_merge_impl_empty() -> Result<TokenStream2> {
    let fixture = include_str!("fixtures/expected_merge_impl_empty.rs.txt");
    TokenStream2::from_str(fixture).map_err(|err| anyhow!("parse merge impl fixture: {err}"))
}

pub(super) fn append_strategies(fields: Vec<(syn::Ident, syn::Type)>) -> CollectionStrategies {
    CollectionStrategies {
        append: fields,
        map_replace: Vec::new(),
    }
}

pub(super) type TokenGenerator = fn(&CollectionStrategies) -> Result<TokenStream2>;

/// Generic helper that reduces duplication in token generator test utilities.
fn token_generator_helper<F>(
    config_name: &str,
    strategies: &CollectionStrategies,
    generator: F,
) -> Result<TokenStream2>
where
    F: FnOnce(&syn::Ident, &syn::Ident, &CollectionStrategies, &TokenStream2) -> TokenStream2,
{
    let krate = default_krate();
    let state_ident = parse_ident("__SampleDeclarativeMergeState")?;
    let config_ident = parse_ident(config_name)?;
    Ok(generator(&state_ident, &config_ident, strategies, &krate))
}

pub(super) fn state_struct_tokens(strategies: &CollectionStrategies) -> Result<TokenStream2> {
    token_generator_helper(
        "SampleConfig",
        strategies,
        generate_declarative_state_struct,
    )
}

pub(super) fn merge_impl_tokens(strategies: &CollectionStrategies) -> Result<TokenStream2> {
    token_generator_helper("Sample", strategies, generate_declarative_merge_impl)
}