Initial import of atty-0.2.14 am: 94f54147b0 am: 1cabb091a5 am: faf7e5a27c am: 10c4ddc5cb

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/atty/+/1620967

Change-Id: I2d4cc0dc27cdf7db43c2073e1376a6664b1122ba
tree: 454836b622e98ef51c0faec40dad2836c0cee672
  1. examples/
  2. src/
  3. .cargo_vcs_info.json
  4. .gitignore
  5. Cargo.toml
  6. Cargo.toml.orig
  7. CHANGELOG.md
  8. README.md
  9. rustfmt.toml
README.md

atty

Build Status Build status Coverage Status crates.io Released API docs Master API docs

are you or are you not a tty?

install

Add the following to your Cargo.toml

[dependencies]
atty = "0.2"

usage

use atty::Stream;

fn main() {
  if atty::is(Stream::Stdout) {
    println!("I'm a terminal");
  } else {
    println!("I'm not");
  }
}

testing

This library has been unit tested on both unix and windows platforms (via appveyor).

A simple example program is provided in this repo to test various tty's. By default.

It prints

$ cargo run --example atty
stdout? true
stderr? true
stdin? true

To test std in, pipe some text to the program

$ echo "test" | cargo run --example atty
stdout? true
stderr? true
stdin? false

To test std out, pipe the program to something

$ cargo run --example atty | grep std
stdout? false
stderr? true
stdin? true

To test std err, pipe the program to something redirecting std err

$ cargo run --example atty 2>&1 | grep std
stdout? false
stderr? false
stdin? true

Doug Tangren (softprops) 2015-2019