use crate::syntax::Atom::*; use crate::syntax::{ attrs, error, Api, Doc, ExternFn, ExternType, Lang, Receiver, Ref, Signature, Slice, Struct, Ty1, Type, Var, }; use quote::{format_ident, quote}; use syn::punctuated::Punctuated; use syn::{ Abi, Error, Fields, FnArg, ForeignItem, ForeignItemFn, ForeignItemType, GenericArgument, Item, ItemForeignMod, ItemStruct, Pat, PathArguments, Result, ReturnType, Token, Type as RustType, TypeBareFn, TypePath, TypeReference, TypeSlice, }; pub mod kw { syn::custom_keyword!(Result); } pub fn parse_items(items: Vec) -> Result> { let mut apis = Vec::new(); for item in items { match item { Item::Struct(item) => { let strct = parse_struct(item)?; apis.push(strct); } Item::ForeignMod(foreign_mod) => { let functions = parse_foreign_mod(foreign_mod)?; apis.extend(functions); } Item::Use(item) => return Err(Error::new_spanned(item, error::USE_NOT_ALLOWED)), _ => return Err(Error::new_spanned(item, "unsupported item")), } } Ok(apis) } fn parse_struct(item: ItemStruct) -> Result { let generics = &item.generics; if !generics.params.is_empty() || generics.where_clause.is_some() { let struct_token = item.struct_token; let ident = &item.ident; let where_clause = &generics.where_clause; let span = quote!(#struct_token #ident #generics #where_clause); return Err(Error::new_spanned( span, "struct with generic parameters is not supported yet", )); } let mut doc = Doc::new(); let mut derives = Vec::new(); attrs::parse(&item.attrs, &mut doc, Some(&mut derives))?; let fields = match item.fields { Fields::Named(fields) => fields, Fields::Unit => return Err(Error::new_spanned(item, "unit structs are not supported")), Fields::Unnamed(_) => { return Err(Error::new_spanned(item, "tuple structs are not supported")) } }; Ok(Api::Struct(Struct { doc, derives, struct_token: item.struct_token, ident: item.ident, brace_token: fields.brace_token, fields: fields .named .into_iter() .map(|field| { Ok(Var { ident: field.ident.unwrap(), ty: parse_type(&field.ty)?, }) }) .collect::>()?, })) } fn parse_foreign_mod(foreign_mod: ItemForeignMod) -> Result> { let lang = parse_lang(foreign_mod.abi)?; let api_type = match lang { Lang::Cxx => Api::CxxType, Lang::Rust => Api::RustType, }; let api_function = match lang { Lang::Cxx => Api::CxxFunction, Lang::Rust => Api::RustFunction, }; let mut items = Vec::new(); for foreign in &foreign_mod.items { match foreign { ForeignItem::Type(foreign) => { let ety = parse_extern_type(foreign)?; items.push(api_type(ety)); } ForeignItem::Fn(foreign) => { let efn = parse_extern_fn(foreign, lang)?; items.push(api_function(efn)); } ForeignItem::Macro(foreign) if foreign.mac.path.is_ident("include") => { let include = foreign.mac.parse_body()?; items.push(Api::Include(include)); } _ => return Err(Error::new_spanned(foreign, "unsupported foreign item")), } } let mut types = items.iter().filter_map(|item| match item { Api::CxxType(ty) | Api::RustType(ty) => Some(ty), _ => None, }); if let (Some(single_type), None) = (types.next(), types.next()) { let single_type = single_type.ident.clone(); for item in &mut items { if let Api::CxxFunction(efn) | Api::RustFunction(efn) = item { if let Some(receiver) = &mut efn.receiver { if receiver.ty == "Self" { receiver.ty = single_type.clone(); } } } } } Ok(items) } fn parse_lang(abi: Abi) -> Result { let name = match &abi.name { Some(name) => name, None => { return Err(Error::new_spanned( abi, "ABI name is required, extern \"C\" or extern \"Rust\"", )); } }; match name.value().as_str() { "C" | "C++" => Ok(Lang::Cxx), "Rust" => Ok(Lang::Rust), _ => Err(Error::new_spanned(abi, "unrecognized ABI")), } } fn parse_extern_type(foreign_type: &ForeignItemType) -> Result { let doc = attrs::parse_doc(&foreign_type.attrs)?; let type_token = foreign_type.type_token; let ident = foreign_type.ident.clone(); Ok(ExternType { doc, type_token, ident, }) } fn parse_extern_fn(foreign_fn: &ForeignItemFn, lang: Lang) -> Result { let generics = &foreign_fn.sig.generics; if !generics.params.is_empty() || generics.where_clause.is_some() { return Err(Error::new_spanned( foreign_fn, "extern function with generic parameters is not supported yet", )); } if let Some(variadic) = &foreign_fn.sig.variadic { return Err(Error::new_spanned( variadic, "variadic function is not supported yet", )); } let mut receiver = None; let mut args = Punctuated::new(); for arg in foreign_fn.sig.inputs.pairs() { let (arg, comma) = arg.into_tuple(); match arg { FnArg::Receiver(arg) => { if let Some((ampersand, lifetime)) = &arg.reference { receiver = Some(Receiver { ampersand: *ampersand, lifetime: lifetime.clone(), mutability: arg.mutability, var: arg.self_token, ty: Token![Self](arg.self_token.span).into(), shorthand: true, }); continue; } return Err(Error::new_spanned(arg, "unsupported signature")); } FnArg::Typed(arg) => { let ident = match arg.pat.as_ref() { Pat::Ident(pat) => pat.ident.clone(), _ => return Err(Error::new_spanned(arg, "unsupported signature")), }; let ty = parse_type(&arg.ty)?; if ident != "self" { args.push_value(Var { ident, ty }); if let Some(comma) = comma { args.push_punct(*comma); } continue; } if let Type::Ref(reference) = ty { if let Type::Ident(ident) = reference.inner { receiver = Some(Receiver { ampersand: reference.ampersand, lifetime: reference.lifetime, mutability: reference.mutability, var: Token![self](ident.span()), ty: ident, shorthand: false, }); continue; } } return Err(Error::new_spanned(arg, "unsupported method receiver")); } } } let mut throws_tokens = None; let ret = parse_return_type(&foreign_fn.sig.output, &mut throws_tokens)?; let throws = throws_tokens.is_some(); let doc = attrs::parse_doc(&foreign_fn.attrs)?; let fn_token = foreign_fn.sig.fn_token; let ident = foreign_fn.sig.ident.clone(); let paren_token = foreign_fn.sig.paren_token; let semi_token = foreign_fn.semi_token; Ok(ExternFn { lang, doc, ident, sig: Signature { fn_token, receiver, args, ret, throws, paren_token, throws_tokens, }, semi_token, }) } fn parse_type(ty: &RustType) -> Result { match ty { RustType::Reference(ty) => parse_type_reference(ty), RustType::Path(ty) => parse_type_path(ty), RustType::Slice(ty) => parse_type_slice(ty), RustType::BareFn(ty) => parse_type_fn(ty), RustType::Tuple(ty) if ty.elems.is_empty() => Ok(Type::Void(ty.paren_token.span)), _ => Err(Error::new_spanned(ty, "unsupported type")), } } fn parse_type_reference(ty: &TypeReference) -> Result { let inner = parse_type(&ty.elem)?; let which = match &inner { Type::Ident(ident) if ident == "str" => { if ty.mutability.is_some() { return Err(Error::new_spanned(ty, "unsupported type")); } else { Type::Str } } Type::Slice(slice) => match &slice.inner { Type::Ident(ident) if ident == U8 && ty.mutability.is_none() => Type::SliceRefU8, _ => Type::Ref, }, _ => Type::Ref, }; Ok(which(Box::new(Ref { ampersand: ty.and_token, lifetime: ty.lifetime.clone(), mutability: ty.mutability, inner, }))) } fn parse_type_path(ty: &TypePath) -> Result { let path = &ty.path; if ty.qself.is_none() && path.leading_colon.is_none() && path.segments.len() == 1 { let segment = &path.segments[0]; let ident = segment.ident.clone(); match &segment.arguments { PathArguments::None => return Ok(Type::Ident(ident)), PathArguments::AngleBracketed(generic) => { if ident == "UniquePtr" && generic.args.len() == 1 { if let GenericArgument::Type(arg) = &generic.args[0] { let inner = parse_type(arg)?; return Ok(Type::UniquePtr(Box::new(Ty1 { name: ident, langle: generic.lt_token, inner, rangle: generic.gt_token, }))); } } else if ident == "CxxVector" && generic.args.len() == 1 { if let GenericArgument::Type(arg) = &generic.args[0] { let inner = parse_type(arg)?; return Ok(Type::CxxVector(Box::new(Ty1 { name: ident, langle: generic.lt_token, inner, rangle: generic.gt_token, }))); } } else if ident == "Box" && generic.args.len() == 1 { if let GenericArgument::Type(arg) = &generic.args[0] { let inner = parse_type(arg)?; return Ok(Type::RustBox(Box::new(Ty1 { name: ident, langle: generic.lt_token, inner, rangle: generic.gt_token, }))); } } else if ident == "Vec" && generic.args.len() == 1 { if let GenericArgument::Type(arg) = &generic.args[0] { let inner = parse_type(arg)?; return Ok(Type::RustVec(Box::new(Ty1 { name: ident, langle: generic.lt_token, inner, rangle: generic.gt_token, }))); } } } PathArguments::Parenthesized(_) => {} } } Err(Error::new_spanned(ty, "unsupported type")) } fn parse_type_slice(ty: &TypeSlice) -> Result { let inner = parse_type(&ty.elem)?; Ok(Type::Slice(Box::new(Slice { bracket: ty.bracket_token, inner, }))) } fn parse_type_fn(ty: &TypeBareFn) -> Result { if ty.lifetimes.is_some() { return Err(Error::new_spanned( ty, "function pointer with lifetime parameters is not supported yet", )); } if ty.variadic.is_some() { return Err(Error::new_spanned( ty, "variadic function pointer is not supported yet", )); } let args = ty .inputs .iter() .enumerate() .map(|(i, arg)| { let ty = parse_type(&arg.ty)?; let ident = match &arg.name { Some(ident) => ident.0.clone(), None => format_ident!("_{}", i), }; Ok(Var { ident, ty }) }) .collect::>()?; let mut throws_tokens = None; let ret = parse_return_type(&ty.output, &mut throws_tokens)?; let throws = throws_tokens.is_some(); Ok(Type::Fn(Box::new(Signature { fn_token: ty.fn_token, receiver: None, args, ret, throws, paren_token: ty.paren_token, throws_tokens, }))) } fn parse_return_type( ty: &ReturnType, throws_tokens: &mut Option<(kw::Result, Token![<], Token![>])>, ) -> Result> { let mut ret = match ty { ReturnType::Default => return Ok(None), ReturnType::Type(_, ret) => ret.as_ref(), }; if let RustType::Path(ty) = ret { let path = &ty.path; if ty.qself.is_none() && path.leading_colon.is_none() && path.segments.len() == 1 { let segment = &path.segments[0]; let ident = segment.ident.clone(); if let PathArguments::AngleBracketed(generic) = &segment.arguments { if ident == "Result" && generic.args.len() == 1 { if let GenericArgument::Type(arg) = &generic.args[0] { ret = arg; *throws_tokens = Some((kw::Result(ident.span()), generic.lt_token, generic.gt_token)); } } } } } match parse_type(ret)? { Type::Void(_) => Ok(None), ty => Ok(Some(ty)), } }