The ghc-vis package

[Tags: bsd3, library]

Visualize live data structures in GHCi. Evaluation is not forced and you can interact with the visualized data structures. This allows seeing Haskell's lazy evaluation and sharing in action.

To use this package add the accompanying ghci file to your .ghci like this:

 echo ":script $HOME/.cabal/share/ghc-vis-0.3/ghci" >> ~/.ghci

Now you can run ghci and experiment with ghc-vis. Start the visualization:

 $ ghci
 GHCi, version 7.4.2: http://www.haskell.org/ghc/  :? for help
 > :vis

A blank window should appear now. This is the visualization window. Add an expression to the visualization:

 > let a = [1..3]
 > :view a
 > let b = cycle a
 > :view b
 > :view "foo" ++ "bar"

http://felsin9.de/nnis/ghc-vis/1.png

Functions are red, named objects are green and links to an already shown object are blue.

Notice how a is referenced by b.

Evaluate an object that is shown in the visualization. You can also click on the object to evaluate it.

 > :eval t1

http://felsin9.de/nnis/ghc-vis/2.png

The first element of b has been evaluated. We see that it's a reference to the value that's also referenced in a, as they share the same name t0.

Switch between the list view and the graph view:

 > :switch

http://felsin9.de/nnis/ghc-vis/3.png

When an object is updated by accessing it, you have to call :update to refresh the visualization window. You can also click on an object to force an update:

 > a !! 2
 3
 > :update

http://felsin9.de/nnis/ghc-vis/4.png

Clear the visualization window, this also happens when you :load or :reload a source file:

 > :clear

Properties

Versions0.1, 0.2, 0.2.1, 0.3, 0.3.1, 0.3.1.1, 0.3.2, 0.4, 0.5, 0.6, 0.6.1, 0.6.1.1, 0.7, 0.7.0.1, 0.7.1, 0.7.2, 0.7.2.1, 0.7.2.2, 0.7.2.3, 0.7.2.4, 0.7.2.5, 0.7.2.6, 0.7.2.7
Dependenciesbase (==4.*), cairo (==0.12.*), deepseq, fgl, ghc-heap-view (>=0.3), gtk (==0.12.*), mtl (>=2.0), text, transformers
LicenseBSD3
CopyrightDennis Felsing 2012
AuthorDennis Felsing <dennis@felsin9.de>
MaintainerDennis Felsing <dennis@felsin9.de>
CategoryGHC, Debug, Development
Home pagehttp://felsin9.de/nnis/ghc-vis
UploadedSat Sep 8 20:02:50 UTC 2012 by DennisFelsing
DistributionsNixOS:0.7.2.7
Downloads2159 total (126 in last 30 days)
StatusDocs not available [build log]
All reported builds failed [all 2 reports]

Modules

Flags

NameDescriptionDefault
graph"Enable graph view using Graphviz"Enabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainers' corner

For package maintainers and hackage trustees