3 releases (breaking)

0.3.0 Jan 30, 2025
0.2.0 Oct 18, 2022
0.1.1 Oct 18, 2022
0.1.0 Jul 19, 2022

#1458 in Parser implementations

Download history 29019/week @ 2025-09-13 52974/week @ 2025-09-20 30825/week @ 2025-09-27 27233/week @ 2025-10-04 32056/week @ 2025-10-11 30963/week @ 2025-10-18 33198/week @ 2025-10-25 30061/week @ 2025-11-01 29121/week @ 2025-11-08 31702/week @ 2025-11-15 34778/week @ 2025-11-22 35941/week @ 2025-11-29 39602/week @ 2025-12-06 39523/week @ 2025-12-13 27489/week @ 2025-12-20 31734/week @ 2025-12-27

143,213 downloads per month
Used in 200 crates (6 directly)

MIT license

58KB
1K SLoC

ansi escape codes tokenization

gitlab crates.io docs.rs build status

This is a library for parsing ANSI escape sequences.

The list of covered sequences.

  • Cursor Position
  • Cursor {Up, Down, Forward, Backward}
  • Cursor {Save, Restore}
  • Erase Display
  • Erase Line
  • Set Graphics mode
  • Set/Reset Text Mode

Usage

let text = "\x1b[31;1;4mHello World\x1b[0m";

for e in parse_ansi(text) {
    match e.kind() {
        ElementKind::Text => {
            println!("Got a text: {:?}", &text[e.range()],);
        }
        _ => {
            println!(
                "Got an escape sequence: {:?} from {:#?} to {:#?}",
                e.kind(),
                e.start(),
                e.end()
            );
        }
    }
}

no_std support

no_std is supported via disabling the std feature in your Cargo.toml.

Notes

The project got an insiration from https://gitlab.com/davidbittner/ansi-parser.

Dependencies

~1MB
~21K SLoC