9 releases

new 0.2.0 May 20, 2024
0.1.0 Dec 6, 2023
0.0.8 Jun 24, 2023

#428 in Filesystem

30 downloads per month
Used in yeet-yoink

EUPL-1.2

35KB
635 lines

Shared Files

Disk-Based Single-Writer, Multiple-Reader In-Process File Sharing


Crates.io Crates.io codecov

Functionality for asynchronous single-writer, multiple-reader file operations where multiple concurrent readers need to read from a file that is currently being written by the same process. The intended use case is the parallel processing of byte streams with minimum (process) memory requirements, e.g. in web services moving around large files.

Normally, reading a file while it is written results in the read stream ending prematurely as EOF; the purpose of this crate is to prevent exactly that.

Any file type can be used as a backing as long as it implements the crate's SharedFileType trait, which in turn requires tokio::io::AsyncWrite and tokio::io::AsyncRead.

Features

  • async-tempfile: Enables the SharedTemporaryFile type via the async-tempfile crate. Since this is how this crate was initially meant to be used, this feature is enabled by default.

Example

See tests/parallel_write_read.rs for a usage example. The example requires the async-tempfile crate feature. To run it, use e.g.

cargo test --test parallel_write_read --features=async-tempfile

Dependencies

~2.7–4.5MB
~74K SLoC