axum_problem_derive/
lib.rs1use darling::{ast, FromDeriveInput, FromVariant};
2use proc_macro::TokenStream;
3use quote::quote;
4use syn::{parse_macro_input, DeriveInput};
5
6#[proc_macro_derive(AxumProblem, attributes(problem))]
42pub fn derive_axum_problem(input: TokenStream) -> TokenStream {
43 let input = parse_macro_input!(input as DeriveInput);
44
45 match ProblemInput::from_derive_input(&input) {
46 Ok(parsed) => expand_derive(parsed).into(),
47 Err(e) => e.write_errors().into(),
48 }
49}
50
51#[derive(Debug, FromDeriveInput)]
54#[darling(attributes(problem), supports(enum_any))]
55struct ProblemInput {
56 ident: syn::Ident,
57 generics: syn::Generics,
58 data: ast::Data<ProblemVariant, ()>,
59}
60
61#[derive(Debug, FromVariant)]
62#[darling(attributes(problem))]
63struct ProblemVariant {
64 ident: syn::Ident,
65 fields: ast::Fields<syn::Type>,
66
67 status: u16,
69
70 #[darling(default)]
72 title: Option<String>,
73
74 #[darling(default)]
77 mask: bool,
78}
79
80fn expand_derive(input: ProblemInput) -> proc_macro2::TokenStream {
83 let ProblemInput { ident, generics, data } = input;
84 let (impl_generics, ty_generics, where_clause) = generics.split_for_impl();
85
86 let variants = match data {
87 ast::Data::Enum(variants) => variants,
88 _ => unreachable!("darling ensures enum_any"),
89 };
90
91 let arms = variants.iter().map(|v| build_match_arm(v, &ident));
92
93 quote! {
94 #[automatically_derived]
95 impl #impl_generics ::axum::response::IntoResponse for #ident #ty_generics #where_clause {
96 fn into_response(self) -> ::axum::response::Response {
97 match self {
98 #(#arms),*
99 }
100 }
101 }
102 }
103}
104
105fn build_match_arm(variant: &ProblemVariant, enum_ident: &syn::Ident) -> proc_macro2::TokenStream {
106 let status = variant.status;
107 let mask = variant.mask;
108
109 let title_expr = match &variant.title {
111 Some(t) => quote! { #t.to_owned() },
112 None => quote! { ::axum_problem::status_title(#status).to_owned() },
113 };
114
115 let (pattern, display_expr) = build_pattern(enum_ident, variant);
117
118 if mask {
119 quote! {
121 #pattern => {
122 ::tracing::error!(
124 error = %#display_expr,
125 status = #status,
126 "masked error — full detail suppressed in HTTP response"
127 );
128 let problem = ::axum_problem::Problem::new(#status)
129 .title(#title_expr);
130 ::axum::response::IntoResponse::into_response(problem)
131 }
132 }
133 } else {
134 quote! {
136 #pattern => {
137 let detail = format!("{}", #display_expr);
138 let problem = ::axum_problem::Problem::new(#status)
139 .title(#title_expr)
140 .detail(detail);
141 ::axum::response::IntoResponse::into_response(problem)
142 }
143 }
144 }
145}
146
147fn build_pattern(
148 enum_ident: &syn::Ident,
149 variant: &ProblemVariant,
150) -> (proc_macro2::TokenStream, proc_macro2::TokenStream) {
151 let v_ident = &variant.ident;
152
153 match &variant.fields.style {
154 ast::Style::Unit => {
155 let pattern = quote! { #enum_ident::#v_ident };
157 let display = quote! { #enum_ident::#v_ident };
159 (pattern, display)
160 }
161 ast::Style::Tuple => {
162 let pattern = quote! { ref __self @ #enum_ident::#v_ident(..) };
166 let display = quote! { __self };
167 (pattern, display)
168 }
169 ast::Style::Struct => {
170 let pattern = quote! { ref __self @ #enum_ident::#v_ident { .. } };
172 let display = quote! { __self };
173 (pattern, display)
174 }
175 }
176}