hegeltest-macros 0.14.21

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

use proc_macro2::TokenStream;
use quote::quote;
use syn::punctuated::Punctuated;
use syn::token::Comma;
use syn::{FnArg, ItemFn, ReturnType, parse_quote, parse2};

// Our goal is to expand this
//
// #[hegel::composite]
// fn composite_generator(tc: TestCase, a: A, b: B) -> C {
//     body
// }
//
// into this
//
// fn composite_generator(a: A, b: B) -> ComposedGenerator<C, impl Fn(TestCase) -> C> {
//     compose!(|tc| { body })
// }

pub fn expand_composite(mut f: ItemFn) -> TokenStream {
    // Clone the input parameters into a vector, so we can pull the first one out.
    let input_parameters: Vec<FnArg> = f.sig.inputs.iter().cloned().collect();

    let Some((FnArg::Typed(tc_arg), passthrough)) = input_parameters.split_first() else {
        panic!(
            "A #[composite] generator must define a first parameter of type TestCase. When \
            drawing from a #[composite] generator with tc.draw(my_composite_gen), `tc` will \
            be automatically passed to my_composite_gen as the first argument."
        )
    };
    let tc_pattern = &tc_arg.pat;
    let tc_type = &tc_arg.ty;

    let ReturnType::Type(_, return_type) = &f.sig.output else {
        panic!("#[composite] generators must explicitly declare a return type.")
    };

    let composed_generator_type = quote! {
        -> ::hegel::generators::ComposedGenerator<#return_type, impl Fn(::hegel::TestCase) -> #return_type>
    };

    let mut signature = f.sig;
    signature.output = parse2(composed_generator_type).unwrap();
    signature.inputs = passthrough
        .iter()
        .cloned()
        .collect::<Punctuated<FnArg, Comma>>();

    f.block.stmts.insert(
        0,
        parse_quote! {
            ::hegel::__assert_is_test_case::< #tc_type >();
        },
    );

    let body = &f.block;
    let attributes = &f.attrs;
    let visibility = &f.vis;

    quote! {
        #(#attributes)*
        #visibility #signature
        { ::hegel::compose!(|#tc_pattern| #body) }
    }
}