48 releases (30 stable)

4.0.1 Jul 3, 2024
3.1.5 Apr 13, 2024
3.1.3 Mar 21, 2024
3.0.0 Dec 19, 2023
0.2.0 Jun 8, 2020

#5 in Template engine

Download history 3355/week @ 2024-08-02 3165/week @ 2024-08-09 2861/week @ 2024-08-16 2991/week @ 2024-08-23 2467/week @ 2024-08-30 3995/week @ 2024-09-06 3088/week @ 2024-09-13 3561/week @ 2024-09-20 4153/week @ 2024-09-27 3836/week @ 2024-10-04 3980/week @ 2024-10-11 3101/week @ 2024-10-18 4083/week @ 2024-10-25 3496/week @ 2024-11-01 6100/week @ 2024-11-08 3920/week @ 2024-11-15

18,131 downloads per month
Used in 6 crates

MIT license

610KB
16K SLoC

MRML

Crates.io Crates.io FOSSA Status

.github/workflows/main.yml codecov

Average time to resolve an issue Percentage of issues still open Maintainability

Introduction

This project is a reimplementation of the nice MJML markup language in Rust.

How to use it in my code

Update your cargo.toml:

[dependencies]
mrml = "2"
serde = { version = "1.0", features = ["derive"] }

Create your main.rs:

use mrml;

fn main() {
    let root = mrml::parse("<mjml><mj-body></mj-body></mjml>").expect("parse template");
    let opts = mrml::prelude::render::Options::default();
    match root.render(&opts) {
        Ok(content) => println!("{}", content),
        Err(_) => println!("couldn't render mjml template"),
    };
}

Available options are:

Name Comment Default value
disable_comments Strip comments out of rendered HTML false
social_icon_origin Custom URL for fetching social icons None
fonts Default fonts imported in the HTML rendered by MJML See default options

Why?

  • A Node.js server rendering an MJML template takes around 20 MB of RAM at startup and 130 MB under stress test. In Rust, less than 1.7 MB at startup and a bit less that 3 MB under stress test. The Rust version can also handle twice as many requests per second. You can perform the benchmarks by running bash script/run-bench.sh.
  • The JavaScript implementation cannot be run in the browser; the Rust one (and WebAssembly one) can be.

You want to contribute?

Feel free to read our contributing section and the code of conduct.

Performance

With the same Linux amd64 machine, to render the amario template

  • Node: 606.59ms
  • Rust: 3.48ms

Missing implementations

  • mj-style[inline]: not yet implemented. It requires parsing the generated html to apply the inline styles afterward (that's how it's done in mjml) which would kill the performances. Applying it at render time would improve the performance but it would still require to parse the CSS.
  • mj-include: not yet implemented. It requires to handle loading remote templates when using mrml in a wasm (browser or server side) format, which implies being able to load from a different location (file://, https://, relative, etc).

Who is using MRML?

If you are using MRML and want to be added to this list, don't hesitate to create an issue or open a pull request.

What is using MRML?

mjml_nif - Elixir library

mrml-ruby - Ruby library

mjml-python - Python library

If you are using MRML and want to be added to this list, don't hesitate to create an issue or open a pull request.

You want to sponsor us?

Buy Me A Coffee

Thanks to zachzurn.

License

FOSSA Status

Dependencies

~1–12MB
~131K SLoC