Mosaic

此crate提供了一个进程宏，用于将数据嵌入到你的Rust代码中。

示例

use mosaic::embed;

/// Expands to a const item that contains a greeting.
macro_rules! greet {
    (
        $who:literal
    ) => {
        embed! {
            #[allow(dead_code)]
            const [< HELLO _ $who:case{upper} >]:concatenate : &str = [< "Hello" " " $who "!" >]:concatenate{string};
        }
    }
}

greet!("Jonas");

// Recursive expansion of greet! macro
// ====================================

const HELLO_JONAS: &str = r#"Hello Jonas!"#;

用法

将以下内容添加到你的 Cargo.toml

mosaic = "1"

背景

这最初是作为paste crate的替代品，允许你连接标识符并对它们应用大小写转换。

但是，由于paste crate已经不再定期更新，而我需要用于kebab case的大小写转换，我决定创建一个更强大和灵活的替代品。

结构

所有内容都通过embed宏传递，它是底层引擎的入口点。最初，仅将一个token树传递给一个任意的transformer链中的顶级转换器，然后通过token流进行计算。

块

块是embed宏的主要构建块，因为它们表示一个能够进行转换的token流。

块由方括号定义，并带有< >的注释，因此，[< (..) >]表示一个块，其中(..)是目标token流。块也可以有自己的转换器链，该链紧随块之后。

token-stream = token-tree | segment;

token-tree = group | ident | literal | punct | ...;

segment = block transformer-chain;

transformer = ident | ident "{" token-stream "}";

transformer-chain = ":" transformer { "," transformer };

block = "[" "<" token-stream { token-stream } ">" "]" [ transformer-chain ];