A simple Mustache parser/evaluator for Swift

What's New

1.0.0 Finally Final


This is good stuff, can be tagged 1.0.0 I think :-)


Swift3 Swift4 Swift5 macOS tuxOS Travis

A simple Mustache parser/evaluator for Swift.

Mustache is a very simple templating language. Implementations are available for pretty much any programming language (check the Mustache website) - this is one for Swift.

In the context of you don't need to call this manually, but you can just use the Mustache template support in the Express module. Checkout the express-simple app as an example on how to do this.

This Mustache implementation comes with a very simple Key-Value coding implementation, which is used to extract values from model objects for rendering. With that you can render both, generic Dictionary/Array structures as well as Swift objects with properties. Since the reflection capabilities of Swift are pretty limited, so is the KVC implementation.


Sample Mustache:

Hello {{name}}
You have just won {{& value}} dollars!
  Well, {{{taxed_value}}} dollars, after taxes.
  Has address in: {{city}}
  Has NO addresses

The template features value access: {{name}}, conditionals: {{#in_ca}}, as well as repetitions: {{#addresses}}.

Sample code to parse and evaluate the template:

let sampleDict  : [ String : Any ] = [
  "name"        : "Chris",
  "value"       : 10000,
  "taxed_value" : Int(10000 - (10000 * 0.4)),
  "in_ca"       : true,
  "addresses"   : [
    [ "city"    : "Cupertino" ]

let parser = MustacheParser()
let tree   = parser.parse(string: template)
let result = tree.render(object: sampleDict)

You get the idea.

Swift 5 Dynamic Callable

In Swift 5 you can expose Mustache templates as regular Swift functions.

To declare a Mustache backed function:

let generateHTMLForWinner = Mustache(
      {% raw %}Hello {{name}}
      You have just won {{& value}} dollars!
        Well, {{{taxed_value}}} dollars, after taxes.
        Has address in: {{city}}
        Has NO addresses
      {{/addresses}}{% endraw %}

To call the function:

let winners = [
        name: "Chris", value: 10000,
        taxed_value: 6000, in_ca: true,
        addresses: [[ "city": "Cupertino" ]]
        name: "Michael", value: 6000,
        taxed_value: 6000, in_ca: false,
        addresses: [[ "city": "Austin" ]]

Checkout our blog for more info on this.


mustache is brought to you by The Always Right Institute and ZeeZide. We like feedback, GitHub stars, cool contract work, presumably any form of praise you can think of. We don't like people who are wrong.

Ask questions on the Slack.


  • Swift Tools 5.0.0
View More Packages from this Author


  • None
Last updated: Sun Jan 14 2024 08:55:55 GMT-1000 (Hawaii-Aleutian Standard Time)