name: hat version: 2.9.4 synopsis: The Haskell tracer, generating and viewing Haskell execution traces description: hat-trans transforms Module.hs into Hat/Module.hs such that when the program is executed, a trace file Programname.hat is generated. Various tools (hat-trail, hat-observe, hat-explore ...) then allow viewing the trace file in different ways, to locate a bug or understand how a program works. Hat 2.9 uses the haskell-src-exts parser and other Hackage libraries to reduce its own size and simplify extensions. Module imports and exports have also been improved to handle nearly all kinds of renaming, hiding, etc. Hat 2.9 works only with ghc for Haskell 98 (plus a few extensions) and the standard Haskell 98 libraries plus some Haskell 2010 libraries. Although it should build on any operating system, most viewing tools use ASCII console escape sequences and they open xterms; hence they will only work well under Unix and X11. Tested on MacOS X 10.11.6. Installation: > cabal -v install Flag -v allows you to see what is going on. Building takes a long time (one module has 25.000 lines of code). Some compiler warnings have been turned off. The tracing transformation does produce code with lots of overlapping patterns. Use: > hat-make MyProgram.hs transforms and compiles all modules of your program and produces the tracing version Hat/MyProgram. Run your program > Hat/MyProgram which will produce trace files MyProgram.hat* Use the viewing tools to explore the trace: > hat-trail / hat-observe / hat-explore /... MyProgram There is documentation in the "docs" folder, but it is partially outdated. There are a few small programs for exploring tracing in the "examples" folder. homepage: http://projects.haskell.org/hat/ license: OtherLicense license-file: docs/copyright.html copyright: (c) 2000-2017 Hat team author: Hat team maintainer: oc@kent.ac.uk stability: provisional tested-with: GHC ==8.0.1 bug-reports: oc@kent.ac.uk category: Development build-type: Simple cabal-version: >=1.8 data-dir: libraries data-files: *.hx, *.hs, Control/*.hx, Control/*.hs, Data/*.hx, Data/*.hs extra-source-files: include/*.h, tools/*.h, Hat/*.h, docs/*.html, docs/*.hs, docs/*.ps.gz, docs/*.eps, docs/*.gif, docs/*.pdf, docs/*.tex, docs/*.dvi, docs/*.hva, docs/man/*.1, docs/man/*.1.in, examples/*.hs source-repository head type: git location: git://github.com/OlafChitil/hat.git library exposed-modules: Hat.Array, Hat.Char, Hat.Complex, Hat.CPUTime, Hat.Directory, Hat.Hack, Hat.Hat, Hat.IO, Hat.Ix, Hat.List, Hat.Locale, Hat.Maybe, Hat.Monad, Hat.Numeric, Hat.Prelude, Hat.PreludeBasic, Hat.PreludeBuiltinTypes, Hat.Random, Hat.Ratio, Hat.System, Hat.Time, Hat.Control.Monad, Hat.Data.Char, Hat.Data.Maybe, Hat.Data.List, Hat.System.Environment, Hat.System.Exit, Hat.System.IO build-depends: base >=4.9 && < 5, directory >=1.1, random >=1.0, process >=1.1, old-time >=1.1, old-locale >=1.0 other-modules: Hat.DirectoryBuiltin, Hat.DirectoryBuiltinTypes, Hat.IOBuiltin, Hat.IOBuiltinTypes, Hat.PreludeBuiltin, Hat.RandomBuiltin, Hat.SystemBuiltin, Hat.SystemBuiltinTypes, Hat.TimeBuiltin, Hat.TimeBuiltinTypes extensions: ForeignFunctionInterface includes: hat-c.h, art.h, ntohl.h include-dirs: include, Hat c-sources: Hat/hat-c.c cc-options: -DFILEVERSION="2.08" ghc-options: -w executable hat-trans main-is: HatTrans.hs hs-source-dirs: trans other-modules: Wired, SynHelp, Relation, Wrap, Flags, Environment, AuxFile, Derive, TraceTrans build-depends: base >=4.9, bytestring >=0.9, directory >=1.1, haskell-src-exts >= 1.18 && < 1.19, containers >= 0.5.2, filepath >= 1.3 includes: hat-c.h, art.h, ntohl.h include-dirs: include, Hat c-sources: Hat/hat-c.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable hat-trail main-is: HatTrail.hs hs-source-dirs: tools other-modules: LowLevel, SrcRef, Ident, SExp, PrettyLibHighlight, HighlightStyle, CommonUI build-depends: base >=4.9, containers >=0.4, directory >=1.1, process >=1.1 extensions: ForeignFunctionInterface includes: art.h include-dirs: include c-sources: tools/pathutils.c, tools/artutils.c, tools/finitemap.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable hat-observe main-is: HatObserve.hs hs-source-dirs: tools other-modules: Observe, LowLevel, SExp, Ident, PrettyLibHighlight, HighlightStyle, Pattern, Idents, CmdLine, CommonUI, SrcRef, Trie, TExp build-depends: base >=4.9, process >=1.1, haskeline >=0.6, polyparse >= 1.11 extensions: ForeignFunctionInterface includes: art.h include-dirs: include c-sources: tools/pathutils.c, tools/artutils.c, tools/finitemap.c, tools/hat-names.c, tools/observeutils.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable hat-stack main-is: HatStackText.hs hs-source-dirs: tools other-modules: HatStack, LowLevel, SExp, PrettyLibHighlight, HighlightStyle, Ident, SrcRef, CommonUI build-depends: base >=4.9, process >=1.1 extensions: ForeignFunctionInterface includes: art.h include-dirs: include c-sources: tools/pathutils.c, tools/artutils.c, tools/finitemap.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable hat-explore main-is: HatExplore.hs hs-source-dirs: tools other-modules: Explore, CommonUI, HighlightStyle, LowLevel, Ident, SrcRef, SExp, Detect, NodeExp, Slice, ADT, Detect, PrettyLibHighlight build-depends: base >=4.9, process >=1.1 extensions: ForeignFunctionInterface includes: art.h include-dirs: include c-sources: tools/parentset.c, tools/detectutils.c, tools/pathutils.c, tools/artutils.c, tools/finitemap.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable hat-detect -- currently just calls hat-delta; was a separate tool main-is: HatDetect.hs hs-source-dirs: tools other-modules: LowLevel, SExp, TExp, HighlightStyle, CommonUI, SrcRef, CmdLine, Detect, Ident, PrettyLibHighlight build-depends: base >=4.9, directory >=1.1, process >=1.1, haskeline >=0.6 extensions: ForeignFunctionInterface includes: art.h, ntohl.h include-dirs: include c-sources: tools/detectutils.c, tools/parentset.c, tools/pathutils.c, tools/artutils.c, tools/finitemap.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable hat-check main-is: HatCheck.hs hs-source-dirs: tools build-depends: base >=4.9, process >=1.1 extensions: ForeignFunctionInterface includes: art.h, ntohl.h include-dirs: include c-sources: tools/hat-check.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable hat-view main-is: SrcRefViewer.hs hs-source-dirs: tools other-modules: HighlightStyle, Run build-depends: base >=4.9, process >=1.1, directory >=1.1 extensions: ForeignFunctionInterface includes: art.h, ntohl.h include-dirs: include executable hat-cover -- builds, but doesn't seem to work main-is: HatCoverText.hs hs-source-dirs: tools other-modules: HatCover, LowLevel, SrcRef, HighlightStyle, Ident build-depends: base >=4.9, process >=1.1 extensions: ForeignFunctionInterface includes: art.h, ntohl.h include-dirs: include c-sources: tools/pathutils.c, tools/artutils.c, tools/finitemap.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable black-hat main-is: BlackHat.hs hs-source-dirs: tools other-modules: LowLevel, SExp, PrettyLibHighlight, HighlightStyle, Run, NonTermLib, CommonUI, Ident, SrcRef build-depends: base >=4.9, process >=1.1, directory >= 1.2 extensions: ForeignFunctionInterface includes: art.h, ntohl.h include-dirs: include c-sources: tools/nontermutils.c, tools/pathutils.c, tools/artutils.c, tools/finitemap.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable hat-nonterm main-is: HatNonTerm.hs hs-source-dirs: tools other-modules: LowLevel, SExp, PrettyLibHighlight, HighlightStyle, Run, NonTermLib, CommonUI, Ident, SrcRef build-depends: base >=4.9, process >=1.1, directory >= 1.0 extensions: ForeignFunctionInterface includes: art.h, ntohl.h include-dirs: include c-sources: tools/nontermutils.c, tools/pathutils.c, tools/artutils.c, tools/finitemap.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable hat-anim main-is: HatAnim.hs hs-source-dirs: tools other-modules: NodeExp, Pretty, CommonUI, LowLevel, HighlightStyle, ADT, Delta, EDT, Explore, Ident, PrettyLibHighlight, SExp, Slice, SrcRef build-depends: base >=4.9, process >=1.1, containers >=0.4 extensions: ForeignFunctionInterface includes: art.h, ntohl.h include-dirs: include c-sources: tools/detectutils.c, tools/parentset.c, tools/pathutils.c, tools/artutils.c, tools/finitemap.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable pretty-hat main-is: PrettyHat.hs hs-source-dirs: tools other-modules: Pretty, NodeExp, EDT, HighlightStyle, Delta, Slice, ADT, Explore, SExp, CommonUI, SrcRef, Ident, LowLevel, PrettyLibHighlight, Detect build-depends: base >=4.9, process >=1.1, containers >=0.4 extensions: ForeignFunctionInterface includes: art.h, ntohl.h include-dirs: include c-sources: tools/detectutils.c, tools/parentset.c, tools/pathutils.c, tools/artutils.c, tools/finitemap.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable hat-delta main-is: HatDelta.hs hs-source-dirs: tools other-modules: Pretty, Slice, LowLevel, CommonUI, NodeExp, SExp, ADT, EDT, SrcRef, FDT, Delta, Explore, HighlightStyle, PrettyLibHighlight, Ident build-depends: base >=4.9, process >=1.1, containers >=0.4 extensions: ForeignFunctionInterface includes: art.h, ntohl.h include-dirs: include c-sources: tools/detectutils.c, tools/parentset.c, tools/pathutils.c, tools/artutils.c, tools/finitemap.c cc-options: -DFILEVERSION="2.08" -DVERSION="2.9" executable hat-make main-is: HatMake.hs hs-source-dirs: tools build-depends: base >=4.9, process >=1.1, directory >=1.1