Struct TestTempDir 

pub struct TestTempDir { /* private fields */ }

A uniquely named temporary directory backed by [TempDirGuard].

The directory name includes the process ID, a process-local counter, and the current timestamp so parallel test binaries and repeated runs do not share filesystem state. The utils-layer guard owns recursive cleanup, including early-return and panic paths.

Implementations

impl TestTempDir

pub fn new(scope: &str) -> Self

Creates an isolated directory under the platform temporary directory.

Panics

Panics when scope is invalid, the system clock predates the Unix epoch, or the directory cannot be created.

pub fn new_in(root: impl AsRef<Path>, scope: &str) -> Self

Creates an isolated directory below root.

This is useful when a test intentionally needs a path below the package directory, such as configuration tests that verify runtime-relative path rendering.

Panics

Panics when scope is invalid, the system clock predates the Unix epoch, or the directory cannot be created below root.

pub fn path(&self) -> &Path

Returns the owned temporary directory path.

pub fn join(&self, path: impl AsRef<Path>) -> PathBuf

Joins a test-owned relative path below the temporary directory.

Panics

Panics when path is absolute or contains a parent, root, or platform prefix component.

Trait Implementations

impl Debug for TestTempDir

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.