Enum PathsError 

pub enum PathsError {
    NoHomeDirectory,
    Create {
        purpose: &'static str,
        path: PathBuf,
        source: Error,
    },
    ParentDenies {
        purpose: &'static str,
        path: PathBuf,
        parent_state: String,
        source: Error,
    },
}

Something went wrong resolving or creating an application-data directory.

Variants

NoHomeDirectory

The operating system reported no home directory for this account.

Create

A directory could not be created.

Fields

purpose: &'static str

Which of the four directories failed.

path: PathBuf

The path that could not be created.

source: Error

The underlying filesystem error.

ParentDenies

A directory could not be created because its parent refused.

Split out from PathsError::Create because the message a bare EACCES produces is a dead end. It names the leaf, and the leaf is not the obstacle: it does not exist yet, so it cannot be what refused. mkdir(2) reports EACCES about the parent, and the parent here is one of the shared directories this program deliberately does not tighten – ~/.local, ~/.config, or whatever the account’s application-data root resolves under. An operator handed the leaf path goes and looks at a directory that is not there.

Nothing about the permission policy changes on the strength of this. Parents are still not this program’s to tighten, and this still fails rather than widening anything. The diagnosis is the whole of the remedy: say which directory refused and what state it is in, so the operator can decide.

Fields

purpose: &'static str

Which of the four directories failed.

path: PathBuf

The leaf that could not be created. The directory that actually refused is its parent, which is derived rather than stored: keeping both is redundant, and it pushed Result<_, LoggingError> past clippy’s result_large_err threshold, which is a fair complaint about an error type carrying a path twice.

parent_state: String

What the platform can say about that parent: its mode on Unix, whatever std::fs can report on Windows.

source: Error

The underlying filesystem error.

Trait Implementations

impl Debug for PathsError

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

Formats the value using the given formatter.

impl Display for PathsError

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

Formats the value using the given formatter.

impl Error for PathsError

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.