# Hust

Hust is an HTML-first way to embed Rust in HTML.

## This Crate

This crate is for using hust in your projects.

## Usage

Use a .hust file like so:

```
let result = include_hust!("test.hust");
```

Imagine your file looks like:
```
<h1>Hello, World!</h1>
<p>Hello from Hust!</p>
<%= variable_name %>
```

The file will be converted to rust code that looks like the below, which will be inserted in place where the macro is run.
```
let output_buffer = String::new();
output_buffer.push_str("<h1>Hello, World!</h1>\n\r<p>Hello from Hust!</p>\n\r");
output_buffer.push_str(variable_name);
output_buffer
```

This code is then inlined right where you called the macro.

## Example Hust

```
<h1>User</h1>
<div class="user">
  <%= &user.username %>
</div>
```

Or for more complex usage:

```
<h1>All Users</h1>
<div class="py-2">
  <%= &users.len().to_string() %> users found.
</div>
<% for user in users { %>
  <div class="user">
    <a href="/users/<%= &user.id.to_string() %>">
    <%= &user.username %>
    </a>
  </div>
<% } %>

<a href="/users/new" class="btn btn-primary">New User</a>
```

## Downsides / Drawbacks

Currently, it is impossible to debug. Due to the way macros work in Rust currently, any errors in your Hust code will be shown at `include_hust!` and not on the line of the file that actually caused the error. We are thinking of ways to improve this in the future.