Module io_providers::std_streams

Providers of input/output/error streams (i.e. stdin, stdout and stderr).

Examples

extern crate io_providers;

use std::io::Write;
use std::path::PathBuf;
use io_providers::std_streams::{NativeStdStreams, SimulatedStdStreams, StdStreams};

/// Takes input from stdin and prints it to stdout
fn passthrough<S: StdStreams>(streams: &mut S)  {
    let mut input = String::new();
    streams.input().read_to_string(&mut input).unwrap();
    write!(streams.output(), "{}", input);
}

fn main() {
    // Use a simulated stream provider to test `passthrough()`
    let mut simulated_streams = SimulatedStdStreams::new();
    simulated_streams.write_input("test".as_bytes());
    passthrough(&mut simulated_streams);
    let actual = ::std::str::from_utf8(simulated_streams.read_output()).unwrap();
    assert_eq!("test", actual);

    // Now use a standard stream provider here to interact with the real console
    let mut real_streams = NativeStdStreams::new();
    passthrough(&mut real_streams);
}

Structs

NativeStdStreams	Handles for the standard input streams of a process, using std::io.
SimulatedStdStreams	Simulated handles for the standard input streams of a process.

Traits

StdStreams

Provides access to input, output and error streams.