#unix #sockets #fd #file #io

stdio-override

Rust library for overriding Stdin/Stdout/Stderr with a different File Descriptor

4 releases

0.1.3 May 2, 2019
0.1.2 May 2, 2019
0.1.1 May 2, 2019
0.1.0 May 1, 2019

#388 in Unix APIs

Download history 739/week @ 2023-10-27 823/week @ 2023-11-03 678/week @ 2023-11-10 455/week @ 2023-11-17 426/week @ 2023-11-24 638/week @ 2023-12-01 618/week @ 2023-12-08 414/week @ 2023-12-15 269/week @ 2023-12-22 468/week @ 2023-12-29 537/week @ 2024-01-05 451/week @ 2024-01-12 416/week @ 2024-01-19 382/week @ 2024-01-26 598/week @ 2024-02-02 497/week @ 2024-02-09

1,981 downloads per month
Used in 3 crates

MIT/Apache

15KB
168 lines

stdio-override

Build Status Latest version Documentation License

A Rust library to easily override Stdio file descriptors in Rust

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, io};
use stdio_override::StdoutOverride;

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

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

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

You can do the same with sockets:

use std::{
    io::Read,
    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");
    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:

use std::{fs::{File, read_to_string}, 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::override_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

~45KB