microstache alternatives and similar packages
Based on the "Text" category.
Alternatively, view microstache alternatives based on common mentions on social networks and blogs.
-
skylighting
A Haskell syntax highlighting library with tokenizers derived from KDE syntax highlighting descriptions -
double-conversion
A fast Haskell library for converting between double precision floating point numbers and text strings. It is implemented as a binding to the V8-derived C++ double-conversion library.
WorkOS - The modern identity platform for B2B SaaS
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of microstache or a related project?
README
microstache
Based on stache
library, which uses megaparsec
.
This library uses parsec
, thus the name: microstache
.
This is a Haskell implementation of Mustache templates. The implementation conforms to the version 1.1.3 of official Mustache specification. It is extremely simple and straightforward to use with minimal but complete API — three functions to compile templates (from directory, from file, and from lazy text) and one to render them.
For rendering you only need to create Aeson's Value
where you put the data
to interpolate. Since the library re-uses Aeson's instances and most data
types in Haskell ecosystem are instances of classes like
Data.Aeson.ToJSON
, the whole process is very simple for end user.
One feature that is not currently supported is lambdas. The feature is marked as optional in the spec and can be emulated via processing of parsed template representation. The decision to drop lambdas is intentional, for the sake of simplicity and better integration with Aeson.
Differences from stache
- Instead of
megaparsec
,parsec
is used. Error message quality is most likely degraded. - There are no TemplateHaskell used; yet there are no helpers provided.
- Support for GHC-7.4.2 – GHC-8.2.1
Quick start
Here is an example of basic usage:
{-# LANGUAGE OverloadedStrings #-}
module Main (main) where
import Data.Aeson
import Data.Text
import Text.Microstache
import qualified Data.Text.Lazy.IO as TIO
main :: IO ()
main = do
let res = compileMustacheText "foo"
"Hi, {{name}}! You have:\n{{#things}}\n * {{.}}\n{{/things}}\n"
case res of
Left err -> putStrLn (show err)
Right template -> TIO.putStr $ renderMustache template $ object
[ "name" .= ("John" :: Text)
, "things" .= ["pen" :: Text, "candle", "egg"]
]
If I run the program, it prints the following:
Hi, John! You have:
* pen
* candle
* egg
For more information about Mustache templates the following links may be helpful:
- The official Mustache site: https://mustache.github.io/
- The manual: https://mustache.github.io/mustache.5.html
- The specification: https://github.com/mustache/spec
- Stack Builders Stache tutorial: https://www.stackbuilders.com/tutorials/haskell/mustache-templates/
License
Copyright © 2016–2017 Stack Builders, 2017 Oleg Grenrus
Distributed under BSD 3 clause license.
*Note that all licence references and agreements mentioned in the microstache README section above
are relevant to that project's source code only.