#html-macro #syntax #yew #replace #editor-friendly #rust-idiomatic

macro defy

Replacement for the yew::html! macro with more Rust-idiomatic, editor-friendly syntax

6 releases

0.1.5 Apr 14, 2023
0.1.4 Mar 19, 2023
0.1.2 Feb 26, 2023

#249 in Value formatting

Apache-2.0

24KB
480 lines

defy

GitHub actions crates.io crates.io docs.rs GitHub GitHub

Replacement for the yew::html! macro with more Rust-idiomatic, editor-friendly syntax.

The syntax used in this crate is largely inspired by kotlinx.html and horrorshow.

Example

use defy::defy;

struct Datum {
    field:   &'static str,
    display: bool,
    label:   Label,
}
enum Label {
    First(i32),
    Second(u64),
}
let data = vec![
    Datum { field: "foo", display: false, label: Label::First(1) },
    Datum { field: "bar", display: true, label: Label::Second(2) },
];

let vnode = defy! {
    h1 {
        + "Hello world";
    }
    ul {
        for datum in data {
            let field = datum.field;
            if datum.display {
                li(data-length = field.len().to_string()) {
                    + field;
                }
            }
            match datum.label {
                Label::First(i) if i > 3 => {
                    h2 { +i; }
                }
                Label::Second(i) => {
                    h3 { +i; }
                }
                _ => { +"unmatched"; }
            }
        }
    }
};

// Rendering code omitted
assert_eq!(
    vnode_html.as_str().replace(['\n', ' '], ""),
    r#"
        <h1>Hello world</h1>
        <ul>
            unmatched
            <li data-length="3">bar</li>
            <h3>2</h3>
        </ul>
    "#
    .replace(['\n', ' '], "")
);

Why invent another syntax?

Yew already provides several editor plugins to help make editors treat html! blocks as HTML syntax. However the editor covergae is not complete, and interacts weirdly with normal Rust syntax. defy uses a syntax that resembles the normal Rust syntax (a similar idea as ron) and provides better syntactic sugar for constructs like for loops.

Dependencies

~245–690KB
~16K SLoC