fs_metadata 0.5.1

A wrapper around Rust API for getting file metadata
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

use chrono::{DateTime, Local};
use std::fs;
use std::path::Path;

/// Returns the creation date of the file at the given path as a formatted string (`YYYY-MM-DD`).
///
/// # Arguments
///
/// * `path_str` - A reference to a `Path` representing the file path.
///
/// # Returns
///
/// * `Ok(String)` containing the formatted creation date if successful.
/// * `Err(String)` if the file does not exist or the creation date cannot be retrieved.
pub fn file_created(path_str: &Path) -> Result<String, String> {
    match fs::metadata(path_str) {
        Ok(data) => {
            if let Ok(created) = data.created() {
                let datetime: DateTime<Local> = created.into();
                let formatted_date = datetime.format("%Y-%m-%d").to_string();

                Ok(formatted_date)
            } else {
                Err("Failed to read file creation date".to_string())
            }
        }
        Err(err) => Err(err.to_string()),
    }
}

/// Returns the last modification date of the file at the given path as a formatted string (`YYYY-MM-DD`).
///
/// # Arguments
///
/// * `path_str` - A reference to a `Path` representing the file path.
///
/// # Returns
///
/// * `Ok(String)` containing the formatted modification date if successful.
/// * `Err(String)` if the file does not exist or the modification date cannot be retrieved.
pub fn file_modified(path_str: &Path) -> Result<String, String> {
    match fs::metadata(path_str) {
        Ok(data) => {
            if let Ok(modified) = data.modified() {
                let datetime: DateTime<Local> = modified.into();
                let formatted_date = datetime.format("%Y-%m-%d").to_string();

                Ok(formatted_date)
            } else {
                Err("Failed to read file modified date".to_string())
            }
        }
        Err(err) => Err(err.to_string()),
    }
}

/// Returns the last accessed date of the file at the given path as a formatted string (`YYYY-MM-DD`).
///
/// # Arguments
///
/// * `path_str` - A reference to a `Path` representing the file path.
///
/// # Returns
///
/// * `Ok(String)` containing the formatted last accessed date if successful.
/// * `Err(String)` if the file does not exist or the accessed date cannot be retrieved.
pub fn last_accessed(path_str: &Path) -> Result<String, String> {
    match fs::metadata(path_str) {
        Ok(data) => {
            if let Ok(accessed) = data.accessed() {
                let datetime: DateTime<Local> = accessed.into();
                let formatted_date = datetime.format("%Y-%m-%d").to_string();

                Ok(formatted_date)
            } else {
                Err("Failed to read file last accessed date".to_string())
            }
        }
        Err(err) => Err(err.to_string()),
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use std::io::Write;

    fn create_temp_file() -> tempfile::NamedTempFile {
        let mut f = tempfile::NamedTempFile::new().expect("Failed to create temp file");
        writeln!(f, "test content").unwrap();
        f
    }

    #[test]
    fn can_read_creation_string() {
        let f = create_temp_file();
        let result = file_created(f.path()).unwrap();
        let today = Local::now().format("%Y-%m-%d").to_string();
        assert_eq!(result, today);
    }

    #[test]
    fn can_read_modified_string() {
        let f = create_temp_file();
        let result = file_modified(f.path()).unwrap();
        let today = Local::now().format("%Y-%m-%d").to_string();
        assert_eq!(result, today);
    }

    #[test]
    fn can_read_accessed_string() {
        let f = create_temp_file();
        let result = last_accessed(f.path()).unwrap();
        let today = Local::now().format("%Y-%m-%d").to_string();
        assert_eq!(result, today);
    }
}