Struct WalkError 

pub struct WalkError {
    pub path: Option<PathBuf>,
    pub message: String,
    pub forbidden: bool,
}

Something the walk could not read. Collected rather than fatal: one unreadable directory must not cost the user the rest of the scan.

Fields

path: Option<PathBuf>

The path involved, when the error names one.

message: String

What went wrong.

forbidden: bool

Whether the operating system refused, rather than something having gone wrong.

Recorded from the io::Error’s kind at the moment it is caught, never by reading the message afterwards — this crate has already been bitten once by parsing a program’s prose, and an errno does not get translated.

The two are worth telling apart because only one of them is news. A macOS home directory holds a dozen paths under Library that TCC refuses every process without Full Disk Access, and they will read the same on every run forever; printing them beside a genuine failure, every time, is how a reader learns to skip the line that says the totals are a floor.

Implementations

impl WalkError

pub fn is_forbidden(&self) -> bool

Whether this was the system refusing rather than something going wrong.

Trait Implementations

impl Debug for WalkError

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

Formats the value using the given formatter.