#markup #template #html

macro sailfish-macros

Simple, small, and extremely fast template engine for Rust

20 releases

0.6.0 Jan 24, 2023
0.5.0 Oct 25, 2022
0.4.0 Mar 10, 2022
0.3.3 Apr 6, 2021
0.2.0 Jul 16, 2020

#170 in Template engine

Download history 447/week @ 2022-10-13 433/week @ 2022-10-20 510/week @ 2022-10-27 604/week @ 2022-11-03 593/week @ 2022-11-10 498/week @ 2022-11-17 419/week @ 2022-11-24 369/week @ 2022-12-01 515/week @ 2022-12-08 242/week @ 2022-12-15 280/week @ 2022-12-22 357/week @ 2022-12-29 395/week @ 2023-01-05 360/week @ 2023-01-12 519/week @ 2023-01-19 462/week @ 2023-01-26

1,799 downloads per month
Used in sailfish

MIT license

80KB
2K SLoC

SailFish

Simple, small, and extremely fast template engine for Rust

Tests Version dependency status Rust 1.42 License: MIT

User Guide | API Docs | Examples

✨ Features

  • Simple and intuitive syntax inspired by EJS
  • Include another template file inside template
  • Built-in filters
  • Minimal dependencies (<15 crates in total)
  • Extremely fast (See benchmarks)
  • Better error message
  • Syntax highlighting support (vscode, vim)
  • Works on Rust 1.42 or later

🐟 Example

Dependencies:

[dependencies]
sailfish = "0.6.0"

Template file (templates/hello.stpl):

<html>
  <body>
    <% for msg in &messages { %>
      <div><%= msg %></div>
    <% } %>
  </body>
</html>

Code:

use sailfish::TemplateOnce;

#[derive(TemplateOnce)]
#[template(path = "hello.stpl")]
struct HelloTemplate {
    messages: Vec<String>
}

fn main() {
    let ctx = HelloTemplate {
        messages: vec![String::from("foo"), String::from("bar")],
    };
    println!("{}", ctx.render_once().unwrap());
}

You can find more examples in examples directory.

🐾 Roadmap

  • Template trait (RFC)
  • Template inheritance (block, partials, etc.)

👤 Author

🇯🇵 Ryohei Machida

🤝 Contributing

Contributions, issues and feature requests are welcome!

Since sailfish is an immature library, there are many planned features that is on a stage of RFC. Please leave a comment if you have an idea about its design!

Also I welcome any pull requests to improve sailfish! Find issues with Status: PR Welcome label, and let's create a new pull request!

Show your support

Give a ⭐️ if this project helped you!

📝 License

Copyright © 2020 Ryohei Machida.

This project is MIT licensed.


This README was generated with ❤️ by readme-md-generator

Dependencies

~0.4–5MB
~80K SLoC