1 unstable release

0.13.0 Jun 3, 2024

#2072 in Parser implementations

Download history 3/week @ 2024-07-22 10/week @ 2024-07-29 4/week @ 2024-08-12 3/week @ 2024-08-26 6/week @ 2024-09-16 8/week @ 2024-09-23 8/week @ 2024-09-30 6/week @ 2024-10-07 13/week @ 2024-10-14 104/week @ 2024-10-21 7/week @ 2024-10-28 13/week @ 2024-11-04

139 downloads per month

Apache-2.0 OR MIT

130KB
3K SLoC

vte

Build Status Crates.io Version

Parser for implementing virtual terminal emulators in Rust.

The parser is implemented according to Paul Williams' ANSI parser state machine. The state machine doesn't assign meaning to the parsed data and is thus not itself sufficient for writing a terminal emulator. Instead, it is expected that an implementation of the Perform trait which does something useful with the parsed data. The Parser handles the book keeping, and the Perform gets to simply handle actions.

See the docs for more info.


lib.rs:

Parser for implementing virtual terminal emulators

Parser is implemented according to Paul Williams' ANSI parser state machine. The state machine doesn't assign meaning to the parsed data and is thus not itself sufficient for writing a terminal emulator. Instead, it is expected that an implementation of Perform is provided which does something useful with the parsed data. The Parser handles the book keeping, and the Perform gets to simply handle actions.

Examples

For an example of using the Parser please see the examples folder. The example included there simply logs all the actions Perform does. One quick thing to see it in action is to pipe vim into it

cargo build --release --example parselog
vim | target/release/examples/parselog

Just type :q to exit.

Differences from original state machine description

  • UTF-8 Support for Input
  • OSC Strings can be terminated by 0x07
  • Only supports 7-bit codes. Some 8-bit codes are still supported, but they no longer work in all states.

Dependencies

~29–310KB