[−][src]Crate fused_reader
When working with data pipes it is often necessary to distinguish between EOF on the reader side caused by writer thread finishing write and writer panicking. This crate provides fused reader type that if writer thread dies while holding armed fuse the reader will get BrokenPipe
error.
Fuses can also be blown with custom error that is passed to the reader end.
Example usage
Writer panics and reader gets BrokenPipe
error.
use pipe::pipe; use fused_reader::fuse; use std::io::{Read, Write, ErrorKind}; use std::thread; let (reader, mut writer) = pipe(); let (mut reader, fuse) = fuse(reader); thread::spawn(move || { let _fuse = fuse.arm().unwrap(); writer.write(&[1]).unwrap(); panic!("boom"); }); let mut data = Vec::new(); assert_eq!(reader.read_to_end(&mut data).unwrap_err().kind(), ErrorKind::BrokenPipe); assert_eq!(&data, &[1]); // data that was written before panic
Writer fails with error passed to reader.
use pipe::pipe; use fused_reader::fuse; use std::io::{Read, Write, Error as IoError, ErrorKind}; use std::thread; let (reader, mut writer) = pipe(); let (mut reader, fuse) = fuse(reader); thread::spawn(move || { let fuse = fuse.arm().unwrap(); writer.write(&[1]).unwrap(); fuse.blow(IoError::new(ErrorKind::UnexpectedEof, "uh! oh!")) }); let mut data = Vec::new(); assert_eq!(reader.read_to_end(&mut data).unwrap_err().kind(), ErrorKind::UnexpectedEof); assert_eq!(&data, &[1]); // data that was written before error
Structs
Fuse | Fuse that can be armed. |
FuseGuard | Armed fuse that if dropped due to panic will signal reader to fail with |
FusedReader | Reader that will fail with I/O error if fuse was blown. |
Enums
FuseStatus | Status of the fuse. |
Functions
fuse | Fuses reader so that if writer thread dies while holding armed fuse the reader will get |