# CrabTML: A Rust-based Template Engine

CrabTML is a lightweight and flexible template engine written in Rust. It provides a simple yet powerful way to render dynamic content in your applications.

> [!WARNING]  
> This project is still in early development and is not recommended for production use.

## Features

- Variable interpolation
- Conditional rendering
- Loop constructs
- Nested object access
- File-based and string-based template loading
- Easy-to-use API

## Installation

Add this to your `Cargo.toml`:

```toml
[dependencies]
crabtml = "0.1.0"
```

## Usage

Here's a quick example of how to use CrabTML:

```rust
use crabtml::{TemplateEngine, Value, Context};
use std::collections::HashMap;

fn main() {
    let mut engine = TemplateEngine::new();
    
    // Load a template from a string
    engine.add_template_from_string("example", "hello {{ text }}").unwrap();
    
    // Create a context
    let mut context = Context::new();
    context.set(
        "text",
        "darkness my old friend",
    );
    
    // Render the template
    let result = engine.render("example", &mut context).unwrap();
    println!("{}", result); // -> hello darkness my old friend


    // You can also create a context using the `context!` macro,
    // and objects using the `object!` macro
    use crabtml::{context, object};

    let mut context = context! {
        "text" => "darkness my old friend",
        "user" => object! {
            "name" => "trav",
            "age" => 35,
        },
    };
}
```

For more detailed examples, check the `tests` module in the [source code](https://github.com/trvswgnr/crabtml/blob/main/src/lib.rs#L455).

## Template Syntax

CrabTML supports the following syntax:

- Variables: `{{ variable_name }}`
- Conditionals: `{% if condition %} ... {% else %} ... {% endif %}`
- Loops: `{% for item in items %} ... {% endfor %}`
- Nested object access: `{{ user.name }}`

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

This project is licensed under the MIT License - see the LICENSE file for details.