Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jdrouet/mrml
Implementation of mjml in rust
https://github.com/jdrouet/mrml
email hacktoberfest mjml rust
Last synced: 7 days ago
JSON representation
Implementation of mjml in rust
- Host: GitHub
- URL: https://github.com/jdrouet/mrml
- Owner: jdrouet
- License: mit
- Created: 2020-05-11T13:03:55.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-12-23T08:08:53.000Z (about 1 month ago)
- Last Synced: 2024-12-24T09:17:22.215Z (about 1 month ago)
- Topics: email, hacktoberfest, mjml, rust
- Language: HTML
- Homepage:
- Size: 3.19 MB
- Stars: 367
- Watchers: 5
- Forks: 23
- Open Issues: 22
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
- Contributing: contributing.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: code-of-conduct.md
Awesome Lists containing this project
- awesome-rust - jdrouet/mrml - A library to generate nice email templates working on any mail client. (Libraries / Email)
- awesome-rust-cn - jdrouet/mrml - ci.com/jdrouet/mrml.svg?branch=master)](https://travis-ci.org/jdrouet/mrml) (库 Libraries / 电子邮件 Email)
- awesome-alternatives-in-rust - mrml - Blazing fast reimplementation of mjml in Rust (~200x faster) (Libraries / Email)
- awesome-rust - jdrouet/mrml - A library to generate nice email templates working on any mail client. (Libraries / Email)
- jimsghstars - jdrouet/mrml - Implementation of mjml in rust (HTML)
- fucking-awesome-rust - jdrouet/mrml - A library to generate nice email templates working on any mail client. (Libraries / Email)
- fucking-awesome-rust - jdrouet/mrml - A library to generate nice email templates working on any mail client. (Libraries / Email)
README
# MRML
[](https://crates.io/crates/mrml)
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fjdrouet%2Fmrml?ref=badge_shield)
[](https://github.com/jdrouet/mrml/actions/workflows/mrml-core-main.yml)
[](https://codecov.io/gh/jdrouet/mrml)
[](http://isitmaintained.com/project/jdrouet/mrml "Average time to resolve an issue")
[](http://isitmaintained.com/project/jdrouet/mrml "Percentage of issues still open")
[](https://codeclimate.com/github/jdrouet/mrml/maintainability)
## Introduction
This project is a reimplementation of the nice [MJML markup language](https://documentation.mjml.io/) in Rust.
## How to use it in my code
Update your `cargo.toml`:
```toml
[dependencies]
mrml = "3"
serde = { version = "1.0", features = ["derive"] }
```
Create your `main.rs`:
```rust
use mrml::prelude::parser::http_loader::{HttpIncludeLoader, BlockingReqwestFetcher};
use mrml::prelude::parser::ParserOptions;
use mrml::prelude::render::RenderOptions;
use std::collections::HashSet;
fn main() {
let resolver = HttpIncludeLoader::::new_allow(HashSet::from(["http://localhost".to_string()]));
let parser_options = ParserOptions {
include_loader: Box::new(resolver),
};
let render_options = RenderOptions::default();
let template = r#"
"#;
match mrml::parse_with_options(template, &parser_options) {
Ok(mjml) => match mjml.render(&render_options) {
Ok(html) => println!("{html}"),
Err(err) => eprintln!("Couldn't render template: {err:?}"),
},
Err(err) => eprintln!("Couldn't parse template: {err:?}"),
}
}
```
It's also possible to use an async include loader
```rust
use mrml::mj_include::body::MjIncludeBodyKind;
use mrml::prelude::parser::http_loader::{AsyncReqwestFetcher, HttpIncludeLoader};
use mrml::prelude::parser::local_loader::LocalIncludeLoader;
use mrml::prelude::parser::memory_loader::MemoryIncludeLoader;
use mrml::prelude::parser::multi_loader::{MultiIncludeLoader, MultiIncludeLoaderItem, MultiIncludeLoaderFilter};
use mrml::prelude::parser::noop_loader::NoopIncludeLoader;
use mrml::prelude::parser::loader::AsyncIncludeLoader;
use mrml::prelude::parser::AsyncParserOptions;
use mrml::prelude::render::RenderOptions;
#[tokio::main]
async fn main() {
let resolver = MultiIncludeLoader::>::new()
.with_starts_with("file://", Box::new(LocalIncludeLoader::new(PathBuf::default().join("resources").join("compare").join("success"))))
.with_starts_with("https://", Box::new(HttpIncludeLoader::::allow_all()))
.with_any(Box::::default());
let parser_options = AsyncParserOptions {
include_loader: Box::new(resolver),
};
let render_options = RenderOptions::default();
let json = r#"
"#;
match mrml::async_parse_with_options(json, std::sync::Arc::new(parser_options)).await {
Ok(mjml) => match mjml.render(&render_options) {
Ok(html) => println!("{html}"),
Err(err) => eprintln!("Couldn't render template: {err:?}"),
},
Err(err) => eprintln!("Couldn't parse template: {err:?}"),
}
}
```
## 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 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](./contributing.md) section and the [code of conduct](./code-of-conduct.md).
## Performance
With the same Linux amd64 machine, to render the amario template using [hyperfine](https://github.com/sharkdp/hyperfine) (see the script in the `benchmarks` folder).
```
Benchmark 1: mjml /amario.mjml
Time (mean ± σ): 634.1 ms ± 5.2 ms [User: 669.3 ms, System: 168.2 ms]
Range (min … max): 625.8 ms … 642.3 ms 10 runs
Benchmark 2: /usr/bin/mrml /amario.mjml render
Time (mean ± σ): 5.6 ms ± 0.1 ms [User: 2.8 ms, System: 2.9 ms]
Range (min … max): 5.5 ms … 7.1 ms 494 runs
Summary
/usr/bin/mrml /amario.mjml render ran
112.83 ± 2.12 times faster than mjml /amario.mjml
```
From this, you can see that `mrml` is **more than 110 faster** than `mjml`.
## 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.
## Who is using MRML?
[
](https://www.blizzfull.com/)
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](https://github.com/adoptoposs/mjml_nif) - Elixir library
[mrml-ruby](https://github.com/hardpixel/mrml-ruby) - Ruby library
[mjml-python](https://github.com/mgd020/mjml-python) - Python library
[wagtail-newsletter](https://github.com/wagtail/wagtail-newsletter) - Wagtail extension
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.
## License
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fjdrouet%2Fmrml?ref=badge_large)