# html-builder
This crate helps you generate HTML.
```rust
let mut buf = Buffer::new(); // Contents added to buffer by each statement:
let mut html = buf.html().attr("lang='en'"); //
writeln!(html.head().title(), "Title!")?; // Title!
writeln!(html.body().h1(), "Header!")?; // Header!
buf.finish(); //
```
* It automatically closes your tags for you. This guarantees the output
will be well-formed. It also makes your code nicer - closing tags by hand
is a drag.
* It also provides helper methods for all the valid HTML5 tags. You don't
have to use these, but if you do it makes sure you don't typo a tag name.
IMO it strikes a good balance of safety to simplicity/flexibility.
It's by no means built for performance, but nevertheless the performance
is OK I think. The benchmark generates a small (20-line) HTML document.
On my laptop it runs in 2µs. Run `cargo bench` to check for yourself.
There are high quality templating libraries out there, such as [askama],
but personally I don't like templates. [typed-html] is closer to what I
want, and it aims for a high level of type safety (eg. it forbids div-level
elements inside span-level elements). This is great in theory, but I found
working with it was too complex. This crate is much simpler by comparison,
at the expense of not catching as many bugs. The design is inspired by
Haskell's HTML combinator libraries such as [blaze-html] and [lucid].
[lucid]: https://hackage.haskell.org/package/lucid
[blaze-html]: https://hackage.haskell.org/package/blaze-html
[askama]: https://docs.rs/askama
[typed-html]: https://docs.rs/typed-html/