A high-level ncurses alternative written in Haskell
Go to file
2014-01-31 01:13:24 -08:00
cbits derive new input loop 2014-01-21 03:50:57 -08:00
ci fix travis ci entry point 2013-12-13 19:34:41 -08:00
docs - 2009-11-07 00:34:29 -08:00
scripts add script used to generate the Color240 module 2013-10-30 14:10:19 -07:00
src resolve test compile failures 2014-01-31 01:13:24 -08:00
test resolve test compile failures 2014-01-31 01:13:24 -08:00
.gitignore add .hpc dir 2013-07-06 21:59:21 -07:00
.travis.yml ask travis CI to build with multiple GHC versions 2013-12-13 00:03:01 -08:00
AUTHORS update AUTHORS 2010-08-06 14:16:26 -07:00
build_examples add a build examples script which just builds the examples package 2013-11-12 22:31:25 -08:00
CHANGELOG update CHANGELOG 2014-01-24 08:22:59 +01:00
DESIGN adding example of Graphics.Vty.Inline to test 2009-12-28 15:32:18 -08:00
install_examples rename ClassifyTable to ClassifyTableV1 2013-11-17 20:59:52 -08:00
LICENSE use alloca instead of mallocBytes for exception safety 2009-09-04 10:29:28 -07:00
README.md split input table generation based on terminal type 2013-12-24 22:06:58 -08:00
Setup.lhs use alloca instead of mallocBytes for exception safety 2009-09-04 10:29:28 -07:00
TODO adding example of Graphics.Vty.Inline to test 2009-12-28 15:32:18 -08:00
vty.cabal resolve test compile failures 2014-01-31 01:13:24 -08:00

vty is a terminal interface library.

Project is hosted on github.com: https://github.com/coreyoconnor/vty

git clone git://github.com/coreyoconnor/vty.git

Features

  • Automatic handling of window resizes.

  • Supports Unicode characters on output, automatically setting and resetting UTF-8 mode for xterm. Other terminals are assumed to support

  • Efficient output.

  • Minimizes repaint area, thus virtually eliminating the flicker problem that plagues ncurses programs.

  • A pure, compositional interface for efficiently constructing display images.

  • Automatically decodes keyboard keys into (key,[modifier]) tuples.

  • Automatically supports refresh on Ctrl-L.

  • Automatically supports timeout after 50ms for lone ESC (a barely noticable delay)

  • Interface is designed for relatively easy compatible extension.

  • Supports all ANSI SGR-modes (defined in console_codes(4)) with a type-safe interface.

  • Properly handles cleanup, but not due to signals.

Known Issues

  • Signal handling of STOP, TERM and INT are non existent.

  • The character encoding of the terminal is assumed to be UTF-8.

  • Terminfo is assumed to be correct unless the terminal (as declared by TERM) starts with xterm or ansi. This means that some terminals will not have correct special key support (shifted F10 etc)

  • Uses the TIOCGWINSZ ioctl to find the current window size, which appears to be limited to Linux and *BSD.

Platform Support

Posix Terminals

Uses terminfo to determine terminal protocol. Some special rules for Mac terminal applications. The special rules might be invalid on newer Mac OS.

Windows

None!

Development Notes

Coverage

Profiling appears to cause issues with coverage when enabled. To evaluate coverage configure as follows:

rm -rf dist ; cabal configure --enable-tests --enable-library-coverage \
  --disable-library-profiling \
  --disable-executable-profiling

Profiling

rm -rf dist ; cabal configure --enable-tests --disable-library-coverage \
  --enable-library-profiling \
  --enable-executable-profiling