Struct StdFs 

pub struct StdFs;

ReadStorage over the process filesystem (std::fs).

Reads only. The matching Storage implementation — everything that changes a byte — is prov-store’s, so this adapter is writable exactly when that crate is in the dependency graph.

The trait is async so that genuinely async backends (network, OPFS) fit; this adapter’s futures are immediately ready, so any executor — including the dependency-free crate::exec::block_on — drives them to completion in a single poll.

Trait Implementations

impl Clone for StdFs

fn clone(&self) -> StdFs

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for StdFs

impl Debug for StdFs

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for StdFs

fn default() -> StdFs

Returns the “default value” for a type.

impl ReadStorage for StdFs

async fn read(&self, path: &Path) -> Result<Vec<u8>, Error>

Read the entire contents of a file as bytes. Mirrors std::fs::read.

async fn read_to_string(&self, path: &Path) -> Result<String, Error>

Read the entire contents of a file as a string. Mirrors std::fs::read_to_string.

async fn read_dir(&self, path: &Path) -> Result<Vec<DirEntry>, Error>

Return the entries in a directory (non-recursive). Mirrors std::fs::read_dir, but yields a Vec since async iterators are not yet stable.

async fn metadata(&self, path: &Path) -> Result<Metadata, Error>

Return metadata about the entry at path. Mirrors std::fs::metadata; follows symlinks.

fn try_exists(&self, path: &Path) -> impl Future<Output = Result<bool, Error>>

Returns Ok(true) if the path exists, Ok(false) if it does not, and Err(_) if the check itself failed. Mirrors std::fs::try_exists.

impl Storage for StdFs

async fn write(&self, path: &Path, contents: &[u8]) -> Result<()>

Write a file, replacing it if it already exists. Mirrors std::fs::write.

async fn create_dir_all(&self, path: &Path) -> Result<()>

Create a directory and all missing parents. Mirrors std::fs::create_dir_all.

async fn remove_file(&self, path: &Path) -> Result<()>

Remove a regular file. Mirrors std::fs::remove_file.

async fn remove_dir_all(&self, path: &Path) -> Result<()>

Recursively remove a directory and its contents. Mirrors std::fs::remove_dir_all.

async fn rename(&self, from: &Path, to: &Path) -> Result<()>

Rename or move a file or directory. Mirrors std::fs::rename.

fn capabilities(&self) -> Capabilities

What durability guarantees this backend can make. Defaults to Capabilities::NONE — a backend promises a guarantee only by saying so, so an adapter that forgets to override this degrades to the most defensive path rather than to a false promise.

async fn sync(&self, path: &Path, need: Durability) -> Result<()>

Flush path — and nothing else — to the strength need asks for.

fn write_atomic( &self, path: &Path, contents: &[u8], ) -> impl Future<Output = Result<()>>

Replace path’s contents with contents atomically and durably: no observer — concurrent reader or post-crash survivor — ever sees a splice of old and new bytes, and once this returns the new contents outlive a power loss.