Hiccup

A Clojure's Hiccup inspired macro. At the moment support for inline code execution is not guaranteed. The main objective of this lib is to prevent unclosed html tags.

Basic elements:

The macro hiccup! receives a mutable string as the first argument and mutates the string to emit the HTML. The order of the elements is: 1.tagas the first element. 2. Optional attribute inside the tag should follow the tag name as{attribute1=>"value1 value2 ... valuen", attr=>"value"}. Also, the attributes should be inside{...}and separate each key value pair by,. The element should be written askey=>"value", where key is a symbol, followed by an arrow (=>), and then the value as a string"value". 3. After (Optional) the tag name or the attributes{...}you could include[...]that can have other tags, such asp["text"]or regular string values. 4. Inside the[...]you also can substitute your string for some simple rust code inside a(...). This can bem something likep[format!("{:?}", 3 + 4)]ordiv[(x)]` where x was defined in the outside.

Differences between Clojure and Rust Hiccup:

Clojure: [:a {:href "http://github.com"} "GitHub"]
Rust: a{href=>"http://github.com"}["GitHub"]

Usage

Add dependency to Cargo.toml:

toml [dependencies] hiccup = "0.1.6"

Code example with hiccup! macro:

```rust use hiccup::hiccup;

fn main() { let mut html = String::new();

let _ = hiccup!(&mut html,
    html[
        head[meta{name=>"author", content=>"Julia Naomi"}
            title["Hiccup guide"]]
        body{class=>"amazing hiccup guide"}[
            h1{font=>"bold", color=>"red"}["Hiccup is the best!"]
            p["please lookup clojure's hiccup for better ideas on this macro"]]
    ]);

assert_eq!(html,"<html><head><meta name=\"author\" content=\"Julia Naomi\"/>\
<title>Hiccup guide</title></head><body class=\"amazing hiccup guide\">\
<h1 font=\"bold\" color=\"red\">Hiccup is the best!</h1>\
<p>please lookup clojure\'s hiccup for better ideas on this macro</p></body></html>");

} ```

With remote code execution:

```rust let mut htmlinner = String::new(); let mut htmlouter = String::new(); let x = "inner my str"; let y = "my str2"; let z = "my str3";

let _ = hiccup!(&mut html_inner, div[ div{hello=>"inner world"}[(x)] ] );

let _ = hiccup!(&mut htmlouter, html[ body{class=>"amazing hiccup guide"}[ p["please lookup clojure's hiccup for better ideas on this macro"] div[ div{hello=>"world"}[(htmlinner)] div[(y.to_owned() + " " + z)] p["bye"] ] ] ]);

asserteq!(htmlouter,"\

please lookup clojure\'s hiccup for better ideas on this macro

inner my str

my str2 my str3

bye

"); ```

Contribution

Add the feature you included in the macro as the name of the PR with tests

Thanks to

@otaviopace