Struct OpenFailure 

pub struct OpenFailure<R> { /* private fields */ }

A failed open with its causal error and optional isolated recovery session.

R owns only explicit cleanup authority. Keep this error or take its recovery session before reporting failure. Dropping the error does not confirm cleanup. There is deliberately no conversion into FsError that discards recovery.

Examples

use qubit_fs::error::{FsError, FsErrorKind, FsOperation, OpenFailure, OpenFailureStage};

assert!(std::any::type_name::<OpenFailure<()>>().contains("OpenFailure"));
let error = FsError::new(FsErrorKind::NotFound, FsOperation::OpenReader, "missing");
assert_eq!(FsOperation::OpenReader, error.operation());
assert_eq!(OpenFailureStage::Preflight, OpenFailureStage::Preflight);

Implementations

impl<R> OpenFailure<R>

pub const fn error(&self) -> &FsError

Returns the original failure; cleanup does not rewrite it.

pub const fn stage(&self) -> OpenFailureStage

Returns the stage where opening stopped.

pub const fn recovery(&self) -> Option<&R>

Returns the retained recovery session, or None before an envelope arrived.

pub fn recovery_mut(&mut self) -> Option<&mut R>

Borrows the retained session for explicit cleanup, when available.

pub fn take_recovery(&mut self) -> Option<R>

Transfers recovery ownership without changing the historical failure.

pub fn into_parts(self) -> (FsError, OpenFailureStage, Option<R>)

Returns all failure facts and transfers any recovery ownership.

Returns

The original error, opening stage, and optional retained recovery session.

Trait Implementations

impl<R> Debug for OpenFailure<R>

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

Formats failure facts without formatting the session or its claimed identity.

impl<R> Display for OpenFailure<R>

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

Formats only the original contextual failure.

impl<R: 'static> Error for OpenFailure<R>

fn source(&self) -> Option<&(dyn Error + 'static)>

Exposes the original error chain without surrendering recovery ownership.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.