interpol: GHC preprocessor and library to enable variable interpolation in strings

[ gpl, language, library, program, source-tools ] [ Propose Tags ] [ Report a vulnerability ]

This preprocessor enables variable interpolation in strings. Alternatively, the library may be used.

See the README.md file for details.


[Skip to Readme]

Modules

[Index]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0, 0.2.0, 0.2.1, 0.2.2, 0.2.3
Change log NEWS.md
Dependencies base (>=4 && <5), haskell-src-exts, regex-posix, syb [details]
License GPL-3.0-only
Author Alexandru Scvortov <scvalex@gmail.com>
Maintainer scvalex@gmail.com
Category Source-tools, Language
Home page https://github.com/scvalex/interpol
Source repo head: git clone git://github.com/scvalex/interpol.git
Uploaded by AlexandruScvortov at 2012-06-22T01:49:17Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Executables interpol
Downloads 3891 total (2 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]

Readme for interpol-0.2.3

[back to package description]

interpol

variable interpolations

Examples

The interpol preprocessor parses Haskell source file before GHC and performs variable interpolation statically. Concretely, it replaces {identifier} patterns in literal strings with show identifier. For instance,

okVal = 23
"I have {okVal} apples."

becomes

"I have 23 apples."

This works on any type that has a Show instance and is safe, in the sense that it does not disable any of GHC's normal checks (i.e. interpolating a non-existing identifier or one whose type does not have a Show instance will result in the appropriate error).

Installation

This package is on Hackage. To install it, run:

cabal update
cabal install interpol

Usage

To use interpol, install the cabal package (and/or make sure that the interpol executable is in your path), and compile with the "-F -pgmF interpol" GHC options. For instance, one of the tests for this package is compiled with:

ghc -F -pgmF interpol Test/One.hs

Alternatively, you may specify the options in a GHC_OPTIONS pragma at the top of the file:

{-# OPTIONS_GHC -F -pgmF interpol #-}

Note that, unless you use this latter pragma, ghc-mod and other flymake-based Emacs modes will probably complain about unused variables.

Operation

The interpol preprocessor effectively does two things:

  1. it adds an import declaration for Text.Interpol, in order to bring the (^-^) operator into scope, and

  2. it replaces any occurrence of "\\{[A-z_][A-z0-9_]*}" in string literals with "^-^ <ident> ^-^".

So,

"I have {okVal} apples."

actually becomes

("I have " ^-^ okVal ^-^ " apples.")

The (^-^) operator is a smarter version of (++): it shows its second argument before appending, but only if it is not already a String (i.e. it does not quote String values when interpolating).

Run the preprocessor manually and check out the source for details (seriously now, this README is longer than the source).