mstch/README.md

# mstch - {{mustache}} templates in C++11 

mstch is a complete implementation of [{{mustache}}](http://mustache.github.io/) templates using modern C++.
[![Build Status](https://travis-ci.org/no1msd/mstch.svg?branch=master)](https://travis-ci.org/no1msd/mstch)

## Basic usage

```c++
#include <iostream>

#include <mstch/mstch.hpp>

int main() {
  std::string view{"{{#names}}Hi {{name}}!\n{{/names}}"};
  mstch::map context{
    {"names", mstch::array{
      mstch::map{{"name", std::string{"Chris"}},
      mstch::map{{"name", std::string{"Mark"}},
      mstch::map{{"name", std::string{"Scott"}},
    }
  };
  
  std::cout << mstch::render(view, context) << std::endl;
  
  return 0;
}

```

The output of this example will be:

```
Hi chris!
Hi mark!
Hi scott!
```

## Requirements

 - A C++ compiler with decent C++11 support. Currently only tested with GCC 4.9.
 - Boost 1.54
 - CMake for building

## Building

From the root of the source tree:

```bash
 $ mkdir build
 $ cd build
 $ cmake ..
 $ make
```

Building with unit tests:

```bash
 $ mkdir build
 $ cd build
 $ cmake -DWITH_UNIT_TESTS=ON ..
 $ make
 $ make test
```

### Advanced usage

TODO