// Copyright 2019-2020 Parity Technologies (UK) Ltd. // This file is part of Substrate. // Substrate is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // Substrate is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // You should have received a copy of the GNU General Public License // along with Substrate. If not, see //! Util function used by this crate. use proc_macro2::{TokenStream, Span}; use syn::{ Ident, Error, Signature, Pat, PatType, FnArg, Type, token, TraitItemMethod, ItemTrait, TraitItem, parse_quote, spanned::Spanned, }; use proc_macro_crate::crate_name; use std::env; use quote::quote; use inflector::Inflector; /// Generates the include for the runtime-interface crate. pub fn generate_runtime_interface_include() -> TokenStream { if env::var("CARGO_PKG_NAME").unwrap() == "sp-runtime-interface" { TokenStream::new() } else { match crate_name("sp-runtime-interface") { Ok(crate_name) => { let crate_name = Ident::new(&crate_name, Span::call_site()); quote!( #[doc(hidden)] extern crate #crate_name as proc_macro_runtime_interface; ) }, Err(e) => { let err = Error::new(Span::call_site(), &e).to_compile_error(); quote!( #err ) } } } } /// Generates the access to the `sp-runtime-interface` crate. pub fn generate_crate_access() -> TokenStream { if env::var("CARGO_PKG_NAME").unwrap() == "sp-runtime-interface" { quote!( sp_runtime_interface ) } else { quote!( proc_macro_runtime_interface ) } } /// Create the exchangeable host function identifier for the given function name. pub fn create_exchangeable_host_function_ident(name: &Ident) -> Ident { Ident::new(&format!("host_{}", name), Span::call_site()) } /// Create the host function identifier for the given function name. pub fn create_host_function_ident(name: &Ident, trait_name: &Ident) -> Ident { Ident::new( &format!( "ext_{}_{}_version_1", trait_name.to_string().to_snake_case(), name, ), Span::call_site(), ) } /// Returns the function arguments of the given `Signature`, minus any `self` arguments. pub fn get_function_arguments<'a>(sig: &'a Signature) -> impl Iterator + 'a { sig.inputs .iter() .filter_map(|a| match a { FnArg::Receiver(_) => None, FnArg::Typed(pat_type) => Some(pat_type), }) .enumerate() .map(|(i, arg)| { let mut res = arg.clone(); if let Pat::Wild(wild) = &*arg.pat { let ident = Ident::new( &format!("__runtime_interface_generated_{}_", i), wild.span(), ); res.pat = Box::new(parse_quote!( #ident )) } res }) } /// Returns the function argument names of the given `Signature`, minus any `self`. pub fn get_function_argument_names<'a>(sig: &'a Signature) -> impl Iterator> + 'a { get_function_arguments(sig).map(|pt| pt.pat) } /// Returns the function argument types of the given `Signature`, minus any `Self` type. pub fn get_function_argument_types<'a>(sig: &'a Signature) -> impl Iterator> + 'a { get_function_arguments(sig).map(|pt| pt.ty) } /// Returns the function argument types, minus any `Self` type. If any of the arguments /// is a reference, the underlying type without the ref is returned. pub fn get_function_argument_types_without_ref<'a>( sig: &'a Signature, ) -> impl Iterator> + 'a { get_function_arguments(sig) .map(|pt| pt.ty) .map(|ty| match *ty { Type::Reference(type_ref) => type_ref.elem, _ => ty, }) } /// Returns the function argument names and types, minus any `self`. If any of the arguments /// is a reference, the underlying type without the ref is returned. pub fn get_function_argument_names_and_types_without_ref<'a>( sig: &'a Signature, ) -> impl Iterator, Box)> + 'a { get_function_arguments(sig) .map(|pt| match *pt.ty { Type::Reference(type_ref) => (pt.pat, type_ref.elem), _ => (pt.pat, pt.ty), }) } /// Returns the `&`/`&mut` for all function argument types, minus the `self` arg. If a function /// argument is not a reference, `None` is returned. pub fn get_function_argument_types_ref_and_mut<'a>( sig: &'a Signature, ) -> impl Iterator)>> + 'a { get_function_arguments(sig) .map(|pt| pt.ty) .map(|ty| match *ty { Type::Reference(type_ref) => Some((type_ref.and_token, type_ref.mutability)), _ => None, }) } /// Returns an iterator over all trait methods for the given trait definition. pub fn get_trait_methods<'a>(trait_def: &'a ItemTrait) -> impl Iterator { trait_def .items .iter() .filter_map(|i| match i { TraitItem::Method(ref method) => Some(method), _ => None, }) }