difftreelog
misk: add docs for enums
in: master
2 files changed
crates/evm-coder/procedural/src/abi_derive.rsdiffbeforeafterboth1use quote::quote;23pub(crate) fn impl_abi_macro(ast: &syn::DeriveInput) -> syn::Result<proc_macro2::TokenStream> {4 let name = &ast.ident;5 match &ast.data {6 syn::Data::Struct(ds) => expand_struct(ds, ast),7 syn::Data::Enum(de) => expand_enum(de, ast),8 syn::Data::Union(_) => Err(syn::Error::new(name.span(), "Unions not supported")),9 }10}1112fn expand_struct(13 ds: &syn::DataStruct,14 ast: &syn::DeriveInput,15) -> syn::Result<proc_macro2::TokenStream> {16 let name = &ast.ident;17 let docs = extract_docs(&ast.attrs)?;18 let (is_named_fields, field_names, field_types, field_docs, params_count) = match ds.fields {19 syn::Fields::Named(ref fields) => Ok((20 true,21 fields.named.iter().enumerate().map(map_field_to_name),22 fields.named.iter().map(map_field_to_type),23 fields.named.iter().map(map_field_to_doc),24 fields.named.len(),25 )),26 syn::Fields::Unnamed(ref fields) => Ok((27 false,28 fields.unnamed.iter().enumerate().map(map_field_to_name),29 fields.unnamed.iter().map(map_field_to_type),30 fields.unnamed.iter().map(map_field_to_doc),31 fields.unnamed.len(),32 )),33 syn::Fields::Unit => Err(syn::Error::new(name.span(), "Unit structs not supported")),34 }?;3536 if params_count == 0 {37 return Err(syn::Error::new(name.span(), "Empty structs not supported"));38 };3940 let tuple_type = tuple_type(field_types.clone());41 let tuple_ref_type = tuple_ref_type(field_types.clone());42 let tuple_data = tuple_data_as_ref(is_named_fields, field_names.clone());43 let tuple_names = tuple_names(is_named_fields, field_names.clone());44 let struct_from_tuple = struct_from_tuple(name, is_named_fields, field_names.clone());4546 let can_be_plcaed_in_vec = impl_can_be_placed_in_vec(name);47 let abi_type = impl_struct_abi_type(name, tuple_type.clone());48 let abi_read = impl_struct_abi_read(name, tuple_type, tuple_names, struct_from_tuple);49 let abi_write = impl_struct_abi_write(name, is_named_fields, tuple_ref_type, tuple_data);50 let solidity_type = impl_struct_solidity_type(name, field_types.clone(), params_count);51 let solidity_type_name =52 impl_struct_solidity_type_name(name, field_types.clone(), params_count);53 let solidity_struct_collect =54 impl_struct_solidity_struct_collect(name, field_names, field_types, field_docs, &docs)?;5556 Ok(quote! {57 #can_be_plcaed_in_vec58 #abi_type59 #abi_read60 #abi_write61 #solidity_type62 #solidity_type_name63 #solidity_struct_collect64 })65}6667fn expand_enum(68 de: &syn::DataEnum,69 ast: &syn::DeriveInput,70) -> syn::Result<proc_macro2::TokenStream> {71 let name = &ast.ident;72 check_repr_u8(name, &ast.attrs)?;73 let option_count = check_and_count_option(de)?;74 let enum_options = de.variants.iter().map(|v| &v.ident);7576 let from = impl_enum_from_u8(name, enum_options.clone());77 let solidity_option = impl_solidity_option(name, enum_options.clone());78 let can_be_plcaed_in_vec = impl_can_be_placed_in_vec(name);79 let abi_type = impl_enum_abi_type(name);80 let abi_read = impl_enum_abi_read(name);81 let abi_write = impl_enum_abi_write(name);82 let solidity_type_name = impl_enum_solidity_type_name(name);83 let solidity_struct_collect =84 impl_enum_solidity_struct_collect(name, enum_options, option_count);8586 Ok(quote! {87 #from88 #solidity_option89 #can_be_plcaed_in_vec90 #abi_type91 #abi_read92 #abi_write93 #solidity_type_name94 #solidity_struct_collect95 })96}9798fn impl_solidity_option<'a>(99 name: &proc_macro2::Ident,100 enum_options: impl Iterator<Item = &'a syn::Ident>,101) -> proc_macro2::TokenStream {102 let enum_options = enum_options.map(|opt| {103 let s = name.to_string() + "." + opt.to_string().as_str();104 let as_string = proc_macro2::Literal::string(s.as_str());105 quote!(#name::#opt => #as_string,)106 });107 quote!(108 #[cfg(feature = "stubgen")]109 impl ::evm_coder::solidity::SolidityEnum for #name {110 fn solidity_option(&self) -> &str {111 match <#name>::default() {112 #(#enum_options)*113 }114 }115 }116 )117}118119fn impl_enum_from_u8<'a>(120 name: &proc_macro2::Ident,121 enum_options: impl Iterator<Item = &'a syn::Ident>,122) -> proc_macro2::TokenStream {123 let enum_options = enum_options.enumerate().map(|(i, opt)| {124 let n = proc_macro2::Literal::u8_suffixed(i as u8);125 quote! {#n => Ok(#name::#opt),}126 });127 quote!(128 impl TryFrom<u8> for #name {129 type Error = &'static str;130131 fn try_from(value: u8) -> ::std::result::Result<Self, Self::Error> {132 const err: &'static str = "Not convertible";133 match value {134 #(#enum_options)*135 _ => Err(err)136 }137 }138 }139 )140}141142fn impl_enum_abi_type(name: &syn::Ident) -> proc_macro2::TokenStream {143 quote! {144 impl ::evm_coder::abi::AbiType for #name {145 const SIGNATURE: ::evm_coder::custom_signature::SignatureUnit = <u8 as ::evm_coder::abi::AbiType>::SIGNATURE;146147 fn is_dynamic() -> bool {148 <u8 as ::evm_coder::abi::AbiType>::is_dynamic()149 }150 fn size() -> usize {151 <u8 as ::evm_coder::abi::AbiType>::size()152 }153 }154 }155}156157fn impl_enum_abi_read(name: &syn::Ident) -> proc_macro2::TokenStream {158 quote!(159 impl ::evm_coder::abi::AbiRead for #name {160 fn abi_read(reader: &mut ::evm_coder::abi::AbiReader) -> ::evm_coder::execution::Result<Self> {161 Ok(162 <u8 as ::evm_coder::abi::AbiRead>::abi_read(reader)?163 .try_into()?164 )165 }166 }167 )168}169170fn impl_enum_abi_write(name: &syn::Ident) -> proc_macro2::TokenStream {171 quote!(172 impl ::evm_coder::abi::AbiWrite for #name {173 fn abi_write(&self, writer: &mut ::evm_coder::abi::AbiWriter) {174 ::evm_coder::abi::AbiWrite::abi_write(&(*self as u8), writer);175 }176 }177 )178}179180fn impl_enum_solidity_type_name<'a>(name: &syn::Ident) -> proc_macro2::TokenStream {181 quote!(182 #[cfg(feature = "stubgen")]183 impl ::evm_coder::solidity::SolidityTypeName for #name {184 fn solidity_name(185 writer: &mut impl ::core::fmt::Write,186 tc: &::evm_coder::solidity::TypeCollector,187 ) -> ::core::fmt::Result {188 write!(writer, "{}", tc.collect_struct::<Self>())189 }190191 fn is_simple() -> bool {192 true193 }194195 fn solidity_default(196 writer: &mut impl ::core::fmt::Write,197 tc: &::evm_coder::solidity::TypeCollector,198 ) -> ::core::fmt::Result {199 write!(writer, "{}", <#name as ::evm_coder::solidity::SolidityEnum>::solidity_option(&<#name>::default()))200 }201 }202 )203}204205fn impl_enum_solidity_struct_collect<'a>(206 name: &syn::Ident,207 enum_options: impl Iterator<Item = &'a syn::Ident>,208 option_count: usize,209) -> proc_macro2::TokenStream {210 let string_name = name.to_string();211 let enum_options = enum_options.enumerate().map(|(i, opt)| {212 let opt = proc_macro2::Literal::string(opt.to_string().as_str());213 let comma = if i != option_count - 1 { "," } else { "" };214 quote! {215 writeln!(str, "\t{}{}", #opt, #comma).expect("Enum format option");216 }217 });218 quote!(219 #[cfg(feature = "stubgen")]220 impl ::evm_coder::solidity::StructCollect for #name {221 fn name() -> String {222 #string_name.into()223 }224225 fn declaration() -> String {226 use std::fmt::Write;227228 let mut str = String::new();229 // #(#docs)*230 writeln!(str, "enum {} {{", <Self as ::evm_coder::solidity::StructCollect>::name()).unwrap();231 #(#enum_options)*232 writeln!(str, "}}").unwrap();233 str234 }235 }236 )237}238239fn check_and_count_option(de: &syn::DataEnum) -> syn::Result<usize> {240 let mut count = 0;241 for error in de.variants.iter().filter_map(|v| {242 if !v.fields.is_empty() {243 Some(Err(syn::Error::new(244 v.ident.span(),245 "Enumeration parameters should not have fields",246 )))247 } else if v.discriminant.is_some() {248 Some(Err(syn::Error::new(249 v.ident.span(),250 "Enumeration options should not have an explicit specified value",251 )))252 } else {253 count += 1;254 None255 }256 }) {257 return error;258 }259260 Ok(count)261}262263fn check_repr_u8(name: &syn::Ident, attrs: &Vec<syn::Attribute>) -> syn::Result<()> {264 let mut has_repr = false;265 for error in attrs.iter().filter_map(|attr| {266 if let Some(ps) = attr.path.segments.first() {267 if ps.ident == "repr" {268 has_repr = true;269 let meta = match attr.parse_meta() {270 Ok(meta) => meta,271 Err(e) => return Some(Err(e)),272 };273 match meta {274 syn::Meta::List(p) => {275 for error in p.nested.iter().filter_map(|nm| match nm {276 syn::NestedMeta::Meta(m) => match m {277 syn::Meta::Path(p) => {278 for i in p.segments.iter().filter_map(|ps| {279 if ps.ident != "u8" {280 Some(Err(syn::Error::new(281 ps.ident.span(),282 "Enum is not \"repr(u8)\"",283 )))284 } else {285 None286 }287 }) {288 return Some(i);289 }290 None291 }292 _ => None,293 },294 _ => None,295 }) {296 return Some(error);297 }298 None::<syn::Result<()>>299 }300 _ => None,301 };302 }303 }304 None305 }) {306 return error;307 }308309 if !has_repr {310 return Err(syn::Error::new(name.span(), "Enum is not \"repr(u8)\""));311 }312313 Ok(())314}315316fn tuple_type<'a>(317 field_types: impl Iterator<Item = &'a syn::Type> + Clone,318) -> proc_macro2::TokenStream {319 let field_types = field_types.map(|ty| quote!(#ty,));320 quote! {(#(#field_types)*)}321}322323fn tuple_ref_type<'a>(324 field_types: impl Iterator<Item = &'a syn::Type> + Clone,325) -> proc_macro2::TokenStream {326 let field_types = field_types.map(|ty| quote!(&#ty,));327 quote! {(#(#field_types)*)}328}329330fn tuple_data_as_ref(331 is_named_fields: bool,332 field_names: impl Iterator<Item = syn::Ident> + Clone,333) -> proc_macro2::TokenStream {334 let field_names = field_names.enumerate().map(|(i, field)| {335 if is_named_fields {336 quote!(&self.#field,)337 } else {338 let field = proc_macro2::Literal::usize_unsuffixed(i);339 quote!(&self.#field,)340 }341 });342 quote! {(#(#field_names)*)}343}344345fn tuple_names(346 is_named_fields: bool,347 field_names: impl Iterator<Item = syn::Ident> + Clone,348) -> proc_macro2::TokenStream {349 let field_names = field_names.enumerate().map(|(i, field)| {350 if is_named_fields {351 quote!(#field,)352 } else {353 let field = proc_macro2::Ident::new(354 format!("field{}", i).as_str(),355 proc_macro2::Span::call_site(),356 );357 quote!(#field,)358 }359 });360 quote! {(#(#field_names)*)}361}362363fn struct_from_tuple(364 name: &syn::Ident,365 is_named_fields: bool,366 field_names: impl Iterator<Item = syn::Ident> + Clone,367) -> proc_macro2::TokenStream {368 let field_names = field_names.enumerate().map(|(i, field)| {369 if is_named_fields {370 quote!(#field,)371 } else {372 let field = proc_macro2::Ident::new(373 format!("field{}", i).as_str(),374 proc_macro2::Span::call_site(),375 );376 quote!(#field,)377 }378 });379380 if is_named_fields {381 quote! {#name {#(#field_names)*}}382 } else {383 quote! {#name (#(#field_names)*)}384 }385}386387fn extract_docs(attrs: &[syn::Attribute]) -> syn::Result<Vec<String>> {388 attrs389 .iter()390 .filter_map(|attr| {391 if let Some(ps) = attr.path.segments.first() {392 if ps.ident == "doc" {393 let meta = match attr.parse_meta() {394 Ok(meta) => meta,395 Err(e) => return Some(Err(e)),396 };397 match meta {398 syn::Meta::NameValue(mnv) => match &mnv.lit {399 syn::Lit::Str(ls) => return Some(Ok(ls.value())),400 _ => unreachable!(),401 },402 _ => unreachable!(),403 }404 }405 }406 None407 })408 .collect()409}410411fn map_field_to_name(field: (usize, &syn::Field)) -> syn::Ident {412 match field.1.ident.as_ref() {413 Some(name) => name.clone(),414 None => {415 let mut name = "field".to_string();416 name.push_str(field.0.to_string().as_str());417 syn::Ident::new(name.as_str(), proc_macro2::Span::call_site())418 }419 }420}421422fn map_field_to_type(field: &syn::Field) -> &syn::Type {423 &field.ty424}425426fn map_field_to_doc(field: &syn::Field) -> Result<Vec<std::string::String>, syn::Error> {427 extract_docs(&field.attrs)428}429430fn impl_can_be_placed_in_vec(ident: &syn::Ident) -> proc_macro2::TokenStream {431 quote! {432 impl ::evm_coder::sealed::CanBePlacedInVec for #ident {}433 }434}435436fn impl_struct_abi_type(437 name: &syn::Ident,438 tuple_type: proc_macro2::TokenStream,439) -> proc_macro2::TokenStream {440 quote! {441 impl ::evm_coder::abi::AbiType for #name {442 const SIGNATURE: ::evm_coder::custom_signature::SignatureUnit = <#tuple_type as ::evm_coder::abi::AbiType>::SIGNATURE;443 fn is_dynamic() -> bool {444 <#tuple_type as ::evm_coder::abi::AbiType>::is_dynamic()445 }446 fn size() -> usize {447 <#tuple_type as ::evm_coder::abi::AbiType>::size()448 }449 }450 }451}452453fn impl_struct_abi_read(454 name: &syn::Ident,455 tuple_type: proc_macro2::TokenStream,456 tuple_names: proc_macro2::TokenStream,457 struct_from_tuple: proc_macro2::TokenStream,458) -> proc_macro2::TokenStream {459 quote!(460 impl ::evm_coder::abi::AbiRead for #name {461 fn abi_read(reader: &mut ::evm_coder::abi::AbiReader) -> ::evm_coder::execution::Result<Self> {462 let #tuple_names = <#tuple_type as ::evm_coder::abi::AbiRead>::abi_read(reader)?;463 Ok(#struct_from_tuple)464 }465 }466 )467}468469fn impl_struct_abi_write(470 name: &syn::Ident,471 _is_named_fields: bool,472 tuple_type: proc_macro2::TokenStream,473 tuple_data: proc_macro2::TokenStream,474) -> proc_macro2::TokenStream {475 quote!(476 impl ::evm_coder::abi::AbiWrite for #name {477 fn abi_write(&self, writer: &mut ::evm_coder::abi::AbiWriter) {478 <#tuple_type as ::evm_coder::abi::AbiWrite>::abi_write(&#tuple_data, writer)479 }480 }481 )482}483484fn impl_struct_solidity_type<'a>(485 name: &syn::Ident,486 field_types: impl Iterator<Item = &'a syn::Type> + Clone,487 params_count: usize,488) -> proc_macro2::TokenStream {489 let len = proc_macro2::Literal::usize_suffixed(params_count);490 quote! {491 #[cfg(feature = "stubgen")]492 impl ::evm_coder::solidity::SolidityType for #name {493 fn names(tc: &::evm_coder::solidity::TypeCollector) -> Vec<String> {494 let mut collected =495 Vec::with_capacity(<Self as ::evm_coder::solidity::SolidityType>::len());496 #({497 let mut out = String::new();498 <#field_types as ::evm_coder::solidity::SolidityTypeName>::solidity_name(&mut out, tc)499 .expect("no fmt error");500 collected.push(out);501 })*502 collected503 }504505 fn len() -> usize {506 #len507 }508 }509 }510}511512fn impl_struct_solidity_type_name<'a>(513 name: &syn::Ident,514 field_types: impl Iterator<Item = &'a syn::Type> + Clone,515 params_count: usize,516) -> proc_macro2::TokenStream {517 let arg_dafaults = field_types.enumerate().map(|(i, ty)| {518 let mut defult_value = quote!(<#ty as ::evm_coder::solidity::SolidityTypeName519 >::solidity_default(writer, tc)?;);520 let last_item = params_count - 1;521 if i != last_item {522 defult_value.extend(quote! {write!(writer, ",")?;})523 }524 defult_value525 });526527 quote! {528 #[cfg(feature = "stubgen")]529 impl ::evm_coder::solidity::SolidityTypeName for #name {530 fn solidity_name(531 writer: &mut impl ::core::fmt::Write,532 tc: &::evm_coder::solidity::TypeCollector,533 ) -> ::core::fmt::Result {534 write!(writer, "{}", tc.collect_struct::<Self>())535 }536537 fn is_simple() -> bool {538 false539 }540541 fn solidity_default(542 writer: &mut impl ::core::fmt::Write,543 tc: &::evm_coder::solidity::TypeCollector,544 ) -> ::core::fmt::Result {545 write!(writer, "{}(", tc.collect_struct::<Self>())?;546547 #(#arg_dafaults)*548549 write!(writer, ")")550 }551 }552 }553}554555fn impl_struct_solidity_struct_collect<'a>(556 name: &syn::Ident,557 field_names: impl Iterator<Item = proc_macro2::Ident> + Clone,558 field_types: impl Iterator<Item = &'a syn::Type> + Clone,559 field_docs: impl Iterator<Item = syn::Result<Vec<String>>> + Clone,560 docs: &[String],561) -> syn::Result<proc_macro2::TokenStream> {562 let string_name = name.to_string();563 let name_type = field_names564 .into_iter()565 .zip(field_types)566 .zip(field_docs)567 .map(|((name, ty), doc)| {568 let field_docs = match doc {569 Ok(doc) => doc.into_iter().enumerate().map(|(i, doc)| {570 let doc = doc.trim();571 let dev = if i == 0 { " @dev" } else { "" };572 quote! {573 writeln!(str, "\t///{} {}", #dev, #doc).unwrap();574 }575 }),576 Err(e) => unreachable!("{:?}", e),577 };578 let name = format!("{}", name);579 quote!(580 #(#field_docs)*581 write!(str, "\t{} ", <#ty as ::evm_coder::solidity::StructCollect>::name()).unwrap();582 writeln!(str, "{};", #name).unwrap();583 )584 });585 let docs = docs.iter().enumerate().map(|(i, doc)| {586 let doc = doc.trim();587 let dev = if i == 0 { " @dev" } else { "" };588 quote! {589 writeln!(str, "///{} {}", #dev, #doc).unwrap();590 }591 });592593 Ok(quote! {594 #[cfg(feature = "stubgen")]595 impl ::evm_coder::solidity::StructCollect for #name {596 fn name() -> String {597 #string_name.into()598 }599600 fn declaration() -> String {601 use std::fmt::Write;602603 let mut str = String::new();604 #(#docs)*605 writeln!(str, "struct {} {{", Self::name()).unwrap();606 #(#name_type)*607 writeln!(str, "}}").unwrap();608 str609 }610 }611 })612}1use quote::quote;23pub(crate) fn impl_abi_macro(ast: &syn::DeriveInput) -> syn::Result<proc_macro2::TokenStream> {4 let name = &ast.ident;5 match &ast.data {6 syn::Data::Struct(ds) => expand_struct(ds, ast),7 syn::Data::Enum(de) => expand_enum(de, ast),8 syn::Data::Union(_) => Err(syn::Error::new(name.span(), "Unions not supported")),9 }10}1112fn expand_struct(13 ds: &syn::DataStruct,14 ast: &syn::DeriveInput,15) -> syn::Result<proc_macro2::TokenStream> {16 let name = &ast.ident;17 let docs = extract_docs(&ast.attrs, true)?;18 let (is_named_fields, field_names, field_types, field_docs, params_count) = match ds.fields {19 syn::Fields::Named(ref fields) => Ok((20 true,21 fields.named.iter().enumerate().map(map_field_to_name),22 fields.named.iter().map(map_field_to_type),23 fields.named.iter().map(map_field_to_doc),24 fields.named.len(),25 )),26 syn::Fields::Unnamed(ref fields) => Ok((27 false,28 fields.unnamed.iter().enumerate().map(map_field_to_name),29 fields.unnamed.iter().map(map_field_to_type),30 fields.unnamed.iter().map(map_field_to_doc),31 fields.unnamed.len(),32 )),33 syn::Fields::Unit => Err(syn::Error::new(name.span(), "Unit structs not supported")),34 }?;3536 if params_count == 0 {37 return Err(syn::Error::new(name.span(), "Empty structs not supported"));38 };3940 let tuple_type = tuple_type(field_types.clone());41 let tuple_ref_type = tuple_ref_type(field_types.clone());42 let tuple_data = tuple_data_as_ref(is_named_fields, field_names.clone());43 let tuple_names = tuple_names(is_named_fields, field_names.clone());44 let struct_from_tuple = struct_from_tuple(name, is_named_fields, field_names.clone());4546 let can_be_plcaed_in_vec = impl_can_be_placed_in_vec(name);47 let abi_type = impl_struct_abi_type(name, tuple_type.clone());48 let abi_read = impl_struct_abi_read(name, tuple_type, tuple_names, struct_from_tuple);49 let abi_write = impl_struct_abi_write(name, is_named_fields, tuple_ref_type, tuple_data);50 let solidity_type = impl_struct_solidity_type(name, field_types.clone(), params_count);51 let solidity_type_name =52 impl_struct_solidity_type_name(name, field_types.clone(), params_count);53 let solidity_struct_collect =54 impl_struct_solidity_struct_collect(name, field_names, field_types, field_docs, &docs)?;5556 Ok(quote! {57 #can_be_plcaed_in_vec58 #abi_type59 #abi_read60 #abi_write61 #solidity_type62 #solidity_type_name63 #solidity_struct_collect64 })65}6667fn expand_enum(68 de: &syn::DataEnum,69 ast: &syn::DeriveInput,70) -> syn::Result<proc_macro2::TokenStream> {71 let name = &ast.ident;72 check_repr_u8(name, &ast.attrs)?;73 let docs = extract_docs(&ast.attrs, true)?;74 let option_count = check_and_count_option(de)?;75 let enum_options = de.variants.iter().map(|v| &v.ident);76 let enum_options_docs = de.variants.iter().map(|v| extract_docs(&v.attrs, false));7778 let from = impl_enum_from_u8(name, enum_options.clone());79 let solidity_option = impl_solidity_option(name, enum_options.clone());80 let can_be_plcaed_in_vec = impl_can_be_placed_in_vec(name);81 let abi_type = impl_enum_abi_type(name);82 let abi_read = impl_enum_abi_read(name);83 let abi_write = impl_enum_abi_write(name);84 let solidity_type_name = impl_enum_solidity_type_name(name);85 let solidity_struct_collect = impl_enum_solidity_struct_collect(86 name,87 enum_options,88 option_count,89 enum_options_docs,90 &docs,91 );9293 Ok(quote! {94 #from95 #solidity_option96 #can_be_plcaed_in_vec97 #abi_type98 #abi_read99 #abi_write100 #solidity_type_name101 #solidity_struct_collect102 })103}104105fn impl_solidity_option<'a>(106 name: &proc_macro2::Ident,107 enum_options: impl Iterator<Item = &'a syn::Ident>,108) -> proc_macro2::TokenStream {109 let enum_options = enum_options.map(|opt| {110 let s = name.to_string() + "." + opt.to_string().as_str();111 let as_string = proc_macro2::Literal::string(s.as_str());112 quote!(#name::#opt => #as_string,)113 });114 quote!(115 #[cfg(feature = "stubgen")]116 impl ::evm_coder::solidity::SolidityEnum for #name {117 fn solidity_option(&self) -> &str {118 match <#name>::default() {119 #(#enum_options)*120 }121 }122 }123 )124}125126fn impl_enum_from_u8<'a>(127 name: &proc_macro2::Ident,128 enum_options: impl Iterator<Item = &'a syn::Ident>,129) -> proc_macro2::TokenStream {130 let enum_options = enum_options.enumerate().map(|(i, opt)| {131 let n = proc_macro2::Literal::u8_suffixed(i as u8);132 quote! {#n => Ok(#name::#opt),}133 });134 quote!(135 impl TryFrom<u8> for #name {136 type Error = &'static str;137138 fn try_from(value: u8) -> ::std::result::Result<Self, Self::Error> {139 const err: &'static str = "Not convertible";140 match value {141 #(#enum_options)*142 _ => Err(err)143 }144 }145 }146 )147}148149fn impl_enum_abi_type(name: &syn::Ident) -> proc_macro2::TokenStream {150 quote! {151 impl ::evm_coder::abi::AbiType for #name {152 const SIGNATURE: ::evm_coder::custom_signature::SignatureUnit = <u8 as ::evm_coder::abi::AbiType>::SIGNATURE;153154 fn is_dynamic() -> bool {155 <u8 as ::evm_coder::abi::AbiType>::is_dynamic()156 }157 fn size() -> usize {158 <u8 as ::evm_coder::abi::AbiType>::size()159 }160 }161 }162}163164fn impl_enum_abi_read(name: &syn::Ident) -> proc_macro2::TokenStream {165 quote!(166 impl ::evm_coder::abi::AbiRead for #name {167 fn abi_read(reader: &mut ::evm_coder::abi::AbiReader) -> ::evm_coder::execution::Result<Self> {168 Ok(169 <u8 as ::evm_coder::abi::AbiRead>::abi_read(reader)?170 .try_into()?171 )172 }173 }174 )175}176177fn impl_enum_abi_write(name: &syn::Ident) -> proc_macro2::TokenStream {178 quote!(179 impl ::evm_coder::abi::AbiWrite for #name {180 fn abi_write(&self, writer: &mut ::evm_coder::abi::AbiWriter) {181 ::evm_coder::abi::AbiWrite::abi_write(&(*self as u8), writer);182 }183 }184 )185}186187fn impl_enum_solidity_type_name<'a>(name: &syn::Ident) -> proc_macro2::TokenStream {188 quote!(189 #[cfg(feature = "stubgen")]190 impl ::evm_coder::solidity::SolidityTypeName for #name {191 fn solidity_name(192 writer: &mut impl ::core::fmt::Write,193 tc: &::evm_coder::solidity::TypeCollector,194 ) -> ::core::fmt::Result {195 write!(writer, "{}", tc.collect_struct::<Self>())196 }197198 fn is_simple() -> bool {199 true200 }201202 fn solidity_default(203 writer: &mut impl ::core::fmt::Write,204 tc: &::evm_coder::solidity::TypeCollector,205 ) -> ::core::fmt::Result {206 write!(writer, "{}", <#name as ::evm_coder::solidity::SolidityEnum>::solidity_option(&<#name>::default()))207 }208 }209 )210}211212fn impl_enum_solidity_struct_collect<'a>(213 name: &syn::Ident,214 enum_options: impl Iterator<Item = &'a syn::Ident>,215 option_count: usize,216 enum_options_docs: impl Iterator<Item = syn::Result<Vec<proc_macro2::TokenStream>>>,217 docs: &[proc_macro2::TokenStream],218) -> proc_macro2::TokenStream {219 let string_name = name.to_string();220 let enum_options = enum_options221 .zip(enum_options_docs)222 .enumerate()223 .map(|(i, (opt, doc))| {224 let opt = proc_macro2::Literal::string(opt.to_string().as_str());225 let doc = doc.expect("Doc parsing error");226 let comma = if i != option_count - 1 { "," } else { "" };227 quote! {228 #(#doc)*229 writeln!(str, "\t{}{}", #opt, #comma).expect("Enum format option");230 }231 });232233 quote!(234 #[cfg(feature = "stubgen")]235 impl ::evm_coder::solidity::StructCollect for #name {236 fn name() -> String {237 #string_name.into()238 }239240 fn declaration() -> String {241 use std::fmt::Write;242243 let mut str = String::new();244 #(#docs)*245 writeln!(str, "enum {} {{", <Self as ::evm_coder::solidity::StructCollect>::name()).unwrap();246 #(#enum_options)*247 writeln!(str, "}}").unwrap();248 str249 }250 }251 )252}253254fn check_and_count_option(de: &syn::DataEnum) -> syn::Result<usize> {255 let mut count = 0;256 for error in de.variants.iter().filter_map(|v| {257 if !v.fields.is_empty() {258 Some(Err(syn::Error::new(259 v.ident.span(),260 "Enumeration parameters should not have fields",261 )))262 } else if v.discriminant.is_some() {263 Some(Err(syn::Error::new(264 v.ident.span(),265 "Enumeration options should not have an explicit specified value",266 )))267 } else {268 count += 1;269 None270 }271 }) {272 return error;273 }274275 Ok(count)276}277278fn check_repr_u8(name: &syn::Ident, attrs: &Vec<syn::Attribute>) -> syn::Result<()> {279 let mut has_repr = false;280 for error in attrs.iter().filter_map(|attr| {281 if let Some(ps) = attr.path.segments.first() {282 if ps.ident == "repr" {283 has_repr = true;284 let meta = match attr.parse_meta() {285 Ok(meta) => meta,286 Err(e) => return Some(Err(e)),287 };288 match meta {289 syn::Meta::List(p) => {290 for error in p.nested.iter().filter_map(|nm| match nm {291 syn::NestedMeta::Meta(m) => match m {292 syn::Meta::Path(p) => {293 for i in p.segments.iter().filter_map(|ps| {294 if ps.ident != "u8" {295 Some(Err(syn::Error::new(296 ps.ident.span(),297 "Enum is not \"repr(u8)\"",298 )))299 } else {300 None301 }302 }) {303 return Some(i);304 }305 None306 }307 _ => None,308 },309 _ => None,310 }) {311 return Some(error);312 }313 None::<syn::Result<()>>314 }315 _ => None,316 };317 }318 }319 None320 }) {321 return error;322 }323324 if !has_repr {325 return Err(syn::Error::new(name.span(), "Enum is not \"repr(u8)\""));326 }327328 Ok(())329}330331fn tuple_type<'a>(332 field_types: impl Iterator<Item = &'a syn::Type> + Clone,333) -> proc_macro2::TokenStream {334 let field_types = field_types.map(|ty| quote!(#ty,));335 quote! {(#(#field_types)*)}336}337338fn tuple_ref_type<'a>(339 field_types: impl Iterator<Item = &'a syn::Type> + Clone,340) -> proc_macro2::TokenStream {341 let field_types = field_types.map(|ty| quote!(&#ty,));342 quote! {(#(#field_types)*)}343}344345fn tuple_data_as_ref(346 is_named_fields: bool,347 field_names: impl Iterator<Item = syn::Ident> + Clone,348) -> proc_macro2::TokenStream {349 let field_names = field_names.enumerate().map(|(i, field)| {350 if is_named_fields {351 quote!(&self.#field,)352 } else {353 let field = proc_macro2::Literal::usize_unsuffixed(i);354 quote!(&self.#field,)355 }356 });357 quote! {(#(#field_names)*)}358}359360fn tuple_names(361 is_named_fields: bool,362 field_names: impl Iterator<Item = syn::Ident> + Clone,363) -> proc_macro2::TokenStream {364 let field_names = field_names.enumerate().map(|(i, field)| {365 if is_named_fields {366 quote!(#field,)367 } else {368 let field = proc_macro2::Ident::new(369 format!("field{}", i).as_str(),370 proc_macro2::Span::call_site(),371 );372 quote!(#field,)373 }374 });375 quote! {(#(#field_names)*)}376}377378fn struct_from_tuple(379 name: &syn::Ident,380 is_named_fields: bool,381 field_names: impl Iterator<Item = syn::Ident> + Clone,382) -> proc_macro2::TokenStream {383 let field_names = field_names.enumerate().map(|(i, field)| {384 if is_named_fields {385 quote!(#field,)386 } else {387 let field = proc_macro2::Ident::new(388 format!("field{}", i).as_str(),389 proc_macro2::Span::call_site(),390 );391 quote!(#field,)392 }393 });394395 if is_named_fields {396 quote! {#name {#(#field_names)*}}397 } else {398 quote! {#name (#(#field_names)*)}399 }400}401402fn extract_docs(403 attrs: &[syn::Attribute],404 is_general: bool,405) -> syn::Result<Vec<proc_macro2::TokenStream>> {406 attrs407 .iter()408 .filter_map(|attr| {409 if let Some(ps) = attr.path.segments.first() {410 if ps.ident == "doc" {411 let meta = match attr.parse_meta() {412 Ok(meta) => meta,413 Err(e) => return Some(Err(e)),414 };415 match meta {416 syn::Meta::NameValue(mnv) => match &mnv.lit {417 syn::Lit::Str(ls) => return Some(Ok(ls.value())),418 _ => unreachable!(),419 },420 _ => unreachable!(),421 }422 }423 }424 None425 })426 .enumerate()427 .map(|(i, doc)| {428 let doc = doc?;429 let doc = doc.trim();430 let dev = if i == 0 { " @dev" } else { "" };431 let tab = if is_general { "" } else { "\t" };432 Ok(quote! {433 writeln!(str, "{}///{} {}", #tab, #dev, #doc).unwrap();434 })435 })436 .collect()437}438439fn map_field_to_name(field: (usize, &syn::Field)) -> syn::Ident {440 match field.1.ident.as_ref() {441 Some(name) => name.clone(),442 None => {443 let mut name = "field".to_string();444 name.push_str(field.0.to_string().as_str());445 syn::Ident::new(name.as_str(), proc_macro2::Span::call_site())446 }447 }448}449450fn map_field_to_type(field: &syn::Field) -> &syn::Type {451 &field.ty452}453454fn map_field_to_doc(field: &syn::Field) -> syn::Result<Vec<proc_macro2::TokenStream>> {455 extract_docs(&field.attrs, false)456}457458fn impl_can_be_placed_in_vec(ident: &syn::Ident) -> proc_macro2::TokenStream {459 quote! {460 impl ::evm_coder::sealed::CanBePlacedInVec for #ident {}461 }462}463464fn impl_struct_abi_type(465 name: &syn::Ident,466 tuple_type: proc_macro2::TokenStream,467) -> proc_macro2::TokenStream {468 quote! {469 impl ::evm_coder::abi::AbiType for #name {470 const SIGNATURE: ::evm_coder::custom_signature::SignatureUnit = <#tuple_type as ::evm_coder::abi::AbiType>::SIGNATURE;471 fn is_dynamic() -> bool {472 <#tuple_type as ::evm_coder::abi::AbiType>::is_dynamic()473 }474 fn size() -> usize {475 <#tuple_type as ::evm_coder::abi::AbiType>::size()476 }477 }478 }479}480481fn impl_struct_abi_read(482 name: &syn::Ident,483 tuple_type: proc_macro2::TokenStream,484 tuple_names: proc_macro2::TokenStream,485 struct_from_tuple: proc_macro2::TokenStream,486) -> proc_macro2::TokenStream {487 quote!(488 impl ::evm_coder::abi::AbiRead for #name {489 fn abi_read(reader: &mut ::evm_coder::abi::AbiReader) -> ::evm_coder::execution::Result<Self> {490 let #tuple_names = <#tuple_type as ::evm_coder::abi::AbiRead>::abi_read(reader)?;491 Ok(#struct_from_tuple)492 }493 }494 )495}496497fn impl_struct_abi_write(498 name: &syn::Ident,499 _is_named_fields: bool,500 tuple_type: proc_macro2::TokenStream,501 tuple_data: proc_macro2::TokenStream,502) -> proc_macro2::TokenStream {503 quote!(504 impl ::evm_coder::abi::AbiWrite for #name {505 fn abi_write(&self, writer: &mut ::evm_coder::abi::AbiWriter) {506 <#tuple_type as ::evm_coder::abi::AbiWrite>::abi_write(&#tuple_data, writer)507 }508 }509 )510}511512fn impl_struct_solidity_type<'a>(513 name: &syn::Ident,514 field_types: impl Iterator<Item = &'a syn::Type> + Clone,515 params_count: usize,516) -> proc_macro2::TokenStream {517 let len = proc_macro2::Literal::usize_suffixed(params_count);518 quote! {519 #[cfg(feature = "stubgen")]520 impl ::evm_coder::solidity::SolidityType for #name {521 fn names(tc: &::evm_coder::solidity::TypeCollector) -> Vec<String> {522 let mut collected =523 Vec::with_capacity(<Self as ::evm_coder::solidity::SolidityType>::len());524 #({525 let mut out = String::new();526 <#field_types as ::evm_coder::solidity::SolidityTypeName>::solidity_name(&mut out, tc)527 .expect("no fmt error");528 collected.push(out);529 })*530 collected531 }532533 fn len() -> usize {534 #len535 }536 }537 }538}539540fn impl_struct_solidity_type_name<'a>(541 name: &syn::Ident,542 field_types: impl Iterator<Item = &'a syn::Type> + Clone,543 params_count: usize,544) -> proc_macro2::TokenStream {545 let arg_dafaults = field_types.enumerate().map(|(i, ty)| {546 let mut defult_value = quote!(<#ty as ::evm_coder::solidity::SolidityTypeName547 >::solidity_default(writer, tc)?;);548 let last_item = params_count - 1;549 if i != last_item {550 defult_value.extend(quote! {write!(writer, ",")?;})551 }552 defult_value553 });554555 quote! {556 #[cfg(feature = "stubgen")]557 impl ::evm_coder::solidity::SolidityTypeName for #name {558 fn solidity_name(559 writer: &mut impl ::core::fmt::Write,560 tc: &::evm_coder::solidity::TypeCollector,561 ) -> ::core::fmt::Result {562 write!(writer, "{}", tc.collect_struct::<Self>())563 }564565 fn is_simple() -> bool {566 false567 }568569 fn solidity_default(570 writer: &mut impl ::core::fmt::Write,571 tc: &::evm_coder::solidity::TypeCollector,572 ) -> ::core::fmt::Result {573 write!(writer, "{}(", tc.collect_struct::<Self>())?;574575 #(#arg_dafaults)*576577 write!(writer, ")")578 }579 }580 }581}582583fn impl_struct_solidity_struct_collect<'a>(584 name: &syn::Ident,585 field_names: impl Iterator<Item = proc_macro2::Ident> + Clone,586 field_types: impl Iterator<Item = &'a syn::Type> + Clone,587 field_docs: impl Iterator<Item = syn::Result<Vec<proc_macro2::TokenStream>>> + Clone,588 docs: &[proc_macro2::TokenStream],589) -> syn::Result<proc_macro2::TokenStream> {590 let string_name = name.to_string();591 let name_type = field_names592 .into_iter()593 .zip(field_types)594 .zip(field_docs)595 .map(|((name, ty), doc)| {596 let field_docs = doc.expect("Doc parse error");597 let name = format!("{}", name);598 quote!(599 #(#field_docs)*600 write!(str, "\t{} ", <#ty as ::evm_coder::solidity::StructCollect>::name()).unwrap();601 writeln!(str, "{};", #name).unwrap();602 )603 });604605 Ok(quote! {606 #[cfg(feature = "stubgen")]607 impl ::evm_coder::solidity::StructCollect for #name {608 fn name() -> String {609 #string_name.into()610 }611612 fn declaration() -> String {613 use std::fmt::Write;614615 let mut str = String::new();616 #(#docs)*617 writeln!(str, "struct {} {{", Self::name()).unwrap();618 #(#name_type)*619 writeln!(str, "}}").unwrap();620 str621 }622 }623 })624}crates/evm-coder/tests/abi_derive_generation.rsdiffbeforeafterboth--- a/crates/evm-coder/tests/abi_derive_generation.rs
+++ b/crates/evm-coder/tests/abi_derive_generation.rs
@@ -80,7 +80,7 @@
<TypeStruct3DerivedMixedParam as ::evm_coder::solidity::StructCollect>::name(),
"TypeStruct3DerivedMixedParam"
);
- assert_eq!(
+ similar_asserts::assert_eq!(
<TypeStruct3DerivedMixedParam as ::evm_coder::solidity::StructCollect>::declaration(),
r#"/// @dev Some docs
/// At multi
@@ -288,7 +288,6 @@
/// multi
/// line
TupleStruct1SimpleParam,
- /// Docs for B
TupleStruct2DynamicParam,
/// Docs for C
TupleStruct2MixedParam,
@@ -301,7 +300,7 @@
<TupleStruct3DerivedMixedParam as ::evm_coder::solidity::StructCollect>::name(),
"TupleStruct3DerivedMixedParam"
);
- assert_eq!(
+ similar_asserts::assert_eq!(
<TupleStruct3DerivedMixedParam as ::evm_coder::solidity::StructCollect>::declaration(),
r#"/// @dev Some docs
/// At multi
@@ -311,7 +310,6 @@
/// multi
/// line
TupleStruct1SimpleParam field0;
- /// @dev Docs for B
TupleStruct2DynamicParam field1;
/// @dev Docs for C
TupleStruct2MixedParam field2;
@@ -749,7 +747,6 @@
/// multi
/// line
Red,
- /// Docs for Green
Green,
/// Docs for Blue
#[default]
@@ -824,19 +821,18 @@
<Color as ::evm_coder::solidity::StructCollect>::name(),
"Color"
);
- assert_eq!(
+ similar_asserts::assert_eq!(
<Color as ::evm_coder::solidity::StructCollect>::declaration(),
r#"/// @dev Some docs
/// At multi
/// line
enum Color {
- /// @dev Docs for A
+ /// @dev Docs for Red
/// multi
/// line
Red,
- /// @dev Docs for B
Green,
- /// @dev Docs for C
+ /// @dev Docs for Blue
Blue
}
"#