th-format: Template Haskell based support for format strings

[ bsd3, data, library ] [ Propose Tags ]

This package implements a Template Haskell quasi quoter for format strings.


[Skip to Readme]
Versions [faq] 0.1.0.0, 0.1.1.0, 0.1.2.0
Dependencies base (>=4.7 && <5), Earley (>=0.12.1.0 && <0.13), haskell-src-meta (>=0.8.0.2 && <0.9), template-haskell (>=2.12.0.0 && <2.13), text (>=1.2.3.0 && <1.3) [details]
License BSD-3-Clause
Copyright 2017-2018 Moritz Clasmeier
Author Moritz Clasmeier
Maintainer mtesseract@silverratio.net
Category Data
Home page https://github.com/mtesseract/th-format#readme
Bug tracker https://github.com/mtesseract/th-format/issues
Source repo head: git clone https://github.com/mtesseract/th-format
Uploaded by mtesseract at Sat Apr 21 15:21:03 UTC 2018
Distributions NixOS:0.1.2.0
Downloads 571 total (78 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs available [build log]
Last success reported on 2018-04-21 [all 1 reports]

Modules

[Index]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


Readme for th-format-0.1.2.0

[back to package description]

th-format Hackage version Stackage version Build Status

About

This is th-format, a Haskell package implementing support for format strings using Template Haskell quasi quoters. It requires the GHC extension QuasiQuotes to be enabled. Parsing is implemented using Earley.

This package is BSD3 licensed.

Examples

Using th-format, you can use naive variable interpolation instead of verbosely concatenating strings manually. Thus, instead of

putStrLn $ "Client \"" ++ show client ++ "\" has requested resource \"" ++ show resource ++ "\" at date " ++ show date ++ "."

one can directly write:

putStrLn $ [fmt|Client "$client" has requested resource "$resource" at date $date|]

There are currently two supported ways of interpolation:

  1. Simple interpolation, as in [fmt|Variable foo contains $foo|].
  2. Expression interpolation, as in [fmt|The toggle is ${if toggle then ("on" :: Text) else "off"}|]