Skip to main content

tpt_env_mocker_macros/
lib.rs

1use proc_macro::TokenStream;
2use proc_macro2::Span;
3use quote::quote;
4use syn::{
5    parse_macro_input, punctuated::Punctuated, token::Comma, Expr, ExprLit, ItemFn, Lit,
6    MetaNameValue,
7};
8
9/// Attribute macro that wraps a test function in a scoped env mock.
10///
11/// # Example
12/// ```rust,ignore
13/// #[test]
14/// #[tpt_env(DB_URL = "postgres://localhost/test", LOG_LEVEL = "debug")]
15/// fn test_uses_env() {
16///     assert_eq!(std::env::var("DB_URL").unwrap(), "postgres://localhost/test");
17/// }
18/// ```
19#[proc_macro_attribute]
20pub fn tpt_env(args: TokenStream, item: TokenStream) -> TokenStream {
21    let func = parse_macro_input!(item as ItemFn);
22
23    // Parse args as comma-separated `KEY = "value"` pairs.
24    let pairs =
25        match syn::parse::Parser::parse(Punctuated::<MetaNameValue, Comma>::parse_terminated, args)
26        {
27            Ok(p) => p,
28            Err(e) => return e.to_compile_error().into(),
29        };
30
31    let mut set_calls = vec![];
32
33    for nv in &pairs {
34        let key = match nv.path.get_ident() {
35            Some(i) => i.to_string(),
36            None => {
37                return syn::Error::new_spanned(
38                    &nv.path,
39                    "expected a simple identifier for env var key",
40                )
41                .to_compile_error()
42                .into();
43            }
44        };
45        let val = match &nv.value {
46            Expr::Lit(ExprLit {
47                lit: Lit::Str(s), ..
48            }) => s.value(),
49            other => {
50                return syn::Error::new_spanned(other, "tpt_env values must be string literals")
51                    .to_compile_error()
52                    .into();
53            }
54        };
55        set_calls.push(quote! { .set(#key, #val) });
56    }
57
58    let sig = &func.sig;
59    let vis = &func.vis;
60    let attrs = &func.attrs;
61    let body = &func.block;
62    let asyncness = &sig.asyncness;
63
64    let expanded = if asyncness.is_some() {
65        quote! {
66            #(#attrs)*
67            #vis #sig {
68                let _guard = ::tpt_env_mocker::MockEnv::new()
69                    #(#set_calls)*
70                    .lock();
71                let result = async move #body;
72                result.await
73            }
74        }
75    } else {
76        quote! {
77            #(#attrs)*
78            #vis #sig {
79                let _guard = ::tpt_env_mocker::MockEnv::new()
80                    #(#set_calls)*
81                    .lock();
82                #body
83            }
84        }
85    };
86
87    // Suppress unused import warning on Span — it's only used in error paths.
88    let _ = Span::call_site();
89    expanded.into()
90}