ferro-macros 0.2.24

//! Injectable attribute macro for the Ferro framework
//!
//! Provides the `#[injectable]` attribute macro that auto-registers
//! concrete types as singletons in the App container.
//!
//! Supports constructor injection via `#[inject]` field attribute.

use proc_macro::TokenStream;
use quote::quote;
use syn::{parse_macro_input, DeriveInput, Fields, FieldsNamed};

/// Check if a field has the #[inject] attribute
fn has_inject_attr(field: &syn::Field) -> bool {
    field
        .attrs
        .iter()
        .any(|attr| attr.path().is_ident("inject"))
}

/// Implements the `#[injectable]` attribute macro
///
/// This macro automatically:
/// 1. Derives `Clone` for the type (and `Default` if no `#[inject]` fields)
/// 2. Registers the type as a singleton in the App container at startup
/// 3. For structs with `#[inject]` fields, resolves dependencies at registration time
///
/// # Example - Simple (no dependencies)
///
/// ```rust,ignore
/// use ferro::injectable;
///
/// #[injectable]
/// pub struct AppState {
///     pub counter: u32,
/// }
///
/// // Automatically registered at startup with Default::default()
/// // Resolve via:
/// let state: AppState = App::get().unwrap();
/// ```
///
/// # Example - With Dependencies
///
/// ```rust,ignore
/// use ferro::injectable;
///
/// #[injectable]
/// pub struct MyService {
///     #[inject]
///     config: AppConfig,
///     #[inject]
///     logger: LoggerService,
/// }
///
/// // Dependencies are resolved at startup
/// // Resolve via:
/// let service: MyService = App::get().unwrap();
/// ```
pub fn injectable_impl(input: TokenStream) -> TokenStream {
    let input = parse_macro_input!(input as DeriveInput);

    let ferro = quote!(::ferro);

    let name = &input.ident;
    let name_str = name.to_string();
    let vis = &input.vis;
    let attrs = &input.attrs;
    let generics = &input.generics;

    let expanded = match &input.data {
        syn::Data::Struct(data_struct) => {
            match &data_struct.fields {
                Fields::Named(fields_named) => generate_for_named_struct(
                    &ferro,
                    name,
                    name_str,
                    vis,
                    attrs,
                    generics,
                    fields_named,
                ),
                Fields::Unit => {
                    // Unit struct - use Default
                    quote! {
                        #(#attrs)*
                        #[derive(Default, Clone)]
                        #vis struct #name #generics;

                        #ferro::inventory::submit! {
                            #ferro::container::provider::SingletonEntry {
                                register: || {
                                    #ferro::App::singleton(<#name as ::std::default::Default>::default());
                                },
                                name: #name_str,
                            }
                        }
                    }
                }
                Fields::Unnamed(_) => syn::Error::new_spanned(
                    &input,
                    "injectable does not support tuple structs. Use named fields instead.",
                )
                .to_compile_error(),
            }
        }
        _ => syn::Error::new_spanned(&input, "injectable can only be used on structs")
            .to_compile_error(),
    };

    TokenStream::from(expanded)
}

fn generate_for_named_struct(
    ferro: &proc_macro2::TokenStream,
    name: &syn::Ident,
    name_str: String,
    vis: &syn::Visibility,
    attrs: &[syn::Attribute],
    generics: &syn::Generics,
    fields_named: &FieldsNamed,
) -> proc_macro2::TokenStream {
    let fields = &fields_named.named;

    // Check if any fields have #[inject] attribute
    let has_injected_fields = fields.iter().any(has_inject_attr);

    if has_injected_fields {
        // Generate code for structs with injected dependencies
        generate_with_injection(ferro, name, name_str, vis, attrs, generics, fields_named)
    } else {
        // Generate code for simple structs (use Default)
        let fields_without_inject: Vec<_> = fields.iter().collect();

        quote! {
            #(#attrs)*
            #[derive(Default, Clone)]
            #vis struct #name #generics {
                #(#fields_without_inject),*
            }

            #ferro::inventory::submit! {
                #ferro::container::provider::SingletonEntry {
                    register: || {
                        #ferro::App::singleton(<#name as ::std::default::Default>::default());
                    },
                    name: #name_str,
                }
            }
        }
    }
}

fn generate_with_injection(
    ferro: &proc_macro2::TokenStream,
    name: &syn::Ident,
    name_str: String,
    vis: &syn::Visibility,
    attrs: &[syn::Attribute],
    generics: &syn::Generics,
    fields_named: &FieldsNamed,
) -> proc_macro2::TokenStream {
    let fields = &fields_named.named;

    // Separate injected and non-injected fields
    let mut field_definitions = Vec::new();
    let mut field_initializations = Vec::new();

    for field in fields {
        let field_name = field.ident.as_ref().unwrap();
        let field_ty = &field.ty;
        let field_vis = &field.vis;

        // Filter out #[inject] attribute from field definition
        let other_attrs: Vec<_> = field
            .attrs
            .iter()
            .filter(|attr| !attr.path().is_ident("inject"))
            .collect();

        field_definitions.push(quote! {
            #(#other_attrs)*
            #field_vis #field_name: #field_ty
        });

        if has_inject_attr(field) {
            // This field needs to be resolved from the container
            field_initializations.push(quote! {
                #field_name: #ferro::App::resolve::<#field_ty>()
                    .expect(&format!(
                        "Failed to resolve dependency '{}' for '{}'. \
                         Make sure '{}' is registered before '{}'.",
                        stringify!(#field_ty),
                        #name_str,
                        stringify!(#field_ty),
                        #name_str
                    ))
            });
        } else {
            // Use Default for non-injected fields
            field_initializations.push(quote! {
                #field_name: ::std::default::Default::default()
            });
        }
    }

    quote! {
        #(#attrs)*
        #[derive(Clone)]
        #vis struct #name #generics {
            #(#field_definitions),*
        }

        impl #name {
            /// Resolve all dependencies and create an instance
            fn __resolve_dependencies() -> Self {
                Self {
                    #(#field_initializations),*
                }
            }
        }

        #ferro::inventory::submit! {
            #ferro::container::provider::SingletonEntry {
                register: || {
                    #ferro::App::singleton(#name::__resolve_dependencies());
                },
                name: #name_str,
            }
        }
    }
}