Module cap_async_std::fs

A capability-oriented filesystem API modeled after async_std::fs.

This corresponds to async_std::fs.

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

Where async_std says "the filesystem", this API says "a filesystem", as it doesn't assume that there's a single global filesystem namespace.

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

Structs

Dir	A reference to an open directory on a 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 a filesystem.
FileType	A structure representing a type of file with accessors for each file type.
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.