AnsiStream

Write blazingly fast, free allocation ansi escape codes to a buffer, and flushes them all to any output stream. Supports 8/16 colors, 256 colors, RGB color rendering output.

ANSI Escape Codes for Terminal Graphics

The ANSI escape code standard, formally adopted as ISO/IEC 6429, defines a series of control sequences. Each control sequence begins with a Control Sequence Introducer (CSI), defined as a scape character followed immediately by a bracket: ESC[. In particular, a CSI followed by a certain number of "parameter bytes" (ASCII 0-9:; <=>?) then the letter m forms a control sequence known as Select Graphic Rendition (SGR). If no parameter bytes are explicitly given, then it is assumed to be 0. SGR parameters can be chained together with a semicolon ; as delimiter.

Some common SGR parameters are shown below.

• Below example will print a red underlined text.

Usage

• Add the AnsiStream crate to your Cargo.toml

$ cargo add ansistream

• Initialize a buffer and write a simple string in it

// initialize an internal buffer with 30 bytes
let mut astream = ansistream::AnsiScapeStream::new(30);
// write a simple string in buffer
astream.write_string("the quick brown fox jumps over the lazy dog")?;

• Write the stream in stdout

fn flush<R: Read + Seek, W: Write>(reader: &mut R, writer: &mut) -> io::Result<()> {
    reader.seek(SeekFrom::Start(0))?;
    io::copy(reader, writer)?;
    reader.seek(SeekFrom::Start(0))?;

    Ok(())
}

let mut stdout = io::stdout().lock();

astream.write_string("simple text")?;
// AnsiScapeStream impl DerefMut
flush(&mut *astream, &mut stdout)?;

• Writing a green foreground text to stream

let mut astream = AnsiEscapeStream::default();
astream.write_text_fc(FCGREEN, "123").unwrap();
// asserts that fcfreen was writed and also reseted with fcdefault
assert_eq!(
    &[0x1b, 0x5b, 0x33, 0x32, 0x6d, 0x31, 0x32, 0x33, 0x1b, 0x5b, 0x33, 0x39, 0x6d],
    astream.get_ref().as_slice()
);

• Write formatted color output

let mut astream = AnsiEscapeStream::default();

  for i in 100..=107 {
      astream.write_text_color_fmt(FC_LIGHT_GRAY, i, format_args!("{i:>5} "))?;
  }

Examples

• 16color example

$ hyperfine --warmup 100 '16color'
Benchmark 1: 16color
  Time (mean ± σ):      10.9 ms ±   0.4 ms    [User: 5.7 ms, System: 9.3 ms]
  Range (min … max):    10.3 ms …  12.2 ms    133 runs

• 256color example

$ hyperfine --warmup 100 '256color'
Benchmark 1: 256color
  Time (mean ± σ):      11.3 ms ±   0.4 ms    [User: 4.9 ms, System: 9.3 ms]
  Range (min … max):    10.7 ms …  12.7 ms    130 runs

• truecolor example

$ hyperfine --warmup 100 'truecolor'
Benchmark 1: truecolor
  Time (mean ± σ):      11.2 ms ±   0.5 ms    [User: 5.4 ms, System: 9.2 ms]
  Range (min … max):    10.4 ms …  13.0 ms    131 runs

Status

Escape codes available

References

Ansi Escape Codes