stdio-override

A Rust library to easily override Stdio file descriptors in Rust

• Documentation

Usage

Add this to your Cargo.toml:

```toml [dependencies] stdio-override = "0.1"

```

and for Rust Edition 2015 add this to your crate root:

rust extern crate stdio_override; In Rust Edition 2018 you can simply do: rust use stdio_override::*;

Here's an example on how to write stdout into a file:

```rust use std::{fs::readtostring, mem, io}; use stdio_override::StdoutOverride;

fn main() -> io::Result<()> { let filename = "./readmetest.txt";

let guard = StdoutOverride::override_file(file_name)?;
println!("12345");
mem::drop(guard);

let contents = read_to_string(file_name)?;
assert_eq!("12345\n", contents);
println!("Outside!");
Ok(())

} ```

You can do the same with sockets: ```rust use std::{ io::Read, mem, net::{TcpListener, TcpStream}, }; use stdio_override::StdoutOverride;

fn main() { let address = ("127.0.0.1", 5543);

let listener = TcpListener::bind(address).unwrap();
let socket = TcpStream::connect(address).unwrap();

let guard = StdoutOverride::override_raw(socket).unwrap();
println!("12345");
mem::drop(guard);

let mut contents = String::new();
let (mut stream, _) = listener.accept().unwrap();
stream.read_to_string(&mut contents).unwrap();

assert_eq!("12345\n", contents);

println!("Outside!");

} ```

Both will work the same for Stderr and if you want to input Stdin from a file/socket you can do the following:

```rust use std::{fs::{File, readtostring}, mem, io::{self, Write}}; use stdio_override::StdinOverride;

fn main() -> io::Result<()> { let filename = "./testinputs.txt";

{
    let mut file = File::create(&file_name)?;
    file.write_all(b"Data")?;
}

let guard = StdinOverride::override_file(file_name)?;

let mut inputs = String::new();
io::stdin().read_line(&mut inputs)?;

mem::drop(guard);

assert_eq!("Data", inputs);
// Stdin is working as usual again, because the guard is dropped.
Ok(())

} ```