Difference between revisions of "GHCi in colour"

From HaskellWiki
Jump to navigation Jump to search
(note this is already kinda possible with HsColour)
(Added missed references tag)
 
(12 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 
This page documents efforts to colourise GHCi output.
 
This page documents efforts to colourise GHCi output.
   
== Example ==
+
== Prompt only ==
  +
  +
The prompt can be colored by altering GHCi's <code>prompt</code> setting including [https://en.wikipedia.org/wiki/ANSI_escape_code#Colors ANSI terminal color codes]. For example
  +
  +
:set prompt "\ESC[34m\STX%s > \ESC[m\STX"
  +
  +
will give the prompt blue color:
  +
  +
[[Image:Colored_ghci_prompt.png‎]]
  +
  +
As usual, adding this to <code>ghci.conf</code> will auto-execute the command when running GHCi, making the prompt colored by default.
  +
  +
Remember to use <code>\STX</code> to end an escape sequence. Without this control character, the prompt length will be [http://trac.haskell.org/haskeline/wiki/ControlSequencesInPrompt computer incorrectly] and your prompt will look wrong when editing long commands.
  +
  +
== Full highlighting ==
  +
 
=== Example ===
   
 
[[Image:Colour-ghci.png]]
 
[[Image:Colour-ghci.png]]
Line 15: Line 31:
 
and would appear in the console/xterm as ansi terminal coloured output.
 
and would appear in the console/xterm as ansi terminal coloured output.
   
== Implementation ==
+
=== Implementation ===
   
=== Using HsColour ===
+
==== Using sed and ghci.conf ====
  +
  +
You can use sed to color the non-prompt output, and color the prompt with ghci.conf. This works better than piping into HsColour for me. See [https://web.archive.org/web/20160202232256/http://martijn.van.steenbergen.nl:80/journal/2010/02/27/colors-in-ghci this] blog post for details.
  +
  +
This allows you to colorize everything you can catch with a regexp. Note that when coloring GHCi prompt using ghci.conf one should, in ultimate escapity, escape the escape codes with \001..\002, otherwise readline will mess up when editing long lines. For a working example of how this can be done refer to [[:File:Ghci 256color.tar.gz|this example]]. Output:
  +
  +
[[Image:GHCi 256color.jpg]]
  +
  +
This approach doesn't work well if you try to output an infinite sequence and then hit CTRL+C, ideas on how to fix that are welcome.
  +
  +
==== Using HsColour ====
   
 
An existing tool, [http://www.cs.york.ac.uk/fp/darcs/hscolour/ HsColour],
 
An existing tool, [http://www.cs.york.ac.uk/fp/darcs/hscolour/ HsColour],
Line 26: Line 52:
 
ghci 2>&1 | HsColour -tty
 
ghci 2>&1 | HsColour -tty
   
  +
[[Image:Tty.png|frame|HsColour in action]]
=== GuiHaskell ===
 
  +
  +
There are small delays however, when lexing certain tokens, and the
  +
interaction with readline isn't ideal.
  +
  +
See http://www.reddit.com/r/haskell/comments/144biy/pretty_output_in_ghci_howto_in_comments/
  +
  +
==== GuiHaskell ====
  +
 
[https://ndmitchell.com/ Neil Mitchell] has a prototype [https://github.com/ndmitchell/guihaskell GuiHaskell] wrapper, based on GTK<ref>''Maintainers note:'' Does this contain a reasonable GHCi wrapper we could steal?</ref>.
  +
   
Neil Mitchell has a prototype [http://www-users.cs.york.ac.uk/~ndm/projects/guihaskell.php gui haskell] wrapper, based on gtk. Does this contain a reasonable ghci wrapper we could steal?
 
   
   
Line 34: Line 69:
   
 
[[Category:Tools]]
 
[[Category:Tools]]
  +
  +
<references />

Latest revision as of 18:53, 22 January 2019

This page documents efforts to colourise GHCi output.

Prompt only

The prompt can be colored by altering GHCi's prompt setting including ANSI terminal color codes. For example

   :set prompt "\ESC[34m\STX%s > \ESC[m\STX"

will give the prompt blue color:

   Colored ghci prompt.png

As usual, adding this to ghci.conf will auto-execute the command when running GHCi, making the prompt colored by default.

Remember to use \STX to end an escape sequence. Without this control character, the prompt length will be computer incorrectly and your prompt will look wrong when editing long commands.

Full highlighting

Example

   Colour-ghci.png

Or a type error:

   Coloured-error.png

Output like this would be the result of running, for example:

   ghci --colour

and would appear in the console/xterm as ansi terminal coloured output.

Implementation

Using sed and ghci.conf

You can use sed to color the non-prompt output, and color the prompt with ghci.conf. This works better than piping into HsColour for me. See this blog post for details.

This allows you to colorize everything you can catch with a regexp. Note that when coloring GHCi prompt using ghci.conf one should, in ultimate escapity, escape the escape codes with \001..\002, otherwise readline will mess up when editing long lines. For a working example of how this can be done refer to this example. Output:

   GHCi 256color.jpg

This approach doesn't work well if you try to output an infinite sequence and then hit CTRL+C, ideas on how to fix that are welcome.

Using HsColour

An existing tool, HsColour, could be modified to operate interactively. In fact, HsColour is already interactive, and with a small patch added on 2006-12-14 to control ouput buffering better, this works relatively nicely:

   ghci 2>&1 | HsColour -tty
HsColour in action

There are small delays however, when lexing certain tokens, and the interaction with readline isn't ideal.

See http://www.reddit.com/r/haskell/comments/144biy/pretty_output_in_ghci_howto_in_comments/

GuiHaskell

Neil Mitchell has a prototype GuiHaskell wrapper, based on GTK[1].



If you have an idea of how to do this nicely, add your proposal here.

  1. Maintainers note: Does this contain a reasonable GHCi wrapper we could steal?