Struct FileSystem 

pub struct FileSystem { /* private fields */ }

Read and write files inside a running microVM.

let sbx = Sandbox::get("web")?;
sbx.fs().write_file("/app/main.py", b"print('hi')")?;
let out = sbx.fs().read_to_string("/app/out.json")?;
sbx.fs().upload("./src", "/app/src")?;
sbx.fs().download("/app/dist", "./dist", true)?;

Implementations

impl FileSystem

pub fn write_file(&self, path: &str, data: &[u8]) -> Result<()>

Write data to path in the guest, creating parent directories.

pub fn read_file(&self, path: &str) -> Result<Vec<u8>>

Read path from the guest as bytes.

pub fn read_to_string(&self, path: &str) -> Result<String>

Read path from the guest and decode it as UTF-8 (lossily).

pub fn upload( &self, local_path: impl AsRef<Path>, remote_path: &str, ) -> Result<()>

Copy a host file or directory into the guest. A directory’s contents land in remote_path, so upload("./src", "/app/src") leaves the guest’s /app/src holding what ./src holds.

Whether it recurses is decided by looking at local_path, so callers do not have to say which kind of thing they are copying.

pub fn download( &self, remote_path: &str, local_path: impl AsRef<Path>, recursive: bool, ) -> Result<()>

Copy a file or directory out of the guest onto the host. recursive selects a directory; unlike upload it cannot be detected here, because the path lives in the guest and answering would cost an extra round trip.