Struct cargo::util::Filesystem
source ·
[−]pub struct Filesystem { /* private fields */ }
Expand description
A “filesystem” is intended to be a globally shared, hence locked, resource in Cargo.
The Path
of a filesystem cannot be learned unless it’s done in a locked
fashion, and otherwise functions on this structure are prepared to handle
concurrent invocations across multiple instances of Cargo.
Implementations
Creates a new filesystem to be rooted at the given path.
Like Path::join
, creates a new filesystem rooted at this filesystem
joined with the given path.
Like Path::push
, pushes a new path component onto this filesystem.
Consumes this filesystem and returns the underlying PathBuf
.
Note that this is a relatively dangerous operation and should be used with great caution!.
Returns the underlying Path
.
Note that this is a relatively dangerous operation and should be used with great caution!.
Creates the directory pointed to by this filesystem.
Handles errors where other Cargo processes are also attempting to concurrently create this directory.
Returns an adaptor that can be used to print the path of this filesystem.
Opens exclusive access to a file, returning the locked version of a file.
This function will create a file at path
if it doesn’t already exist
(including intermediate directories), and then it will acquire an
exclusive lock on path
. If the process must block waiting for the
lock, the msg
is printed to config
.
The returned file can be accessed to look at the path and also has read/write access to the underlying file.
Opens shared access to a file, returning the locked version of a file.
This function will fail if path
doesn’t already exist, but if it does
then it will acquire a shared lock on path
. If the process must block
waiting for the lock, the msg
is printed to config
.
The returned file can be accessed to look at the path and also has read access to the underlying file. Any writes to the file will return an error.
Trait Implementations
Auto Trait Implementations
impl RefUnwindSafe for Filesystem
impl Send for Filesystem
impl Sync for Filesystem
impl Unpin for Filesystem
impl UnwindSafe for Filesystem
Blanket Implementations
Mutably borrows from an owned value. Read more