Swiftache

A Mustache template renderer for iOS (and OS X soon) implemented in pure Swift.

Installation

In Xcode, create a workspace for your project if it doesn't have one already. Add the Swiftache project to the workspace, then link your project with the Swiftache framework.

Usage

String input, string output:

let stache = Swiftache()
if stache.render("A{{#a}}{{b}}{{/a}}C", context: ["a": true, "b": "B"]) {
    println(stache.target!.text) // ABC
}

File input, string output:

let inUrl = NSURL(fileURLWithPath: "path/to/infile") // "A{{#a}}{{b}}{{/a}}C"
let stache = Swiftache()
if stache.render(inUrl, context: ["a": true, "b": "B"]) {
    println(stache.target!.text) // ABC
}

String input, file output:

let outUrl = NSURL(fileURLWithPath: "path/to/file")
let stache = Swiftache()
if stache.render("A{{#a}}{{b}}{{/a}}C",
                 context: ["a": true, "b": "B"],
                 target: FileRenderTarget(fileURL: outUrl)) {
    println(stache.target!.text) // ABC
}

File input, file output:

let inUrl = NSURL(fileURLWithPath: "path/to/infile") // "A{{#a}}{{b}}{{/a}}C"
let outUrl = NSURL(fileURLWithPath: "path/to/outfile")
let stache = Swiftache()
if stache.render(inUrl,
                 context: ["a": true, "b": "B"],
                 target: FileRenderTarget(fileURL: outUrl)) {
    println(stache.target!.text) // ABC
}

Lambda usage:

let stache = Swiftache()
let lowerABC: Lambda = { (text, render) -> String in
    return "a" + render(text).lowercaseString + "c"
}
if stache.render("{{#a}}{{b}}{{/a}}", context: ["a": lowerABC, "b": "B"]) {
    println(stache.target!.text) // abc
}

ToDo

• Implement a "proper" scanner instead of a regex based one. Not really necessary, more a performance experiment.
• Content of static text tokens are read entirely into memory when rendered to a target. There should be a maximum read length to keep memory usage low.

Contact

Twitter: @BjornRuud

License

Swiftache is licensed under the MIT License (MIT).