#read-write #tee #io-read #reader-writer #mirror #another #posix

tee_readwrite

Simple TeeReader/TeeWriter types for duplicating reads/writes to std::io::{Read,Write} types

2 unstable releases

0.2.0 Aug 16, 2023
0.1.0 Jul 30, 2019

#757 in Rust patterns

Download history 60/week @ 2024-01-04 80/week @ 2024-01-11 92/week @ 2024-01-18 201/week @ 2024-01-25 74/week @ 2024-02-01 40/week @ 2024-02-08 102/week @ 2024-02-15 155/week @ 2024-02-22 84/week @ 2024-02-29 81/week @ 2024-03-07 131/week @ 2024-03-14 130/week @ 2024-03-21 146/week @ 2024-03-28 108/week @ 2024-04-04 129/week @ 2024-04-11 118/week @ 2024-04-18

510 downloads per month
Used in 2 crates

0BSD license

7KB
74 lines

tee_readwrite

tee_readwrite

This module allows you to mirror read/writes to another read/write (like POSIX tee)

Examples

TeeReader

use tee_readwrite::{TeeReader, TeeWriter};
// make a new reader
let reader = std::io::Cursor::new(vec![1,2,3]);
let mut tee = TeeReader::new(
    reader,
    vec![], // vec implements write
    false   // we don't care about flushing here
);

// read all of the elements from the cursor into this vec
// each 'read' call will be written to the wrapped writer
let mut results = vec![];
assert_eq!(tee.read_to_end(&mut results).expect("read"), 3);

// consume the tee, returning the reader and the mirroring writer
let (_read, output) = tee.into_inner();
assert_eq!(results, output);

TeeWriter

use tee_readwrite::{TeeReader, TeeWriter};
let writer = vec![];
let mut tee = TeeWriter::new(writer, vec![]);
for i in 1..=3 {
    let _ = tee.write_all(&[i]);
}
// we can borrow the output writer
assert_eq!(tee.borrow_output(), &[1,2,3]);

// consume the tee, returning the writer and its tee output
let (left, output) = tee.into_inner();
assert_eq!(left, output);
assert_eq!(output, &[1,2,3]);

License: 0BSD

No runtime deps