groom

Pretty printing for well-behaved Show instances.

LTS Haskell 20.23:	0.1.2.1
Stackage Nightly 2023-06-04:	0.1.2.1
Latest on Hackage:	0.1.2.1

See all snapshots groom appears in

BSD-3-Clause licensed by Edward Z. Yang

Maintained by ezyang@mit.edu

This version can be pinned in stack with:groom-0.1.2.1@sha256:b3be67cea27ec403032d23649f9995048fecb39f885d6b62b42209ada0fda636,1771

Module documentation for 0.1.2.1

Text
- Text.Groom

Depends on 3 packages(full list with versions):

base, groom, haskell-src-exts

Used by 4 packages in lts-9.21(full list with versions):

amazonka-test, data-msgpack, groom, text-generic-pretty

Automatically derived Show instances are an easy way to inspect data in your program. However, for large data-structures, the resulting output lacks whitespace, making it unreadable. Groom offers an replacement to show called groom which attempts to pretty-print the output of show. For example:

let x = parseExp "foobar 1 [1,2]"
in do
  putStrLn (show x)
  putStrLn (groom x)

results in:

ParseOk (App (App (Var (UnQual (Ident "foobar"))) (Lit (Int 1))) (List [Lit (Int 1),Lit (Int 2)]))
ParseOk
  (App (App (Var (UnQual (Ident "foobar"))) (Lit (Int 1)))
     (List [Lit (Int 1), Lit (Int 2)]))

Groom works only on Show instances that output valid Haskell code; if Groom can't understand its input, it will not make any changes.