exact-reader

Crates.ioexact-reader
lib.rsexact-reader
version0.1.4
sourcesrc
created_at2023-07-27 21:20:22.901865
updated_at2023-11-21 12:59:29.818115
descriptionI/O buffering crate, supporting reservation-based reads and virtually-concatenated file handling.
homepage
repositoryhttps://github.com/i64/exact-reader
max_upload_size
id927881
size76,203
(i64)

documentation

README

exact-read

Documentation crates

The exact-read crate is an IO buffering library that provides reservation-based buffering for efficient data reading from files. Reservation-based buffering allows deciding buffer size hand at any time. That allows minimum I/O operation for expensive systems like networks. Additionally, the crate supports virtually-concatenated files, allowing separated files to be treated and seek/read as if they were concatenated into one continuous stream.

Since MultiFile, File, and ExactReader use and implement Seek + Read, these structs can be used separately without requiring them to be chained.

use std::io::{Cursor, Read};

use exact_reader::{MultiFile, File, ExactReader};

fn into_file(value: Cursor<Vec<u8>>) -> File<Cursor<Vec<u8>>> {
    let len = value.get_ref().len();
    File {
        file: value,
        size: len,
        filename: "cursor".to_string(),
    }
}

fn main() {
    let a: Cursor<Vec<u8>> = Cursor::new(vec![1u8, 2, 3]);
    let b: Cursor<Vec<u8>> = Cursor::new(vec![4u8, 5, 6]);

    let mut multifile = MultiFile::new(vec![into_file(a), into_file(b)]);
    let mut reader = ExactReader::new_multi(multifile);
    reader.reserve(6);

    let mut buf = [0u8; 4];
    reader.read(&mut buf).unwrap();
    
    assert_eq!(buf, [1, 2, 3, 4])
}
Commit count: 12

cargo fmt