Module wasi_common::fs

A very experimental module modeled providing a high-level and safe filesystem interface, modeled after std::fs, implemented on top of WASI functions.

Most functions in this API are not yet implemented!

This corresponds to std::fs.

Instead of std::fs's free functions which operate on paths, this crate has methods on Dir which operate on paths which must be relative to and within the directory.

Since all functions which expose raw file descriptors are unsafe, I/O handles in this API are unforgeable (unsafe code notwithstanding). This combined with WASI's lack of absolute paths provides a natural capability-oriented interface.

Structs

Dir	A reference to an open directory on the filesystem.
DirBuilder	A builder used to create directories in various manners.
DirEntry	Entries returned by the ReadDir iterator.
File	A reference to an open file on the filesystem.
FileType	A structure representing a type of file with accessors for each file type. It is returned by Metadata::file_type method.
Metadata	Metadata information about a file.
OpenOptions	Options and flags which can be used to configure how a file is opened.
Permissions	Representation of the various permissions on a file.
ReadDir	Iterator over the entries in a directory.