Struct TempFile 

pub struct TempFile { /* private fields */ }

Temporary file retaining the provider session until its lifecycle completes.

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())?;
assert_eq!(TempResourceState::Owned, temporary.state());
temporary.cleanup()?;
assert_eq!(TempResourceState::Cleaned, temporary.state());

Implementations

impl TempFile

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

Returns the temporary logical path.

pub const fn state(&self) -> TempResourceState

Returns the resource lifecycle state.

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

Persists this temporary file to target.

Parameters

• target: Destination path validated by the owning filesystem.
• options: Atomicity and publication requirements.

Returns

The provider-confirmed publication outcome.

Errors

Returns a typed failure for invalid lifecycle state, failed preflight, provider failure, or a provider contract violation.

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

Publishes this temporary file to the provider-generated target.

Returns

The provider-confirmed publication outcome and generated target.

Errors

Returns a typed failure when ownership is unavailable, provider publication fails, or the provider returns an invalid target.

pub fn cleanup(&mut self) -> FsResult<()>

Cleans the source and releases the session responsibility.

Errors

Returns an invalid-state error when cleanup is no longer legal, or the provider cleanup error when cleanup cannot be confirmed.

Trait Implementations

impl Debug for TempFile

fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult

Formats the value using the given formatter.

impl Drop for TempFile

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.