Crate anstream

source ·
Expand description

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.

Available styling crates:

  • anstyle for minimal runtime styling, designed to go in public APIs (once it hits 1.0)
  • owo-colors for feature-rich runtime styling
  • color-print for feature-rich compile-time styling

§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

Re-exports§

  • pub use buffer::Buffer;
    Deprecated

Modules§

  • Gracefully degrade styled output
  • Higher-level traits to describe writeable streams

Macros§

Structs§

Enums§

  • Selection for overriding color output Selection for overriding color output

Functions§

  • stderrauto
    Create an ANSI escape code compatible stderr
  • stdoutauto
    Create an ANSI escape code compatible stdout

Type Aliases§