Struct cap_tempfile::TempDir [−][src]
pub struct TempDir { /* fields omitted */ }
Expand description
A directory in a filesystem that is automatically deleted when it goes out of scope.
This corresponds to tempfile::TempDir
.
Unlike tempfile::TempDir
, this API has no TempDir::path
,
TempDir::into_path
, or impl AsRef<Path>
, because absolute paths don’t
interoperate well with the capability model.
Implementations
Attempts to make a temporary directory inside of env::temp_dir()
.
This corresponds to tempfile::TempDir::new
.
Ambient Authority
This function makes use of ambient authority to access temporary directories.
Create a new temporary directory.
This corresponds to tempfile::TempDir::new_in
.
Closes and removes the temporary directory, returning a Result
.
This corresponds to tempfile::TempDir::close
.
Methods from Deref<Target = Dir>
Attempts to open a file in read-only mode.
This corresponds to std::fs::File::open
, but only accesses paths
relative to self
.
Opens a file at path
with the options specified by options
.
This corresponds to std::fs::OpenOptions::open
.
Instead of being a method on OpenOptions
, this is a method on Dir
,
and it only accesses paths relative to self
.
Attempts to open a directory.
Creates a new, empty directory at the provided path.
This corresponds to std::fs::create_dir
, but only accesses paths
relative to self
.
Recursively create a directory and all of its parent components if they are missing.
This corresponds to std::fs::create_dir_all
, but only accesses
paths relative to self
.
Creates the specified directory with the options configured in this builder.
This corresponds to std::fs::DirBuilder::create
.
Opens a file in write-only mode.
This corresponds to std::fs::File::create
, but only accesses paths
relative to self
.
Returns the canonical form of a path with all intermediate components normalized and symbolic links resolved.
This corresponds to std::fs::canonicalize
, but instead of returning
an absolute path, returns a path relative to the directory
represented by self
.
Copies the contents of one file to another. This function will also copy the permission bits of the original file to the destination file.
This corresponds to std::fs::copy
, but only accesses paths
relative to self
.
Creates a new hard link on a filesystem.
This corresponds to std::fs::hard_link
, but only accesses paths
relative to self
.
Given a path, query the file system to get information about a file, directory, etc.
This corresponds to std::fs::metadata
, but only accesses paths
relative to self
.
Queries metadata about the underlying directory.
This is similar to std::fs::File::metadata
, but for Dir
rather
than for File
.
Returns an iterator over the entries within self
.
Returns an iterator over the entries within a directory.
This corresponds to std::fs::read_dir
, but only accesses paths
relative to self
.
Read the entire contents of a file into a bytes vector.
This corresponds to std::fs::read
, but only accesses paths
relative to self
.
Reads a symbolic link, returning the file that the link points to.
This corresponds to std::fs::read_link
, but only accesses paths
relative to self
.
Read the entire contents of a file into a string.
This corresponds to std::fs::read_to_string
, but only accesses
paths relative to self
.
Removes an empty directory.
This corresponds to std::fs::remove_dir
, but only accesses paths
relative to self
.
Removes a directory at this path, after removing all its contents. Use carefully!
This corresponds to std::fs::remove_dir_all
, but only accesses
paths relative to self
.
Removes a file from a filesystem.
This corresponds to std::fs::remove_file
, but only accesses paths
relative to self
.
Rename a file or directory to a new name, replacing the original file if to already exists.
This corresponds to std::fs::rename
, but only accesses paths
relative to self
.
Changes the permissions found on a file or a directory.
This corresponds to std::fs::set_permissions
, but only accesses
paths relative to self
. Also, on some platforms, this function
may fail if the file or directory cannot be opened for reading or
writing first.
Query the metadata about a file without following symlinks.
This corresponds to std::fs::symlink_metadata
, but only accesses
paths relative to self
.
Write a slice as the entire contents of a file.
This corresponds to std::fs::write
, but only accesses paths
relative to self
.
Creates a new file symbolic link on a filesystem.
This corresponds to std::os::windows::fs::symlink_file
, but only
accesses paths relative to self
.
Creates a new directory symlink on a filesystem.
This corresponds to std::os::windows::fs::symlink_dir
, but only
accesses paths relative to self
.
Creates a new Dir
instance that shares the same underlying file
handle as the existing Dir
instance.
Returns true
if the path points at an existing entity.
This corresponds to std::path::Path::exists
, but only
accesses paths relative to self
.
Returns true
if the path exists on disk and is pointing at a regular
file.
This corresponds to std::path::Path::is_file
, but only
accesses paths relative to self
.
Checks if path
is a directory.
This is similar to std::path::Path::is_dir
in that it checks if
path
relative to Dir
is a directory. This function will
traverse symbolic links to query information about the destination
file. In case of broken symbolic links, this will return false
.
Constructs a new instance of Self
by opening the parent directory
(aka “..”) of self
, using the host process’ ambient authority.
Ambient Authority
This function accesses a directory outside of the self
subtree.