Use statements in quote!

Description

Macro to simplify using Types in the quote! macro.

Usage

The quote_use! macro can be used just like quote!, but with the added functionality of adding use statements at the top:

quote_use!{
    use std::fs::read;
    
    read("src/main.rs")
}

This will expand to the equivalent statement using quote!:

quote!{
    ::std::fs::read::read("src/main.rs")
}

Prelude

This also allows to use contents of the rust prelude directly:

quote_use!{
    Some("src/main.rs")
}

Overriding prelude

When you want to use your own type instead of the prelude type this can be achieved by simply importing it like so

quote_use!{
    use anyhow::Result;
                                                                                                             
    Result
}

Different preludes

By default quote_use! uses the std prelude for 2021 edition, but this can be configured via features, and also completely disabled.

• prelude_std: Enables std::prelude::v1 (incompatible with prelude_core)
• prelude_core: Enables core::prelude::v1 (incompatible with prelude_std)
• prelude_2021: Enables core::prelude::rust_2021 (requires either prelude_std or prelude_core)

Other quote macros

There are also variants for other quote macros from syn and quote:

• quote_use! and quote_spanned_use! as replacement for quote! and quote_spanned! respectively
• parse_quote_use! and parse_quote_spanned_use! for parse_quote! and parse_quote_spanned!

Auto namespacing idents

Until Span::def_site is stabilized, identifiers in e.g. let bindings in proc-macro expansions can collide with e.g. constants.

To circumvent this you can enable the feature namespace_idents which will replace all identifiers with autonamespaced ones using the pattern "__{crate_name}_{ident}".