Struct Files 

pub struct Files<'a> { /* private fields */ }

The ergonomic files accessor returned by Sandbox::files().

Implementations

impl<'a> Files<'a>

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

Read a file’s raw bytes. It reads in 4 MiB chunks (download), so a large file never travels as one frame; a guest image that predates fs.download is read in one frame (fs.read).

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

Read a whole file in 4 MiB chunks (fs.download) until the guest reports the end.

pub async fn upload( &self, path: &str, data: impl AsRef<[u8]>, ) -> Result<(), SolariError>

Write data to a file in 4 MiB chunks (fs.upload): the first call truncates, later calls append at their offset. An empty file is one zero-length call. Unlike write there is no size limit.

pub async fn read_text(&self, path: &str) -> Result<String, SolariError>

Read a file as UTF-8 text.

pub async fn write( &self, path: &str, data: impl AsRef<[u8]>, mode: Option<i64>, ) -> Result<(), SolariError>

Write bytes to a file (fs.write). mode is an optional unix mode. The data travels as one frame, so more than 32 MiB is refused before anything is sent (a frame that large would close the control channel and fail every call on it): use upload.

pub async fn list(&self, path: &str) -> Result<Vec<FsEntry>, SolariError>

List a directory (fs.list).

pub async fn stat(&self, path: &str) -> Result<FsStat, SolariError>

Stat a path (fs.stat).

pub async fn mkdir(&self, path: &str) -> Result<(), SolariError>

Create a directory and parents (fs.mkdir).

pub async fn remove( &self, path: &str, recursive: bool, ) -> Result<(), SolariError>

Remove a path (fs.remove); recursive for directories.

pub async fn rename(&self, from: &str, to: &str) -> Result<(), SolariError>

Rename/move a path (fs.rename).