Project Icon

markup.rs

Rust语言的高性能类型安全模板引擎

markup.rs是一个Rust语言的模板引擎,通过编译时解析模板生成高效渲染代码。它支持嵌入Rust代码实现类型安全,语法简洁。该项目不含不安全代码,无运行时依赖,性能出色。它提供了Web框架集成示例,适合构建高性能Web应用。

markup.rs

一个blazingly fast、类型安全的Rust模板引擎。

构建 版本 文档 下载 许可证

markup.rs是一个由过程宏驱动的Rust模板引擎,它在编译时解析模板并生成最优的Rust代码以在运行时渲染模板。模板可以嵌入Rust代码,这些代码由Rust编译器进行类型检查,实现完全的类型安全。

特性

  • 完全类型安全,使用诸如rust-analyzer等编辑器扩展时可显示内联高亮错误。
  • HamlSlimPug启发的简洁易用、不容易出错的语法。
  • 零不安全代码。
  • 零运行时依赖。
  • ⚡ 速度极快。在这个基准测试中,在不使用不安全代码的模板引擎中速度最快,总体第二快。

安装

[dependencies]
markup = "0.15.0"

框架集成

我们有以下web框架的集成示例:

  1. Axum
  2. Rocket

快速示例

markup::define! {
    Home<'a>(title: &'a str) {
        @markup::doctype()
        html {
            head {
                title { @title }
                style {
                    "body { background: #fafbfc; }"
                    "#main { padding: 2rem; }"
                }
            }
            body {
                @Header { title }
                #main {
                    p {
                        "本域名用于文档中的说明性示例。您可以在文献中使用此域名,无需事先协调或请求许可。"
                    }
                    p {
                        a[href = "https://www.iana.org/domains/example"] {
                            "更多信息..."
                        }
                    }
                }
                @Footer { year: 2020 }
            }
        }
    }

    Header<'a>(title: &'a str) {
        header {
            h1 { @title }
        }
    }

    Footer(year: u32) {
        footer {
            "(c) " @year
        }
    }
}

fn main() {
    println!(
        "{}",
        Home {
            title: "示例域名"
        }
    )
}

输出

<!DOCTYPE html><html><head><title>示例域名</title><style>body { background: #fafbfc; }#main { padding: 2rem; }</style></head><body><header><h1>示例域名</h1></header><div id="main"><p>本域名用于文档中的说明性示例。您可以在文献中使用此域名,无需事先协调或请求许可。</p><p><a href="https://www.iana.org/domains/example">更多信息...</a></p></div><footer>(c) 2020</footer></body></html>

输出(手动美化)

<!doctype html>
<html>
  <head>
    <title>示例域名</title>
    <style>
      body {
        background: #fafbfc;
      }
      #main {
        padding: 2rem;
      }
    </style>
  </head>
  <body>
    <header><h1>示例域名</h1></header>
    <div id="main">
      <p>
        本域名用于文档中的说明性示例。您可以在文献中使用此域名,无需事先协调或请求许可。
      </p>
      <p>
        <a href="https://www.iana.org/domains/example">更多信息...</a>
      </p>
    </div>
    <footer>(c) 2020</footer>
  </body>
</html>

语法参考 (待完善)

markup::define! 和 markup::new!

定义模板有两种方式: markup::define!markup::new!

markup::define! 定义具有命名参数的模板。这些模板不能访问外部作用域的变量。这些模板可以有泛型参数。在底层,markup::define! 编译为实现了 markup::Renderstd::fmt::Display trait 的 Rust 结构体。

代码
markup::define! {
    Hello<'a>(name: &'a str) {
        "你好, " @name "!"
    }
    HelloGeneric<T: std::fmt::Display>(name: T) {
        "你好, " @name.to_string() "!"
    }
}

// 现在可以直接打印模板或写入流:
println!("{}", Hello { name: "世界" });
writeln!(&mut std::io::stdout(), "{}", HelloGeneric { name: "世界 2" }).unwrap();

// 模板也可以渲染为String:
let string = Hello { name: "世界 3" }.to_string();
println!("{}", string);
输出
你好, 世界!
你好, 世界 2!
你好, 世界 3!

markup::new! 定义没有任何参数的模板。这些模板可以访问外部作用域的变量。

代码
let name = "世界";
let template = markup::new! {
    "你好, " @name "!"
};

// 现在可以直接打印模板或写入流:
println!("{}", template);
writeln!(&mut std::io::stdout(), "{}", template).unwrap();

// 模板也可以渲染为String:
let string = template.to_string();
println!("{}", string);
输出
你好, 世界!
你好, 世界!
你好, 世界!

表达式

模板可以包含裸字面值,这些值会按原样渲染。它们也可以包含以 @ 符号开头的表达式(包括函数和宏调用)。所有字符串都会进行HTML转义,除非它们被包裹在 markup::raw() 中。

代码
markup::define! {
    Expressions(a: i32, b: i32) {
        1 " + " 2 " = " @{1 + 2} '\n'
        @a " - " @b " = " @{a - b} '\n'
        @format!("{} * {} = {}", a, b, a * b) '\n'
        @a " ^ 4 = " @a.pow(4) '\n'

        // 默认情况下所有输出都会被转义。
        "<>\n"
        // 可以使用 `markup::raw()` 禁用转义。
        @markup::raw("<div></div>")
    }
}

println!("{}", Expressions { a: 5, b: 3 });
输出
1 + 2 = 3
5 - 3 = 2
5 * 3 = 15
5 ^ 4 = 625
&lt;&gt;
<div></div>

