4 releases

Uses old Rust 2015

0.2.1 Jan 14, 2025
0.2.0 Aug 9, 2023
0.1.2 Aug 8, 2023
0.1.1 Aug 24, 2021
0.1.0 Feb 2, 2018

#25 in Command-line interface

Download history 152299/week @ 2025-01-09 145844/week @ 2025-01-16 151265/week @ 2025-01-23 155381/week @ 2025-01-30 208499/week @ 2025-02-06 238437/week @ 2025-02-13 330720/week @ 2025-02-20 311580/week @ 2025-02-27 252539/week @ 2025-03-06 190096/week @ 2025-03-13 293338/week @ 2025-03-20 166672/week @ 2025-03-27 200212/week @ 2025-04-03 174167/week @ 2025-04-10 167736/week @ 2025-04-17 130693/week @ 2025-04-24

702,980 downloads per month
Used in 586 crates (190 directly)

Apache-2.0/MIT

10KB
126 lines

Continuous integration crates.io

A crate for stripping ANSI escape sequences from byte sequences.

This can be used to take output from a program that includes escape sequences and write it somewhere that does not easily support them, such as a log file.

Examples

The strip function accepts bytes and returns a Vec of bytes with ANSI escape sequences removed.

extern crate strip_ansi_escapes;

use std::io::{self, Write};

fn work() -> io::Result<()> {
  let bytes_with_colors = b"\x1b[32mfoo\x1b[m bar";
  let plain_bytes = strip_ansi_escapes::strip(&bytes_with_colors);
  io::stdout().write_all(&plain_bytes)?;
  Ok(())
}

fn main() {
    work().unwrap();
}

For writing directly to a writer, the Writer struct may be preferable.

extern crate strip_ansi_escapes;

use std::io::{self, Write};
use strip_ansi_escapes::Writer;

fn work() -> io::Result<()> {
  let bytes_with_colors = b"\x1b[32mfoo\x1b[m bar";
  let mut writer = Writer::new(io::stdout());
  // Only `foo bar` will be written to stdout
  writer.write_all(bytes_with_colors)?;
  Ok(())
}

fn main() {
    work().unwrap();
}

License

Licensed under either of

at your option.

Dependencies

~245–385KB