[−][src]Struct assert_fs::fixture::TempDir
A directory in the filesystem that is automatically deleted when it goes out of scope.
The TempDir
type creates a directory on the file system that
is deleted once it goes out of scope. At construction, the
TempDir
creates a new directory with a randomly generated name.
The constructor, TempDir::new()
, creates directories in
the location returned by std::env::temp_dir()
.
After creating a TempDir
, work with the file system by doing
standard std::fs
file system operations on its Path
,
which can be retrieved with TempDir::path()
. Once the TempDir
value is dropped, the directory at the path will be deleted, along
with any files and directories it contains. It is your responsibility
to ensure that no further file system operations are attempted
inside the temporary directory once it has been deleted.
Resource Leaking
Various platform-specific conditions may cause TempDir
to fail
to delete the underlying directory. It's important to ensure that
handles (like File
and ReadDir
) to files inside the
directory are dropped before the TempDir
goes out of scope. The
TempDir
destructor will silently ignore any errors in deleting
the directory; to instead handle errors call TempDir::close()
.
Note that if the program exits before the TempDir
destructor is
run, such as via std::process::exit()
, by segfaulting, or by
receiving a signal like SIGINT
, then the temporary directory
will not be deleted.
Examples
Create a temporary directory with a generated name:
use assert_fs::fixture::TempDir; let tmp_dir = TempDir::new().unwrap(); // Ensure deletion happens. tmp_dir.close().unwrap();
Methods
impl TempDir
[src]
impl TempDir
pub fn new() -> Result<Self, FixtureError> | [src] |
Attempts to make a temporary directory inside of env::temp_dir()
.
The directory and everything inside it will be automatically deleted
once the returned TempDir
is destroyed.
Errors
If the directory can not be created, Err
is returned.
Examples
use assert_fs::fixture::TempDir; let tmp_dir = TempDir::new().unwrap(); // Ensure deletion happens. tmp_dir.close().unwrap();
pub fn persist_if(self, yes: bool) -> Self | [src] |
Conditionally persist the temporary directory for debug purposes.
Examples
use assert_fs::fixture::TempDir; let tmp_dir = TempDir::new().unwrap().persist_if(true); // Ensure deletion happens. tmp_dir.close().unwrap();
pub fn path(&self) -> &Path | [src] |
Accesses the Path
to the temporary directory.
Examples
use assert_fs::fixture::TempDir; let tmp_dir = TempDir::new().unwrap(); println!("{}", tmp_dir.path().display()); // Ensure deletion happens. tmp_dir.close().unwrap();
pub fn close(self) -> Result<(), FixtureError> | [src] |
Closes and removes the temporary directory, returing a Result
.
Although TempDir
removes the directory on drop, in the destructor
any errors are ignored. To detect errors cleaning up the temporary
directory, call close
instead.
Errors
This function may return a variety of std::io::Error
s that result from deleting
the files and directories contained with the temporary directory,
as well as from deleting the temporary directory itself. These errors
may be platform specific.
Examples
use assert_fs::fixture::TempDir; let tmp_dir = TempDir::new().unwrap(); // Ensure deletion happens. tmp_dir.close().unwrap();
Trait Implementations
Auto Trait Implementations
Blanket Implementations
impl<T> From for T
[src]
impl<T> From for T
impl<T, U> Into for T where
U: From<T>,
[src]
impl<T, U> Into for T where
U: From<T>,
impl<T, U> TryFrom for T where
T: From<U>,
[src]
impl<T, U> TryFrom for T where
T: From<U>,
type Error = !
try_from
)The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error> | [src] |
impl<T> Borrow for T where
T: ?Sized,
[src]
impl<T> Borrow for T where
T: ?Sized,
impl<T> BorrowMut for T where
T: ?Sized,
[src]
impl<T> BorrowMut for T where
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T | [src] |
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
try_from
)The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error> | [src] |
impl<T> Any for T where
T: 'static + ?Sized,
[src]
impl<T> Any for T where
T: 'static + ?Sized,
fn get_type_id(&self) -> TypeId | [src] |