#sockets #file-io #fd #cross-platform #io

stdio-override

Rust library for overriding Stdin/Stdout/Stderr with a different stream

5 releases

0.2.0 Jan 26, 2025
0.1.3 May 2, 2019
0.1.2 May 2, 2019
0.1.1 May 2, 2019
0.1.0 May 1, 2019

#214 in Rust patterns

Download history 634/week @ 2024-12-23 855/week @ 2024-12-30 1356/week @ 2025-01-06 1425/week @ 2025-01-13 1473/week @ 2025-01-20 1657/week @ 2025-01-27 1669/week @ 2025-02-03 1989/week @ 2025-02-10 1750/week @ 2025-02-17 1778/week @ 2025-02-24 1412/week @ 2025-03-03 1824/week @ 2025-03-10 1639/week @ 2025-03-17 1457/week @ 2025-03-24 1356/week @ 2025-03-31 1564/week @ 2025-04-07

6,072 downloads per month
Used in 6 crates

MIT/Apache

27KB
474 lines

stdio-override

Build Status Latest version Documentation License

A Rust library to easily override Stdio streams in Rust. It works on Unix and Windows platforms.

Usage

Add this to your Cargo.toml:

[dependencies]
stdio-override = "0.1"

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

extern crate stdio_override;

In Rust Edition 2018 you can simply do:

use stdio_override::*;

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

use std::{fs::{read_to_string, remove_file}, io};
use stdio_override::StdoutOverride;

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

    let guard = StdoutOverride::from_file(file_name)?;
    println!("some output");
    drop(guard);

    let contents = read_to_string(file_name)?;
    assert_eq!("some output\n", contents);
    println!("Outside!");
    remove_file(file_name)?;
    Ok(())
}

On Unix(Linux/MacOS etc.) you can also do the same with sockets:


use std::{
    io::Read,
    net::{TcpListener, TcpStream},
};
use stdio_override::StdoutOverride;

#[cfg(unix)]
fn main() {
    let address = ("127.0.0.1", 5543);

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

    let guard = StdoutOverride::from_io(socket).unwrap();
    println!("12345");
    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!");
}
#[cfg(not(unix))]
fn main() {}

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

use std::{fs::File, io::{self, Write}};
use stdio_override::StdinOverride;

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

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

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

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

    drop(guard);

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

Dependencies

~220KB