元素

元素使用类似CSS选择器的语法定义。元素可以在花括号中包含其他嵌套元素,或者在自闭合元素后跟分号。

代码
markup::define! {
    Elements(name: &'static str) {
        // 仅一个div。
        div {}
        '\n'
        // 三个嵌套元素。
        main {
            aside {
                h3 { "侧边栏" }
            }
        }
        '\n'
        // 自闭合的input元素。
        input;
        '\n'
        // 名称包含破折号的元素。
        $"my-custom-element" {}
        '\n'
        // 动态名称的元素。
        ${name} {}
    }
}

println!("{}", Elements { name: "span" });
输出
<div></div>
<main><aside><h3>侧边栏</h3></aside></main>
<input>
<my-custom-element></my-custom-element>
<span></span>

属性

属性在元素名称后定义。idclass 属性可以使用类似CSS选择器的语法,使用 #. 定义。可以使用此简写语法多次指定类。其他属性在方括号中指定。

代码
markup::define! {
    Attributes(id: u32, category: String, data: std::collections::BTreeMap<String, String>) {
        // 一个带有id和两个类的div。
        // 注意:从Rust 2021开始,元素名称和 `#` 之间必须有一个空格,
        // 因为保留语法 (https://doc.rust-lang.org/edition-guide/rust-2021/reserving-syntax.html)
        div #foo.bar.baz {}
        '\n'
        // 一个带有动态计算的id以及一个静态和一个动态类的div。
        div #{format!("post-{}", id)}.post.{format!("category-{}", category)} {}
        '\n'

        // 布尔属性只有在为true时才会渲染。不指定值等同于 `true`。
        input[checked = true];
        '\n'
        input[checked = false];
        '\n'
        input[checked];
        '\n'

        // `Option` 属性只有在它们是 `Some` 时才会渲染。
        input[type = Some("text"), minlength = None::<String>];
        '\n'

        // 属性名也可以是用花括号包裹的表达式。
        div[{format!("{}{}", "data-", "post-id")} = id] {}
        '\n'

        // 可以使用 `..` 语法动态添加多个属性。
        div[..data.iter().map(|(k, v)| (("data-", k), v))] {}
    }
}
println!("{}", Attributes { id: 123, category: String::from("tutorial"), data: [ (String::from("foo"), String::from("bar")), (String::from("baz"), String::from("quux")) ].iter().cloned().collect(), }); ``` 输出
<div id="foo" class="bar baz"></div>
<div id="post-123" class="post category-tutorial"></div>
<input checked>
<input>
<input checked>
<input type="text">
<div data-post-id="123"></div>
<div data-baz="quux" data-foo="bar"></div>

@if 和 @if let

@if@if let 的工作方式类似于 Rust。

代码
markup::define! {
    If(x: u32, y: Option<u32>) {
        @if *x == 1 {
            "x = 1\n"
        } else if *x == 2 {
            "x = 2\n"
        } else {
            "x 既不是 1 也不是 2\n"
        }

        @if let Some(y) = y {
            "y = " @y "\n"
        } else {
            "y 是 None\n"
        }
    }
}

println!("{}", If { x: 2, y: Some(2) });
println!("{}", If { x: 3, y: None });
输出
x = 2
y = 2

x 既不是 1 也不是 2
y 是 None

@match

@match 的工作方式类似于 Rust,但分支必须用大括号括起来。

代码
markup::define! {
    Match(x: Option<u32>) {
        @match x {
            Some(1) | Some(2) => {
                "x 是 1 或 2"
            }
            Some(x) if *x == 3 => {
                "x 是 3"
            }
            None => {
                "x 是 None"
            }
            _ => {
                "x 是其他值"
            }
        }
    }
}

println!("{}", Match { x: None });
println!("{}", Match { x: Some(2) });
println!("{}", Match { x: Some(4) });
输出
x 是 None
x 是 1 或 2
x 是其他值

@for

@for 的工作方式类似于 Rust。

代码
markup::define! {
    For<'a>(xs: &'a [u32]) {
        @for (i, x) in xs.iter().enumerate() {
            @i ": " @x "\n"
        }
    }
}

println!("{}", For { xs: &[1, 2, 4, 8] });
输出
0: 1
1: 2
2: 4
3: 8

语句

模板可以包含以 @ 符号开头的语句。最常用的是 @let 语句,用于计算一个值以供后续重复使用。@fn 可用于定义函数。此外还支持 @struct@mod@impl@const@static 等。

代码
markup::define! {
    Statement(x: i32) {
        @let double_x = x * 2;
        @double_x '\n'

        @fn triple(x: i32) -> i32 { x * 3 }
        @triple(*x)
    }
}

println!("{}", Statement { x: 2 });
输出
4
6
项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

白日梦AI

白日梦AI提供专注于AI视频生成的多样化功能,包括文生视频、动态画面和形象生成等,帮助用户快速上手,创造专业级内容。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

讯飞绘镜

讯飞绘镜是一个支持从创意到完整视频创作的智能平台,用户可以快速生成视频素材并创作独特的音乐视频和故事。平台提供多样化的主题和精选作品,帮助用户探索创意灵感。

Project Cover

讯飞文书

讯飞文书依托讯飞星火大模型,为文书写作者提供从素材筹备到稿件撰写及审稿的全程支持。通过录音智记和以稿写稿等功能,满足事务性工作的高频需求,帮助撰稿人节省精力,提高效率,优化工作与生活。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号