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.

This crate uses the existing async_std::path::Path rather than having its own path type, however while async_std::path::Path is mostly just a pure datatype, it includes aliases for several async_std::fs functions. To preserve the capability-oriented interface, avoid using async_std::path::Path's canonicalize, read_link, read_dir, metadata, and symlink_metadata functions.

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.