Struct AsyncTempDirectory 

pub struct AsyncTempDirectory(/* private fields */);

A facade-owned asynchronous temporary directory.

Examples

use qubit_fs::temp::{TempOptions, TempResourceState};

let mut temporary = filesystem.create_temp_directory(TempOptions::default()).await?;
temporary.cleanup().await?;
assert_eq!(TempResourceState::Cleaned, temporary.state());

Implementations

impl AsyncTempDirectory

pub const fn path(&self) -> &Path

Returns the provider-local temporary path.

Returns

The validated path supplied by the provider.

pub const fn state(&self) -> TempResourceState

Returns the current ownership lifecycle state.

Returns

The handle’s current cleanup and publication state.

pub fn child(&self, component: &PathComponent) -> Path

Returns one lexically safe child path.

pub fn descendant(&self, relative: &RelativePath) -> Path

Returns one lexically safe descendant path.

pub fn cleanup(&mut self) -> SpiFuture<'_, FsResult<()>>

Asynchronously confirms cleanup of this temporary directory.

Returns

A future resolving after provider cleanup is confirmed.

Errors

Resolves to an invalid-state error when cleanup is no longer legal, or to the provider cleanup failure.

pub fn keep(&mut self) -> SpiFuture<'_, Result<PersistOutcome, PersistFailure>>

Asynchronously publishes this directory to a generated target.

Returns

A future resolving to the confirmed publication outcome.

Errors

Resolves to an invalid-state error when the directory is no longer owned, or to the provider ownership-transfer failure.

pub fn persist<'a>( &'a mut self, target: &'a Path, options: PersistOptions, ) -> SpiFuture<'a, Result<PersistOutcome, PersistFailure>>

Asynchronously persists this directory to a validated destination.

Parameters

• target: Validated destination path.
• options: Persistence atomicity and publication requirements.

Returns

A future resolving to the confirmed persistence outcome.

Errors

Resolves to a typed failure for invalid lifecycle state, failed local preflight, provider failure, or provider contract violation.