Struct FsError 

pub struct FsError {
    pub kind: FsErrorKind,
    pub operation: FsOperation,
    pub path: Option<Box<FsPath>>,
    pub target: Option<Box<FsPath>>,
    pub provider: Option<Box<str>>,
    pub message: Box<str>,
    pub source: Option<Box<dyn Error + Send + Sync + 'static>>,
}

Provider-neutral filesystem error with operation and path context.

Fields

kind: FsErrorKind

Error category.

operation: FsOperation

Operation that produced the error.

path: Option<Box<FsPath>>

Primary path involved in the operation.

target: Option<Box<FsPath>>

Secondary path involved in the operation.

provider: Option<Box<str>>

Provider id or alias involved in the operation.

message: Box<str>

Human-readable error message.

source: Option<Box<dyn Error + Send + Sync + 'static>>

Lower-level source error.

Implementations

impl FsError

pub fn new(kind: FsErrorKind, operation: FsOperation, message: &str) -> Self

Creates a filesystem error without path or provider context.

Parameters

• kind: Provider-neutral error category.
• operation: Operation that produced the error.
• message: Human-readable diagnostic message.

Returns

New filesystem error.

pub fn with_source<E>( kind: FsErrorKind, operation: FsOperation, message: &str, source: E, ) -> Self

where E: Error + Send + Sync + 'static,

Creates a filesystem error that wraps a lower-level source error.

Parameters

• kind: Provider-neutral error category.
• operation: Operation that produced the error.
• message: Human-readable diagnostic message.
• source: Lower-level error to preserve.

Returns

New filesystem error with source context.

pub fn with_path(self, path: FsPath) -> Self

Adds primary path context.

Parameters

• path: Primary path involved in the operation.

Returns

Updated filesystem error.

pub fn with_target(self, target: FsPath) -> Self

Adds secondary target path context.

Parameters

• target: Secondary path involved in the operation.

Returns

Updated filesystem error.

pub fn with_provider(self, provider: &str) -> Self

Adds provider context.

Parameters

• provider: Provider id or alias involved in the operation.

Returns

Updated filesystem error.

pub fn invalid_path(operation: FsOperation, message: &str) -> Self

Creates an invalid-path error.

Parameters

• operation: Operation that rejected the path.
• message: Human-readable reason.

Returns

Invalid-path filesystem error.

pub fn kind(&self) -> FsErrorKind

Gets the error kind.

Returns

Error category.

Trait Implementations

impl Debug for FsError

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

Formats the value using the given formatter.

impl Display for FsError

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

Formats the value using the given formatter.

impl Error for FsError

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

Returns the lower-level source of this error, if any.

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.