Crate anstream

Auto-adapting stdout / stderr streams

A portmanteau of “ansi stream”

AutoStream always accepts ANSI escape codes, adapting to the user’s terminal’s capabilities.

Benefits

• Allows the caller to not be concerned with the terminal’s capabilities
• Semver safe way of passing styled text between crates as ANSI escape codes offer more compatibility than most crate APIs.

Example

use anstream::println;
use owo_colors::OwoColorize as _;

// Foreground colors
println!("My number is {:#x}!", 10.green());
// Background colors
println!("My number is not {}!", 4.on_red());

And this will correctly handle piping to a file, etc

Modules

• adapter
  Gracefully degrade styled output

Macros

• eprintauto
  Prints to stderr.
• eprintlnauto
  Prints to stderr, with a newline.
• panicauto
  Panics the current thread.
• printauto
  Prints to stdout.
• printlnauto
  Prints to stdout, with a newline.

Structs

• AutoStream
  std::io::Write that adapts ANSI escape codes to the underlying Writes capabilities
• Buffer
  In-memory RawStream
• StripStream
  Only pass printable data to the inner Write

Enums

• ColorChoiceauto
  Selection for overriding color output with force_color Selection for overriding color output with set

Traits

• Lockable
  Explicitly lock a std::io::Writeable
• RawStreamauto and not (Windows and wincon)
  Required functionality for underlying std::io::Write for adaptation

Functions

• force_colorauto
  Override the detected ColorChoice
• stderrauto
  Create an ANSI escape code compatible stderr
• stdoutauto
  Create an ANSI escape code compatible stdout