Copyright	(c) 2013 Chris Done, 2013 Shachaf Ben-Kiki
License	BSD3
Maintainer	[email protected]
Stability	experimental
Portability	GHC
Safe Haskell	Safe-Inferred
Language	Haskell98

Formatting.Holey

Contents

Formatting library

Description

Copy of the holey monoids library but with constructor exported.

Synopsis

Formatting library

type Format r x = Holey Builder r x Source

A formatter.

type Holey m r a = HoleyT r a m Source

newtype HoleyT r a m Source

The type of a monoid with holes. The underlying monoid is represented by type parameter m. The r is the result type and stays polymorphic until the very last moment when run is called. The last argument a is always a function with zero or more arguments, finally resulting in r. Ordering the arguments in this order allows holey monoids to be composed using ., stacking the expected arguments. Note that the Monoid constraint is only used in the identity Holey and in composing two Holeys.

Constructors

Holey
Fields runHM :: (m -> r) -> a

Instances

Functor (HoleyT r a)
(~) * a r => IsString (Format r a)	Very useful instance for writing format string.

(%) :: Format b c -> Format r b -> Format r c Source

Composition operator. The same as category composition.

(%.) :: Format r (Builder -> b) -> Format b c -> Format r c Source

Function compose two holeys. Will feed the result of one holey into another.

now :: Builder -> Format r r Source

Insert a constant monoidal value.

bind :: Format b c -> (Builder -> Format a b) -> Format a c Source

Monadic indexed bind for holey monoids.

later :: (a -> Builder) -> Format r (a -> r) Source

Insert a monoidal value that is not specified until the computation is run. The argument that is expected later is converted to the monoid type using the given conversion function.