Copyright	(c) Justus Adam, 2015
License	LGPL-3
Maintainer	development@justusadam.com
Stability	experimental
Portability	POSIX
Safe Haskell	None
Language	Haskell2010

Text.Mustache

Contents

Compiling
- Automatic
- Manually
Rendering

Description

How to use this library

This module exposes some of the most convenient functions for dealing with mustache templates.

The easiest way of compiling a file and its potential includes (called partials) is by using the compileTemplate function. @ -- the search space encompasses all directories in which the compiler should -- search for the template source files -- -- the search is conducted in order, from left to right. let searchSpace = [".", "./templates"] -- the templateName is the relative path of the template to any directory -- of the search space templateName = "main.mustache"

compiled <- automaticCompile searchSpace templateName case compiled of -- the compiler will throw errors if either the template is malformed -- or the source file for a partial could not be found Left err -> print err Right template -> return () -- this is where you can start using it @

Should your search space be only the current working directory, you can use localAutomaticCompile.

Synopsis

Compiling

Automatic

automaticCompile :: [FilePath] -> FilePath -> IO (Either ParseError Template) Source

Compiles a mustache template provided by name including the mentioned partials.

The same can be done manually using getFile, mustacheParser and getPartials.

This function also ensures each partial is only compiled once even though it may be included by other partials including itself.

A reference to the included template will be found in each including templates partials section.

localAutomaticCompile :: FilePath -> IO (Either ParseError Template) Source

Manually

compileTemplateWithCache :: [FilePath] -> TemplateCache -> FilePath -> IO (Either ParseError Template) Source

Compile a mustache template providing a list of precompiled templates that do not have to be recompiled.

parseTemplate :: String -> Text -> Either ParseError Template Source

data Template Source

A compiled Template with metadata.

Constructors

Template
Fields name :: String ast :: AST partials :: HashMap String Template

Instances

Show Template Source

Rendering

Generic

substitute :: ToMustache j => Template -> j -> Text Source

Substitutes all mustache defined tokens (or tags) for values found in the provided data structure.

Equivalent to substituteValue . toMustache.

Specialized

substituteValue :: Template -> Value -> Text Source

Substitutes all mustache defined tokens (or tags) for values found in the provided data structure.

Data Conversion

class ToMustache ω where Source

Conversion class

Methods

toMustache :: ω -> Value Source

Instances

ToMustache Bool Source
ToMustache Char Source
ToMustache () Source
ToMustache Scientific Source
ToMustache Text Source
ToMustache Value Source
ToMustache Text Source
ToMustache Value Source
ToMustache [Char] Source
ToMustache ω => ToMustache [ω] Source
ToMustache ω => ToMustache (Vector ω) Source
ToMustache (Context Value -> AST -> String) Source
ToMustache (Context Value -> AST -> Text) Source
ToMustache (Context Value -> AST -> AST) Source
ToMustache (AST -> String) Source
ToMustache (AST -> Text) Source
ToMustache (AST -> AST) Source
(ToMustache α, ToMustache β) => ToMustache (α, β) Source
ToMustache ω => ToMustache (HashMap Text ω) Source
(ToMustache α, ToMustache β, ToMustache γ) => ToMustache (α, β, γ) Source
(ToMustache α, ToMustache β, ToMustache γ, ToMustache δ) => ToMustache (α, β, γ, δ) Source
(ToMustache α, ToMustache β, ToMustache γ, ToMustache δ, ToMustache ε) => ToMustache (α, β, γ, δ, ε) Source
(ToMustache α, ToMustache β, ToMustache γ, ToMustache δ, ToMustache ε, ToMustache ζ) => ToMustache (α, β, γ, δ, ε, ζ) Source
(ToMustache α, ToMustache β, ToMustache γ, ToMustache δ, ToMustache ε, ToMustache ζ, ToMustache η) => ToMustache (α, β, γ, δ, ε, ζ, η) Source
(ToMustache α, ToMustache β, ToMustache γ, ToMustache δ, ToMustache ε, ToMustache ζ, ToMustache η, ToMustache θ) => ToMustache (α, β, γ, δ, ε, ζ, η, θ) Source

object :: [Pair] -> Value Source

Convenience function for creating Object values.

This function is supposed to be used in conjuction with the ~> and ~= operators.

Examples

  data Address = Address { ... }

  instance Address ToJSON where
    ...

  data Person = Person { name :: String, address :: Address }

  instance ToMustache Person where
    toMustache (Person { name, address }) = object
      [ "name" ~> name
      , "address" ~= address
      ]

Here we can see that we can use the ~> operator for values that have themselves a ToMustache instance, or alternatively if they lack such an instance but provide an instance for the ToJSON typeclass we can use the ~= operator.

(~>) :: ToMustache ω => Text -> ω -> Pair Source

Map keys to values that provide a ToMustache instance

Recommended in conjunction with the OverloadedStrings extension.

(~=) :: ToJSON ι => Text -> ι -> Pair Source

Map keys to values that provide a ToJSON instance

Recommended in conjunction with the OverloadedStrings extension.

(~~>) :: (Conversion ζ Text, ToMustache ω) => ζ -> ω -> Pair Source

Conceptually similar to ~> but uses arbitrary String-likes as keys.

(~~=) :: (Conversion ζ Text, ToJSON ι) => ζ -> ι -> Pair Source

Conceptually similar to ~= but uses arbitrary String-likes as keys.