aboutsummaryrefslogtreecommitdiff
path: root/mingling_macros/src/chain.rs
diff options
context:
space:
mode:
authorWeicao-CatilGrass <1992414357@qq.com>2026-05-22 08:33:46 +0800
committerWeicao-CatilGrass <1992414357@qq.com>2026-05-22 08:33:46 +0800
commit7adbe2715285d7baedfb91f5e81f5ea64f7d1a5a (patch)
treeb9e4985c5b2980613523eea8ad49974c5d1d1070 /mingling_macros/src/chain.rs
parent7eed97fe690f214eba43b4784bc2dee3a71a1498 (diff)
Extract resource injection into shared module and add to #[renderer]
Diffstat (limited to 'mingling_macros/src/chain.rs')
-rw-r--r--mingling_macros/src/chain.rs199
1 files changed, 5 insertions, 194 deletions
diff --git a/mingling_macros/src/chain.rs b/mingling_macros/src/chain.rs
index 60e44e9..9666c51 100644
--- a/mingling_macros/src/chain.rs
+++ b/mingling_macros/src/chain.rs
@@ -1,143 +1,13 @@
#![allow(clippy::too_many_arguments)]
+use crate::res_injection::{
+ ResourceInjection, extract_args_info, generate_immut_resource_bindings,
+ wrap_body_with_mut_resources,
+};
use proc_macro::TokenStream;
use quote::{ToTokens, quote};
use syn::spanned::Spanned;
-use syn::{
- FnArg, Ident, ItemFn, Pat, PatType, ReturnType, Signature, Type, TypePath, parse_macro_input,
-};
-
-/// Extracted information about a resource injection parameter
-struct ResourceInjection {
- var_name: Ident,
- full_type: Type,
- inner_type: TypePath,
- is_ref: bool,
- is_mut: bool,
-}
-
-/// Extracts the previous type and parameter name from function arguments,
-fn extract_args_info(sig: &Signature) -> syn::Result<(Pat, TypePath, Vec<ResourceInjection>)> {
- if sig.inputs.is_empty() {
- return Err(syn::Error::new(
- sig.span(),
- "Chain function must have at least one parameter",
- ));
- }
-
- // First parameter: required, the previous chain type (must be owned, not a reference)
- let first_arg = &sig.inputs[0];
- let (prev_param, previous_type) = match first_arg {
- FnArg::Typed(PatType { pat, ty, .. }) => {
- let param_pat = (**pat).clone();
- match &**ty {
- Type::Path(type_path) => {
- // Check that the type is a single-segment type (no `::`)
- if type_path.path.segments.len() > 1 {
- return Err(syn::Error::new(
- type_path.span(),
- format!(
- "The type `{}` in #[chain] function must be a simple single-segment type, \
- e.g. `Empty` instead of `other::Empty`. \
- Qualified paths with `::` are not allowed here.",
- quote! { #type_path }
- ),
- ));
- }
- (param_pat, type_path.clone())
- }
- Type::Reference(_) => {
- return Err(syn::Error::new(
- ty.span(),
- "The first parameter (previous type) must be taken by move, \
- not by reference. \
- Use `prev: SomeEntry` instead of `prev: &SomeEntry`.",
- ));
- }
- _ => {
- return Err(syn::Error::new(
- ty.span(),
- "First parameter type must be a type path",
- ));
- }
- }
- }
- FnArg::Receiver(_) => {
- return Err(syn::Error::new(
- first_arg.span(),
- "Chain function cannot have self parameter",
- ));
- }
- };
-
- // 2nd to Nth parameters: optional, for resource injection
- let mut resources = Vec::new();
- for arg in sig.inputs.iter().skip(1) {
- match arg {
- FnArg::Typed(PatType { pat, ty, .. }) => {
- // Extract the variable name – must be a simple identifier
- let var_name = match &**pat {
- Pat::Ident(pat_ident) => pat_ident.ident.clone(),
- _ => {
- return Err(syn::Error::new(
- pat.span(),
- "Resource injection parameter must be a simple identifier (e.g., `age: &Age`)",
- ));
- }
- };
-
- let full_type = *(*ty).clone();
-
- // Try to extract inner type for reference patterns like `&Age` -> `Age`
- // and `&mut Age` -> `Age`
- let (inner_type, is_ref, is_mut) = match &full_type {
- Type::Reference(ref_type) => match &*ref_type.elem {
- Type::Path(type_path) => {
- let is_mut = ref_type.mutability.is_some();
- (type_path.clone(), true, is_mut)
- }
- _ => {
- return Err(syn::Error::new(
- ty.span(),
- "Reference resource type must be a type path (e.g., `age: &Age`)",
- ));
- }
- },
- Type::Path(_) => {
- return Err(syn::Error::new(
- ty.span(),
- "Resource injection parameter must be a reference (`&T` or `&mut T`), \
- not an owned value. Use `age: &Age` instead of `age: Age`.",
- ));
- }
- _ => {
- return Err(syn::Error::new(
- ty.span(),
- "Resource injection type must be a type path or reference to one \
- (e.g., `age: Age` or `age: &Age`)",
- ));
- }
- };
-
- resources.push(ResourceInjection {
- var_name,
- full_type,
- inner_type,
- is_ref,
- is_mut,
- });
- }
- FnArg::Receiver(_) => {
- return Err(syn::Error::new(
- arg.span(),
- "Resource injection parameter cannot be self",
- ));
- }
- }
- }
-
- Ok((prev_param, previous_type, resources))
-}
+use syn::{Ident, ItemFn, Pat, ReturnType, Signature, Type, TypePath, parse_macro_input};
/// Parses the `#[chain(...)]` attribute arguments.
///
@@ -202,65 +72,6 @@ fn validate_return_type(sig: &Signature) -> Result<(), proc_macro2::TokenStream>
Ok(())
}
-/// Generates `let` binding statements for immutable resource injection parameters.
-///
-/// Each immutable reference parameter gets a `_binding` variable that holds the
-/// `res_or_default` result, then a shadowing `let` that borrows from it via `.as_ref()`.
-fn generate_immut_resource_bindings<'a>(
- resources: impl Iterator<Item = &'a ResourceInjection>,
- program_type: &proc_macro2::TokenStream,
-) -> Vec<proc_macro2::TokenStream> {
- resources
- .filter(|r| !r.is_mut)
- .map(|res| {
- let var_binding_name = syn::Ident::new(
- &format!("{}_binding", &res.var_name.to_string()),
- res.var_name.span(),
- );
- let var_name = &res.var_name;
- let full_type = &res.full_type;
- let inner_type = &res.inner_type;
- if res.is_ref {
- quote! {
- let #var_binding_name = ::mingling::this::<#program_type>()
- .res_or_default::<#inner_type>();
- let #var_name: #full_type = #var_binding_name.as_ref();
- }
- } else {
- quote! {
- let #var_name: #full_type = ::mingling::this::<#program_type>()
- .res_or_default::<#full_type>();
- }
- }
- })
- .collect()
-}
-
-/// Wraps the function body in nested `__modify_res_and_return_route` closures for
-/// each mutable resource parameter. The innermost closure gets the original body,
-/// and each mutable parameter wraps outward from last to first.
-fn wrap_body_with_mut_resources(
- fn_body_stmts: &[syn::Stmt],
- mut_resources: &[&ResourceInjection],
- program_type: &proc_macro2::TokenStream,
-) -> proc_macro2::TokenStream {
- let mut wrapped = quote! {
- #(#fn_body_stmts)*
- };
-
- for res in mut_resources.iter() {
- let var_name = &res.var_name;
- let inner_type = &res.inner_type;
- wrapped = quote! {
- ::mingling::this::<#program_type>().__modify_res_and_return_route(|#var_name: &mut #inner_type| {
- #wrapped
- }).into()
- };
- }
-
- wrapped
-}
-
/// Builds the `proc` function implementation that serves as the actual chain
/// entry point inside the generated `Chain` impl.
///