# mustache 0.2.4
Mustache template library
## Installing
```
export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir
flutter pub add 'mustache:0.2.4'
```
Published: 2015-10-28T08:55:45.615Z
Expected archive SHA-256: fd3454529bb00ae26dcaffffcdc07c30742e78a802185b519150d05fa06f5f46
Available in cache; verification: upstream_checksum
## Direct dependencies
## Package README (untrusted upstream documentation)
# Mustache templates
A Dart library to parse and render [mustache templates](https://mustache.github.io/).
[](https://travis-ci.org/xxgreg/mustache) [](https://coveralls.io/r/xxgreg/mustache)
See the [mustache manual](http://mustache.github.com/mustache.5.html) for detailed usage information.
This library passes all [mustache specification](https://github.com/mustache/spec/tree/master/specs) tests.
## Example usage
```dart
import 'package:mustache/mustache.dart';
main() {
var source = '''
{{# names }}
{{ lastname }}, {{ firstname }}
{{/ names }}
{{^ names }}
No names.
{{/ names }}
{{! I am a comment. }}
''';
var template = new Template(source, name: 'template-filename.html');
var output = template.renderString({'names': [
{'firstname': 'Greg', 'lastname': 'Lowe'},
{'firstname': 'Bob', 'lastname': 'Johnson'}
]});
print(output);
}
```
A template is parsed when it is created, after parsing it can be rendered any number of times with different values. A TemplateException is thrown if there is a problem parsing or rendering the template.
The Template contstructor allows passing a name, this name will be used in error messages. When working with a number of templates, it is important to pass a name so that the error messages specify which template caused the error.
By default all output from `{{variable}}` tags is html escaped, this behaviour can be changed by passing htmlEscapeValues : false to the Template constructor. You can also use a `{{{triple mustache}}}` tag, or a unescaped variable tag `{{&unescaped}}`, the output from these tags is not escaped.
## Dart2js
This library uses mirrors. When compiling with dart2js you will need to pass the experimental mirrors flag. You also need to mark any objects which will be rendered with the @mustache annotation. There is also another version of this library available which doesn't use mirrors.
## Differences between strict mode and lenient mode.
### Strict mode (default)
* Tag names may only contain the characters a-z, A-Z, 0-9, underscore, period and minus. Other characters in tags will cause a TemplateException to be thrown during parsing.
* During rendering, if no map key or object member which matches the tag name is found, then a TemplateException will be thrown.
### Lenient mode
* Tag names may use any characters.
* During rendering, if no map key or object member which matches the tag name is found, then silently ignore and output nothing.
## Nested paths
```dart
var t = new Template('{{ author.name }}');
var output = template.renderString({'author': {'name': 'Greg Lowe'}});
```
## Partials - example usage
```dart
var partial = new Template('{{ foo }}', name: 'partial');
var resolver = (String name) {
if (name == 'partial-name') { // Name of partial tag.
return partial;
}
};
var t = new Template('{{> partial-name }}', partialResolver: resolver);
var output = t.renderString({'foo': 'bar'}); // bar
```
## Lambdas - example usage
```dart
var t = new Template('{{# foo }}');
var lambda = (_) => 'bar';
t.renderString({'foo': lambda}); // bar
```
```dart
var t = new Template('{{# foo }}hidden{{/ foo }}');
var lambda = (_) => 'shown'};
t.renderString({'foo': lambda); // shown
```
```dart
var t = new Template('{{# foo }}oi{{/ foo }}');
var lambda = (LambdaContext ctx) => '${ctx.renderString().toUpperCase()}';
t.renderString({'foo': lambda}); // OI
```
```dart
var t = new Template('{{# foo }}{{bar}}{{/ foo }}');
var lambda = (LambdaContext ctx) => '${ctx.renderString().toUpperCase()}';
t.renderString({'foo': lambda, 'bar': 'pub'}); // PUB
```
```dart
var t = new Template('{{# foo }}{{bar}}{{/ foo }}');
var lambda = (LambdaContext ctx) => '${ctx.renderString().toUpperCase()}';
t.renderString({'foo': lambda, 'bar': 'pub'}); // PUB
```
In the following example `LambdaContext.renderSource(source)` re-parses the source string in the current context, this is the default behaviour in many mustache implementations. Since re-parsing the content is slow, and often not required, this library makes this step optional.
```dart
var t = new Template('{{# foo }}{{bar}}{{/ foo }}');
var lambda = (LambdaContext ctx) => ctx.renderSource(ctx.source + ' {{cmd}}')};
t.renderString({'foo': lambda, 'bar': 'pub', 'cmd': 'build'}); // pub build
```
## Changelog
# CHANGELOG
## 0.2.4
* Fix #23 failure if tag or comment contains "="
## 0.2.3
* Change handling of lenient sections to match python mustache implementation.
## 0.2.2
* Fix MirrorsUsed tag for using mirrors on dart2js.
* Clean up dead code.
## 0.2.1
* Added new methods to LambdaContext.
## 0.2
* Deprecated parse() function - please update your code to use new Template(source).
* Deprecated MustacheFormatException - please update your code to use TemplateException.
* Breaking change: Template.render and Template.renderString methods no longer
take the optional lenient and htmlEscapeValues. These should now be passed to
the Template constructor.
* Fully passing all mustache spec tests.
* Added support for MirrorsUsed.
* Implemented partials. #11
* Implemented lambdas. #4
* Implemented change delimiter tag.
* Add template name parameter, and show this in error messages.
* Allow whitespace at begining of tags. #10