Struct AsyncTempFile 

pub struct AsyncTempFile { /* private fields */ }

A facade-owned asynchronous temporary file.

Examples

This example uses an isolated in-memory provider fixture.

use qubit_fs::temp::TempOptions;
use qubit_fs::temp::TempResourceState;

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

Implementations

impl AsyncTempFile

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 resource.

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 temporary resource to a generated target.

Returns

A future resolving to the provider’s confirmed publication outcome.

Errors

Resolves to an invalid-state error when the resource is no longer owned, or to the provider ownership-transfer failure. An invalid-state failure retains any previously confirmed publication target and recovery state.

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

Asynchronously persists this resource to a validated destination.

Parameters

• target: Validated destination path.
• options: Persistence atomicity and publication requirements.
• 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. Rejected repeated calls preserve the previously confirmed publication facts.

Trait Implementations

impl Drop for AsyncTempFile

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.