path_facts 0.2.1

You've subscribed to PATH FACTS: Tidy filesystem information to help debug unexpected errors.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

//! Metadata wrapper for clarity and consistency
//!
//! A `std::fs::Metadata` struct can come from `std::fs::metadata` or `std::fs::symlink_metadata`.
//! and depending on where it comes from it's predicate (boolean) methods can have different
//! meanings.

use std::{fmt::Display, fs::Metadata, path::Path};

/// Indicates the path is a file or directory or it's a valid simlink to a file or directory
#[derive(Debug)]
pub(crate) enum ResolvedType {
    File,
    Dir,
}

impl Display for ResolvedType {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            ResolvedType::File => write!(f, "file"),
            ResolvedType::Dir => write!(f, "directory"),
        }
    }
}

pub(crate) struct ResolvedMetadata(Metadata);

impl ResolvedMetadata {
    pub(crate) fn new(path: impl AsRef<Path>) -> Result<Self, std::io::Error> {
        std::fs::metadata(path.as_ref()).map(ResolvedMetadata)
    }

    pub(crate) fn resolved_type(&self) -> ResolvedType {
        if self.0.is_dir() {
            ResolvedType::Dir
        } else {
            ResolvedType::File
        }
    }
}