Discussion

Its default value comes from the configuration of the source template repository. Unless specified, it contains the GRMustache standard library.

Discussion

All templates belong a template repository:

• Templates returned by [GRMustacheTemplate templateFromString:error:] have a template repository that loads templates and partials stored as resources in the main bundle, with extension “.mustache”, encoded in UTF8.

• Templates returned by [GRMustacheTemplate templateFromContentsOfFile:error:] have a template repository that loads templates and partials stored in the directory of the receiver, with the same file extension “.mustache”, encoded in UTF8.

• Templates returned by [GRMustacheTemplate templateFromContentsOfURL:error:] have a template repository that loads templates and partials stored in the directory of the receiver, with the same file extension “.mustache”, encoded in UTF8.

• Templates returned by [GRMustacheTemplate templateFromResource:bundle:error:] have a template repository that loads templates and partials stored as resources in the specified bundle, with extension “.mustache”, encoded in UTF8.

• Templates returned by [GRMustacheTemplateRepository templateNamed:error:] and [GRMustacheTemplateRepository templateFromString:error:] belong to the invoked repository.

Discussion

If you provide nil as a bundle, the resource will be looked in the main bundle, with a “mustache” extension.

The template resource must be encoded in UTF8. See the GRMustacheTemplateRepository class for more encoding options.

Discussion

The template at path must be encoded in UTF8. See the GRMustacheTemplateRepository class for more encoding options.

Discussion

The template at url must be encoded in UTF8. See the GRMustacheTemplateRepository class for more encoding options.

Discussion

If you provide nil as a bundle, the resource will be looked in the main bundle.

The template resource must be encoded in UTF8. See the GRMustacheTemplateRepository class for more encoding options.

Discussion

For example:

GRMustacheTemplate *template = [GRMustacheTemplate templateFromString:@"{{name}}" error:NULL];

// Have the `name` key defined for all renderings of the template:
id object = @{ @"name": @"Arthur" };
[template extendBaseContextWithObject:object];

// Renders "Arthur"

[template renderObject:nil error:NULL];

Keys defined by object can be overriden by other objects that will eventually enter the context stack:

// Renders "Billy", not "Arthur"
[template renderObject:@{ @"name": @"Billy" } error:NULL];

This method is a shortcut. It is equivalent to the following line of code:

template.baseContext = [template.baseContext contextByAddingObject:object];

Discussion

Keys defined by object are given priority, which means that they can not be overriden by other objects that will eventually enter the context stack.

For example:

GRMustacheTemplate *template = [GRMustacheTemplate templateFromString:@"{{precious}}" error:NULL];

// The `precious` key is given priority:
id object = @{ @"precious": @"gold" };
[template extendBaseContextWithProtectedObject:object];

// Renders "gold", not "lead".
[template renderObject:@{ @"precious": @"lead" } error:NULL];

This method is a shortcut. It is equivalent to the following line of code:

template.baseContext = [template.baseContext contextByAddingProtectedObject:object];

Discussion

This method is a shortcut. It is equivalent to the following line of code:

template.baseContext = [template.baseContext contextByAddingTagDelegate:tagDelegate];