//! This crate provides derive macros for [`Encode`], [`Decode`], and //! [`Packet`]. It also provides the procedural macro [`ident_str!`] for parsing //! identifiers at compile time. //! //! See `valence_protocol`'s documentation for more information. use proc_macro::TokenStream as StdTokenStream; use proc_macro2::TokenStream; use quote::ToTokens; use syn::{ parse_quote, Attribute, Error, GenericParam, Generics, Lifetime, LifetimeDef, Lit, Meta, Result, Variant, }; mod decode; mod encode; mod ident_str; mod packet; #[proc_macro_derive(Encode, attributes(tag))] pub fn derive_encode(item: StdTokenStream) -> StdTokenStream { match encode::derive_encode(item.into()) { Ok(tokens) => tokens.into(), Err(e) => e.into_compile_error().into(), } } #[proc_macro_derive(Decode, attributes(tag))] pub fn derive_decode(item: StdTokenStream) -> StdTokenStream { match decode::derive_decode(item.into()) { Ok(tokens) => tokens.into(), Err(e) => e.into_compile_error().into(), } } #[proc_macro_derive(Packet, attributes(packet_id))] pub fn derive_packet(item: StdTokenStream) -> StdTokenStream { match packet::derive_packet(item.into()) { Ok(tokens) => tokens.into(), Err(e) => e.into_compile_error().into(), } } #[proc_macro] pub fn ident_str(item: StdTokenStream) -> StdTokenStream { match ident_str::ident_str(item.into()) { Ok(tokens) => tokens.into(), Err(e) => e.into_compile_error().into(), } } fn pair_variants_with_discriminants( variants: impl IntoIterator, ) -> Result> { let mut discriminant = 0; variants .into_iter() .map(|v| { if let Some(i) = find_tag_attr(&v.attrs)? { discriminant = i; } let pair = (discriminant, v); discriminant += 1; Ok(pair) }) .collect::>() } fn find_tag_attr(attrs: &[Attribute]) -> Result> { for attr in attrs { if let Meta::NameValue(nv) = attr.parse_meta()? { if nv.path.is_ident("tag") { let span = nv.lit.span(); return match nv.lit { Lit::Int(lit) => Ok(Some(lit.base10_parse::()?)), _ => Err(Error::new( span, "discriminant value must be an integer literal", )), }; } } } Ok(None) } /// Adding our lifetime to the generics before calling `.split_for_impl()` would /// also add it to the resulting ty_generics, which we don't want. So I'm doing /// this hack. fn decode_split_for_impl( mut generics: Generics, lifetime: Lifetime, ) -> (TokenStream, TokenStream, TokenStream) { let (impl_generics, ty_generics, where_clause) = generics.split_for_impl(); let mut impl_generics = impl_generics.to_token_stream(); let ty_generics = ty_generics.to_token_stream(); let where_clause = where_clause.to_token_stream(); if generics.lifetimes().next().is_none() { generics .params .push(GenericParam::Lifetime(LifetimeDef::new(lifetime))); impl_generics = generics.split_for_impl().0.to_token_stream(); } (impl_generics, ty_generics, where_clause) } fn add_trait_bounds(generics: &mut Generics, trait_: TokenStream) { for param in &mut generics.params { if let GenericParam::Type(type_param) = param { type_param.bounds.push(parse_quote!(#trait_)) } } }