29 unstable releases

0.15.2 Feb 5, 2023
0.15.1 Dec 21, 2021
0.14.0 Dec 6, 2021
0.13.0 Nov 18, 2021
0.1.2 Jun 4, 2016

#293 in Parser implementations

Download history 9767/week @ 2024-12-09 8758/week @ 2024-12-16 4665/week @ 2024-12-23 4687/week @ 2024-12-30 7190/week @ 2025-01-06 9092/week @ 2025-01-13 8381/week @ 2025-01-20 8312/week @ 2025-01-27 9283/week @ 2025-02-03 9199/week @ 2025-02-10 8289/week @ 2025-02-17 11807/week @ 2025-02-24 13918/week @ 2025-03-03 12748/week @ 2025-03-10 12896/week @ 2025-03-17 10825/week @ 2025-03-24

51,168 downloads per month
Used in 86 crates (16 directly)

MIT license

135KB
3K SLoC

vt100

This crate parses a terminal byte stream and provides an in-memory representation of the rendered contents.

Overview

This is essentially the terminal parser component of a graphical terminal emulator pulled out into a separate crate. Although you can use this crate to build a graphical terminal emulator, it also contains functionality necessary for implementing terminal applications that want to run other terminal applications - programs like screen or tmux for example.

Synopsis

let mut parser = vt100::Parser::new(24, 80, 0);

let screen = parser.screen().clone();
parser.process(b"this text is \x1b[31mRED\x1b[m");
assert_eq!(
    parser.screen().cell(0, 13).unwrap().fgcolor(),
    vt100::Color::Idx(1),
);

let screen = parser.screen().clone();
parser.process(b"\x1b[3D\x1b[32mGREEN");
assert_eq!(
    parser.screen().contents_formatted(),
    &b"\x1b[?25h\x1b[m\x1b[H\x1b[Jthis text is \x1b[32mGREEN"[..],
);
assert_eq!(
    parser.screen().contents_diff(&screen),
    &b"\x1b[1;14H\x1b[32mGREEN"[..],
);

Dependencies

~1.5MB
~26K SLoC