Crate quip

Crate quip 

Source
Expand description

Quip adds expression interpolation to several quasi-quoting macros:

§Setup

Add this to your Cargo.toml:

[dependencies]
quip = "0.1.0"
quote = "1"    # For `quip!` and `quip_spanned!`.
syn = "2"      # For `parse_quip!` and `parse_quip_spanned!`.

§Syntax

All Quip macros use #{...} for expression interpolation, where ... must evaluate to a type implementing quote::ToTokens. All other aspects, including repetition and hygiene, behave identically to the underlying macro.

quip! {
    impl Clone for #{item.name} {
        fn clone(&self) -> Self {
            Self {
                #(#{item.members}: self.#{item.members}.clone(),)*
            }
        }
    }
}

§Behind the Scenes

Quip scans tokens and transforms each expression interpolation #{...} into a variable interpolation #... by binding the expression to a temporary variable. The macro then passes the transformed tokens to the underlying quasi-quotation macro.

quip! {
    impl MyTrait for #{item.name} {}
}

The code above expands to:

{
    let __interpolation0 = &item.name;

    ::quote::quote! {
        impl MyTrait for #__interpolation0 {}
    }
}

Macros§

quip
Adds expression interpolation to quote::quote!.
quip_spanned
Adds expression interpolation to quote::quote_spanned!.
parse_quip
Adds expression interpolation to syn::parse_quote!.
parse_quip_spanned
Adds expression interpolation to syn::parse_quote_spanned!.