Enum StrictPathError 

pub enum StrictPathError {
    InvalidRestriction {
        restriction: PathBuf,
        source: Error,
    },
    PathEscapesBoundary {
        attempted_path: PathBuf,
        restriction_boundary: PathBuf,
    },
    PathResolutionError {
        path: PathBuf,
        source: Error,
    },
}

SUMMARY: Represent errors produced by boundary creation and strict/virtual path validation.

DETAILS: This error type is returned by operations that construct PathBoundary VirtualRoot or that compose StrictPath/VirtualPath via joins. Each variant carries enough context for actionable diagnostics while avoiding leaking unbounded path data into messages (we truncate long displays).

VARIANTS:

• InvalidRestriction: The boundary directory is missing, not a directory, or failed I/O checks.
• PathEscapesBoundary: A candidate path would resolve outside the boundary.
• PathResolutionError: Canonicalization or resolution failed (I/O error).

Variants

InvalidRestriction

SUMMARY: The boundary directory is invalid (missing, not a directory, or I/O error).

FIELDS:

• restriction (PathBuf): The attempted boundary path.
• source (std::io::Error): Underlying OS error that explains why the restriction is invalid.

Fields

restriction: PathBuf

source: Error

PathEscapesBoundary

SUMMARY: The attempted path would resolve outside the PathBoundary boundary.

FIELDS:

• attempted_path (PathBuf): The user-supplied or composed candidate.
• restriction_boundary (PathBuf): The effective boundary root.

Fields

attempted_path: PathBuf

restriction_boundary: PathBuf

PathResolutionError

SUMMARY: Canonicalization/resolution failed for the given path.

FIELDS:

• path (PathBuf): The path whose resolution failed.
• source (std::io::Error): Underlying I/O cause.

Fields

path: PathBuf

source: Error

Trait Implementations

impl Debug for StrictPathError

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

Formats the value using the given formatter.

impl Display for StrictPathError

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

Formats the value using the given formatter.

impl Error for StrictPathError

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.