fs_metadata 0.4.4

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

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

/// Reads the metadata of a file at the given path and returns it as `fs::Metadata`.
///
/// # Arguments
///
/// * `path_str` - A reference to a `Path` representing the file path.
///
/// # Returns
///
/// * `Ok(fs::Metadata)` if the metadata could be read successfully.
/// * `Err(String)` if there was an error reading the metadata.
fn read_metadata(path_str: &Path) -> Result<fs::Metadata, String> {
    match fs::metadata(path_str) {
        Ok(data) => return Ok(data),
        Err(err) => return Err(err.to_string()),
    }
}

/// 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> {
    if !path_str.exists() {
        return Err("File does not exist".to_string());
    }

    let created_date = read_metadata(path_str)?.created().unwrap();
    let datetime: DateTime<Local> = created_date.into();
    let formatted_date = datetime.format("%Y-%m-%d").to_string();

    Ok(formatted_date)
}

/// 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> {
    if !path_str.exists() {
        return Err("File does not exist".to_string());
    }

    let modified_date = read_metadata(path_str)?.modified().unwrap();
    let datetime: DateTime<Local> = modified_date.into();
    let formatted_date = datetime.format("%Y-%m-%d").to_string();

    Ok(formatted_date)
}

/// 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> {
    if !path_str.exists() {
        return Err("File does not exist".to_string());
    }

    let accessed_date = read_metadata(path_str)?.accessed().unwrap();
    let datetime: DateTime<Local> = accessed_date.into();
    let formatted_date = datetime.format("%Y-%m-%d").to_string();

    Ok(formatted_date)
}

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

    #[test]
    fn can_read_creation_string() {
        let path = Path::new("../test-media/400a861d-014a-4dfb-9143-1a914212fd4d.jpg");
        let result = file_created(path).unwrap();
        assert_eq!(result, "2024-12-14");
    }

    #[test]
    fn can_read_modified_string() {
        let path = Path::new("../test-media/400a861d-014a-4dfb-9143-1a914212fd4d.jpg");
        let result = file_modified(path).unwrap();
        assert_eq!(result, "2024-12-14");
    }

    #[test]
    fn can_read_accessed_string() {
        let path = Path::new("../test-media/400a861d-014a-4dfb-9143-1a914212fd4d.jpg");
        let result = last_accessed(path).unwrap();
        assert_eq!(result, "2025-09-15");
    }
}