#shim #fs-file #io #write-file #redirect #disk #io-write

shim-fs

A drop-in replacement for std::fs::File that redirects all disk writes to memory

1 unstable release

0.1.0 Jan 6, 2022

#1513 in Filesystem

MIT license

12KB
131 lines

shim-fs

A (near) drop-in replacement for std::fs::File that redirects all disk writes to a memory buffer, with no dependencies. To be precise, the std::io::{Seek, Write} traits are implemented for shim_fs::File.

Possible use cases

This can be useful when third-party code writes something to disk, only for you to read it back into memory immediately afterwards: you still have to modify the third-party code, but if you're lucky (see below for details), you may have to only change a few lines.

Another possible use case is targeting WebAssembly, where normal disk writes are not possible.

A concrete use case scenario: imagine you are using a third-party code-generation crate. The generated code is always written to a file, but you want to further process it and therefore need it in memory. If the crate uses std::fs::File::create() to create the file and no functionality besides the Seek and Write traits is used, it is extremely easy to skip all the intermediate file system stuff and just obtain the written bytes in a buffer: replace the crate's std::fs::File::create() call with shim_fs::File::create() and call shim_fs::get_files() in your code after the third-party crate has done its work. Yes, it's that easy.

Example usage

The following example creates a regular file if the use-shim-fs feature is not enabled. If it is enabled, no file will be created and the writes to the File object will be redirected to memory instead. The contents of the shimmed file can be easily accessed.

#[cfg(feature = "use-shim-fs")]
use shim_fs::File;
#[cfg(not(feature = "use-shim-fs"))]
use std::fs::File;

use std::io::Write;
use std::path::Path;

fn main() {
    let path = Path::new("hello.txt");
    let mut file = File::create(path).unwrap();
    write!(file, "Hello, world!").unwrap();

    #[cfg(feature = "use-shim-fs")]
    {
        assert_eq!(shim_fs::get_files()[path], "Hello, world!".as_bytes())
    }
}

No runtime deps