ilyakooo0/vty
1
0
Fork 0
mirror of https://github.com/ilyakooo0/vty.git synced 2024-11-29 08:49:40 +03:00
Code Issues Projects Releases Wiki Activity
A high-level ncurses alternative written in Haskell
665 Commits 12 Branches 65 Tags 3.8 MiB
Haskell 94.7%
C 3.7%
Perl 0.9%
Shell 0.4%
Makefile 0.3%
55d46f50f4
Go to file
Jonathan Daugherty 55d46f50f4 Make hyperlinking optional (fixes #137) 
This change makes it so that:

* Hyperlinking (emitted using 'withURL') by default is disabled.
* Hyperlinking can be enabled with 'setMode (outputIface vty) Hyperlink
  True'.

In particular, some terminals, contrary to the aspirations of the
terminal hyperlinking proposal[1], do not gracefully hide/ignore unknown
OSC sequences[2]. This change makes it so that Vty users need to opt in
to using hyperlinking and makes it clear that the feature may or may not
be very well-supported and that they should do adequate testing on the
terminal emulators they wish to support.

[1] https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda
[2] https://github.com/jtdaugherty/vty/issues/137
2017-12-02 14:40:02 -08:00
cbits Revert "Replace stale wcwidth implementation with utf8proc library call" 2016-11-19 11:46:35 -08:00
ci Fix ghc version comparison in travis scripts 2016-04-13 13:05:49 +06:00
demos Avoid use of Data.Default in demo 2017-01-22 12:43:21 -08:00
docs Move DESIGN to docs/ 2017-01-21 20:06:15 -08:00
scripts refactor vty to use standard naming convention. 2014-04-11 17:51:13 -07:00
src Make hyperlinking optional (fixes #137) 2017-12-02 14:40:02 -08:00
test Rogue: Remove unused language extension, TemplateHaskell 2017-03-04 11:14:11 -08:00
.gitignore Cap minimum values of charFill arguments to zero 2017-06-28 20:19:04 -05:00
.travis.yml Package: discontinue support for GHC < 7.10.1 2017-01-22 11:05:06 -08:00
AUTHORS Rename CHANGELOG, improve formatting 2017-01-21 20:13:46 -08:00
CHANGELOG.md Bump version, update changelog 2017-10-06 14:15:34 -07:00
LICENSE use alloca instead of mallocBytes for exception safety 2009-09-04 10:29:28 -07:00
README.md Move terminal programming information sources to README 2017-01-22 12:43:10 -08:00
Setup.lhs use alloca instead of mallocBytes for exception safety 2009-09-04 10:29:28 -07:00
vty.cabal Bump version, update changelog 2017-10-06 14:15:34 -07:00

README.md

Build Status

vty is a terminal interface library. It provides a high-level interface for doing terminal I/O. Vty is supported on GHC versions 7.10.1 and up.

Install via git with:

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

Install via cabal with:

cabal install vty

Features

  • Supports a large number of terminals. vt100, ansi, hurd, linux, screen, etc., or anything with a sufficient terminfo entry.

  • Automatic handling of window resizes.

  • Unicode output on terminals with UTF-8 support.

  • Handles multi-column glyphs. (Requires user to properly configure terminal.)

  • Efficient output. Output buffering and terminal state changes are minimized.

  • Minimizes repaint area, which virtually eliminates the flicker problems that plague 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.

  • Supports a keypress timeout after for lone ESC. The timeout is customizable.

  • The interface is designed for easy extension.

  • Supports ANSI graphics modes (SGR as defined in console_codes(4)) with a type-safe interface and graceful fallback for terminals with limited or nonexistent support for such modes.

  • Properly handles cleanup (but not due to signals).

  • Provides a comprehensive test suite.

  • Supports "normal" and "extended" (SGR) mouse modes as described at http://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Mouse-Tracking

  • Supports bracketed paste mode as described at http://cirw.in/blog/bracketed-paste

Platform Support

Posix Terminals

Uses terminfo to determine terminal protocol. With some special rules to handle some omissions from terminfo.

Windows

Unsupported (but contributions and testing here are very welcome!)

Contributing

If you decide to contribute, that's great! Here are some guidelines you should consider to make submitting patches easier for all concerned:

  • If you want to take on big things, talk to me first; let's have a design/vision discussion before you start coding. Create a GitHub issue and we can use that as the place to hash things out.
  • If you make changes, make them consistent with the syntactic conventions already used in the codebase.
  • Please provide Haddock documentation for any changes you make.

Development Notes

Under NixOS

Using cabal

After installing ncurses to the user environment:

LIBRARY_PATH=$HOME/.nix-profile/lib/ cabal configure --enable-tests --extra-lib-dirs=$HOME/.nix-profile/lib
LIBRARY_PATH=$HOME/.nix-profile/lib/ cabal build
LIBRARY_PATH=$HOME/.nix-profile/lib/ cabal test

Code Coverage

As of last testing, profiling causes 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

Known Issues

  • Terminals have numerous quirks and bugs. Vty picks what works best for the author in ambiguous or buggy situations.

  • Signal handling of STOP, TERM and INT are nonexistent.

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

  • Terminfo is assumed to be correct unless there is an override configured. Some terminals will not have correct special key support (shifted F10 etc). See Config for customizing vty's behavior for a particular terminal.

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

Sources

Good sources of documentation for terminal programming are: