use proc_macro2::{Ident, Span, TokenStream}; use quote::quote; use syn::{ parse::{Parse, ParseStream}, Data, DataEnum, DeriveInput, Index, }; use crate::{ enum_::{rich_error_ffi_converter_impl, variant_metadata}, util::{ chain, create_metadata_items, derive_ffi_traits, either_attribute_arg, ident_to_string, kw, mod_path, parse_comma_separated, tagged_impl_header, try_metadata_value_from_usize, AttributeSliceExt, UniffiAttributeArgs, }, }; pub fn expand_error( input: DeriveInput, // Attributes from #[derive_error_for_udl()], if we are in udl mode attr_from_udl_mode: Option, udl_mode: bool, ) -> syn::Result { let enum_ = match input.data { Data::Enum(e) => e, _ => { return Err(syn::Error::new( Span::call_site(), "This derive currently only supports enums", )); } }; let ident = &input.ident; let mut attr: ErrorAttr = input.attrs.parse_uniffi_attr_args()?; if let Some(attr_from_udl_mode) = attr_from_udl_mode { attr = attr.merge(attr_from_udl_mode)?; } let ffi_converter_impl = error_ffi_converter_impl(ident, &enum_, &attr, udl_mode); let meta_static_var = (!udl_mode).then(|| { error_meta_static_var(ident, &enum_, attr.flat.is_some()) .unwrap_or_else(syn::Error::into_compile_error) }); let variant_errors: TokenStream = enum_ .variants .iter() .flat_map(|variant| { chain( variant.attrs.uniffi_attr_args_not_allowed_here(), variant .fields .iter() .flat_map(|field| field.attrs.uniffi_attr_args_not_allowed_here()), ) }) .map(syn::Error::into_compile_error) .collect(); Ok(quote! { #ffi_converter_impl #meta_static_var #variant_errors }) } fn error_ffi_converter_impl( ident: &Ident, enum_: &DataEnum, attr: &ErrorAttr, udl_mode: bool, ) -> TokenStream { if attr.flat.is_some() { flat_error_ffi_converter_impl(ident, enum_, udl_mode, attr.with_try_read.is_some()) } else { rich_error_ffi_converter_impl(ident, enum_, udl_mode) } } // FfiConverters for "flat errors" // // These are errors where we only lower the to_string() value, rather than any assocated data. // We lower the to_string() value unconditionally, whether the enum has associated data or not. fn flat_error_ffi_converter_impl( ident: &Ident, enum_: &DataEnum, udl_mode: bool, implement_lift: bool, ) -> TokenStream { let name = ident_to_string(ident); let lower_impl_spec = tagged_impl_header("Lower", ident, udl_mode); let lift_impl_spec = tagged_impl_header("Lift", ident, udl_mode); let derive_ffi_traits = derive_ffi_traits(ident, udl_mode, &["ConvertError"]); let mod_path = match mod_path() { Ok(p) => p, Err(e) => return e.into_compile_error(), }; let lower_impl = { let match_arms = enum_.variants.iter().enumerate().map(|(i, v)| { let v_ident = &v.ident; let idx = Index::from(i + 1); quote! { Self::#v_ident { .. } => { ::uniffi::deps::bytes::BufMut::put_i32(buf, #idx); <::std::string::String as ::uniffi::Lower>::write(error_msg, buf); } } }); quote! { #[automatically_derived] unsafe #lower_impl_spec { type FfiType = ::uniffi::RustBuffer; fn write(obj: Self, buf: &mut ::std::vec::Vec) { let error_msg = ::std::string::ToString::to_string(&obj); match obj { #(#match_arms)* } } fn lower(obj: Self) -> ::uniffi::RustBuffer { >::lower_into_rust_buffer(obj) } const TYPE_ID_META: ::uniffi::MetadataBuffer = ::uniffi::MetadataBuffer::from_code(::uniffi::metadata::codes::TYPE_ENUM) .concat_str(#mod_path) .concat_str(#name); } } }; let lift_impl = if implement_lift { let match_arms = enum_.variants.iter().enumerate().map(|(i, v)| { let v_ident = &v.ident; let idx = Index::from(i + 1); quote! { #idx => Self::#v_ident, } }); quote! { #[automatically_derived] unsafe #lift_impl_spec { type FfiType = ::uniffi::RustBuffer; fn try_read(buf: &mut &[::std::primitive::u8]) -> ::uniffi::deps::anyhow::Result { Ok(match ::uniffi::deps::bytes::Buf::get_i32(buf) { #(#match_arms)* v => ::uniffi::deps::anyhow::bail!("Invalid #ident enum value: {}", v), }) } fn try_lift(v: ::uniffi::RustBuffer) -> ::uniffi::deps::anyhow::Result { >::try_lift_from_rust_buffer(v) } const TYPE_ID_META: ::uniffi::MetadataBuffer = >::TYPE_ID_META; } } } else { quote! { // Lifting flat errors is not currently supported, but we still define the trait so // that dicts containing flat errors don't cause compile errors (see ReturnOnlyDict in // coverall.rs). // // Note: it would be better to not derive `Lift` for dictionaries containing flat // errors, but getting the trait bounds and derived impls there would be much harder. // For now, we just fail at runtime. #[automatically_derived] unsafe #lift_impl_spec { type FfiType = ::uniffi::RustBuffer; fn try_read(buf: &mut &[::std::primitive::u8]) -> ::uniffi::deps::anyhow::Result { panic!("Can't lift flat errors") } fn try_lift(v: ::uniffi::RustBuffer) -> ::uniffi::deps::anyhow::Result { panic!("Can't lift flat errors") } const TYPE_ID_META: ::uniffi::MetadataBuffer = >::TYPE_ID_META; } } }; quote! { #lower_impl #lift_impl #derive_ffi_traits } } pub(crate) fn error_meta_static_var( ident: &Ident, enum_: &DataEnum, flat: bool, ) -> syn::Result { let name = ident_to_string(ident); let module_path = mod_path()?; let mut metadata_expr = quote! { ::uniffi::MetadataBuffer::from_code(::uniffi::metadata::codes::ERROR) // first our is-flat flag .concat_bool(#flat) // followed by an enum .concat_str(#module_path) .concat_str(#name) }; if flat { metadata_expr.extend(flat_error_variant_metadata(enum_)?) } else { metadata_expr.extend(variant_metadata(enum_)?); } Ok(create_metadata_items("error", &name, metadata_expr, None)) } pub fn flat_error_variant_metadata(enum_: &DataEnum) -> syn::Result> { let variants_len = try_metadata_value_from_usize(enum_.variants.len(), "UniFFI limits enums to 256 variants")?; Ok(std::iter::once(quote! { .concat_value(#variants_len) }) .chain(enum_.variants.iter().map(|v| { let name = ident_to_string(&v.ident); quote! { .concat_str(#name) } })) .collect()) } #[derive(Default)] pub struct ErrorAttr { flat: Option, with_try_read: Option, } impl UniffiAttributeArgs for ErrorAttr { fn parse_one(input: ParseStream<'_>) -> syn::Result { let lookahead = input.lookahead1(); if lookahead.peek(kw::flat_error) { Ok(Self { flat: input.parse()?, ..Self::default() }) } else if lookahead.peek(kw::with_try_read) { Ok(Self { with_try_read: input.parse()?, ..Self::default() }) } else if lookahead.peek(kw::handle_unknown_callback_error) { // Not used anymore, but still lallowed Ok(Self::default()) } else { Err(lookahead.error()) } } fn merge(self, other: Self) -> syn::Result { Ok(Self { flat: either_attribute_arg(self.flat, other.flat)?, with_try_read: either_attribute_arg(self.with_try_read, other.with_try_read)?, }) } } // So ErrorAttr can be used with `parse_macro_input!` impl Parse for ErrorAttr { fn parse(input: ParseStream<'_>) -> syn::Result { parse_comma_separated(input) } }