th-format: Template Haskell based support for format strings
Downloads
- th-format-0.1.3.0.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
| Versions [RSS] | 0.1.0.0, 0.1.1.0, 0.1.2.0, 0.1.3.0 |
|---|---|
| Dependencies | base (>=4.7 && <5), Earley (>=0.12.1.0 && <0.14), haskell-src-meta (>=0.8.0.2 && <0.9), template-haskell (>=2.12.0.0 && <2.15), text (>=1.2.3.0 && <1.3) [details] |
| License | BSD-3-Clause |
| Copyright | 2017-2019 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 2019-11-15T20:44:03Z |
| Distributions | |
| Reverse Dependencies | 1 direct, 1 indirect [details] |
| Downloads | 2097 total (13 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs available [build log] Last success reported on 2019-11-15 [all 1 reports] |
Readme for th-format-0.1.3.0
[back to package description]th-format 
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:
- Simple interpolation, as in
[fmt|Variable foo contains $foo|]. - Expression interpolation, as in
[fmt|The toggle is ${if toggle then ("on" :: Text) else "off"}|]