#markup #template #html

macro sailfish-macros

Simple, small, and extremely fast template engine for Rust

16 unstable releases (3 breaking)

0.3.3 Apr 6, 2021
0.3.2 Mar 28, 2021
0.3.1 Jan 23, 2021
0.3.0 Dec 20, 2020
0.2.0 Jul 16, 2020

#16 in #markup

Download history 67/week @ 2020-12-29 262/week @ 2021-01-05 56/week @ 2021-01-12 131/week @ 2021-01-19 86/week @ 2021-01-26 60/week @ 2021-02-02 109/week @ 2021-02-09 169/week @ 2021-02-16 48/week @ 2021-02-23 50/week @ 2021-03-02 48/week @ 2021-03-09 61/week @ 2021-03-16 169/week @ 2021-03-23 177/week @ 2021-03-30 258/week @ 2021-04-06 390/week @ 2021-04-13

438 downloads per month
Used in sailfish

MIT license

71KB
2K SLoC

SailFish

Simple, small, and extremely fast template engine for Rust

Tests Version Dependency counts 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.3.3"

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 issue 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.5–1MB
~24K SLoC