Yasi

Yet another string interpolator

• Very simple, few dependencies.
• Based on Display instead of Show.
• Depends on ghc-hs-meta instead of haskell-src-meta for interpolating arbitrary expressions. This results in faster compile times and fewer bugs.

Documentation

i :: QuasiQuoter

The main interpolator, intended to be used with QuasiQuotes.

>>> :set -XQuasiQuotes

>>> (foo, bar) = ("yet another ", "interpolator")
>>> [i|${foo}string $bar|] :: String
"yet another string interpolator"

The result type can be String, strict Text or lazy Text.

You can also use ${} to create a function interpolator (this "abstraction" feature is inspired by interpolate):

>>> [i|more ${}${} code${replicate 3 '!'}|] "point" "free" :: Text
"more pointfree code!!!"

Variants

iFS :: QuasiQuoter

Like i, but works with IsString.

[iFS|...|] = fromString [i|...|]

>>> :t [iFS|hi|]
[iFS|hi|] :: Data.String.IsString a => a

iS :: QuasiQuoter

Like i, but with the result type fixed to String.

[iS|...|] = [i|...|] :: String

>>> :t [iS|hi|]
[iS|hi|] :: String

iT :: QuasiQuoter

Like i, but with the result type fixed to strict Text.

[iT|...|] = [i|...|] :: Text

>>> :t [iT|hi|]
[iT|hi|] :: Text

iTL :: QuasiQuoter

Like i, but with the result type fixed to lazy Text.

[iTL|...|] = [i|...|] :: Text

>>> :t [iTL|hi|]
[iTL|hi|] :: Data.Text.Lazy.Text