# Handlebars Switch Helper

[![Latest Version](https://img.shields.io/crates/v/handlebars_switch.svg)](https://crates.io/crates/handlebars_switch)
[![Downloads](https://img.shields.io/crates/d/handlebars_switch.svg)](https://crates.io/crates/handlebars_switch)
[![License](https://img.shields.io/github/license/nickjer/handlebars_switch.svg)](https://github.com/nickjer/handlebars_switch)
[![Docs](https://docs.rs/handlebars_switch/badge.svg)](https://docs.rs/handlebars_switch/)

This provides a [Handlebars](http://handlebarsjs.com/) `{{#switch}}` helper to
the already incredible [handlebars-rust](https://github.com/sunng87/handlebars-rust)
crate.

Links of interest:

- [Documentation](https://docs.rs/handlebars_switch)
- [handlebars-rust](https://github.com/sunng87/handlebars-rust)
- [Handlebars](http://handlebarsjs.com)

## Quick Start

You can easily add the ``{{#switch}}`` helper to a rust Handlebars object using
the `Handlebars#register_helper` method:

```rust
use handlebars::Handlebars;
use handlebars_switch::SwitchHelper;

let mut handlebars = Handlebars::new();
handlebars.register_helper("switch", Box::new(SwitchHelper));
```

### Example

Below is an example that renders a different page depending on the user's
access level:


```rust
extern crate handlebars_switch;
extern crate handlebars;
#[macro_use] extern crate serde_json;

use handlebars::Handlebars;
use handlebars_switch::SwitchHelper;

fn main() {
  let mut handlebars = Handlebars::new();
  handlebars.register_helper("switch", Box::new(SwitchHelper));

  let tpl = "\
      {{#switch access}}\
          {{#case \"admin\"}}Admin{{/case}}\
          {{#default}}User{{/default}}\
      {{/switch}}\
  ";

  assert_eq!(
      handlebars.template_render(tpl, &json!({"access": "admin"})).unwrap(),
      "Admin"
  );

  assert_eq!(
      handlebars.template_render(tpl, &json!({"access": "nobody"})).unwrap(),
      "User"
  );
}
```