dir-meta 0.7.0

Read a directory and get back all files and errors from the read operation
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

#[cfg(feature = "time")]
use chrono::{DateTime, Utc};
#[cfg(feature = "time")]
use std::time::Duration;

#[cfg(feature = "time")]
use std::time::SystemTime;

#[cfg(feature = "time")]
use tai64::Tai64N;

/// Reusable Clone-on-Write str with lifetime of `'a`
pub type CowStr<'a> = std::borrow::Cow<'a, str>;

/// A convenience struct to access utilities
pub struct FsUtils;

impl FsUtils {
    /// Returns [Option::None] if time query is not supported
    #[cfg(feature = "time")]
    pub fn maybe_time(time_result: Option<SystemTime>) -> Option<Tai64N> {
        time_result.map(|time| Tai64N::from_system_time(&time))
    }

    /// Calculate the size in bytes
    #[cfg(feature = "size")]
    pub fn size_to_bytes(bytes: usize) -> String {
        byte_prefix::calc_bytes(bytes as f32)
    }

    /// Convert TAI64N to local time in 24 hour format
    #[cfg(feature = "time")]
    pub fn tai64_to_local_hrs<'a>(time: &Tai64N) -> DateTimeString<'a> {
        let date_time: DateTime<Utc> = time.to_system_time().into();
        let date = date_time
            .date_naive()
            .format("%A, %-d %B, %C%y")
            .to_string();
        let date = CowStr::Owned(date);
        let time = date_time.format("%H:%M:%S").to_string();
        let time = CowStr::Owned(time);

        DateTimeString { date, time }
    }

    /// Convert TAI64N to local time in 12 hour format
    #[cfg(feature = "time")]
    pub fn tai64_to_local_am_pm<'a>(time: &Tai64N) -> DateTimeString<'a> {
        let date_time: DateTime<Utc> = time.to_system_time().into();
        let date = date_time
            .date_naive()
            .format("%A, %-d %B, %C%y")
            .to_string();
        let date = CowStr::Owned(date);
        let time = date_time.format("%-I:%M %p").to_string();
        let time = CowStr::Owned(time);

        DateTimeString { date, time }
    }

    /// Convert duration since UNIX EPOCH to humantime
    #[cfg(feature = "time")]
    pub fn tai64_to_humantime_with_epoch(time: &Tai64N) -> Option<String> {
        FsUtils::tai64_duration_since_epoch(time)
            .map(|duration| humantime::format_duration(duration).to_string())
    }

    /// Convert duration since two TAI64N timestamps to humantime
    #[cfg(feature = "time")]
    pub fn tai64_to_humantime(earlier_time: &Tai64N, current_time: &Tai64N) -> Option<String> {
        FsUtils::tai64_duration(earlier_time, current_time)
            .map(|duration| humantime::format_duration(duration).to_string())
    }

    /// Convert duration between current time and earlier TAI64N timestamp to humantime
    #[cfg(feature = "time")]
    pub fn tai64_now_duration_to_humantime(earlier_time: &Tai64N) -> Option<String> {
        FsUtils::tai64_duration_from_now(earlier_time)
            .map(|duration| humantime::format_duration(duration).to_string())
    }

    /// Get the duration between two TAI64N timestamps
    #[cfg(feature = "time")]
    pub fn tai64_duration(earlier_time: &Tai64N, current_time: &Tai64N) -> Option<Duration> {
        earlier_time.duration_since(current_time).ok()
    }

    /// Get the duration since UNIX EPOCH
    #[cfg(feature = "time")]
    pub fn tai64_duration_since_epoch(time: &Tai64N) -> Option<Duration> {
        time.duration_since(&Tai64N::UNIX_EPOCH).ok()
    }

    /// Get the duration since UNIX EPOCH
    #[cfg(feature = "time")]
    pub fn tai64_duration_from_now(earlier_time: &Tai64N) -> Option<Duration> {
        Tai64N::now().duration_since(earlier_time).ok()
    }
}

/// The data and time in human readable [String]
#[cfg(feature = "time")]
#[derive(Debug, PartialEq, Eq, PartialOrd, Ord, Clone, Default)]
pub struct DateTimeString<'a> {
    /// The data without a timestamp
    pub date: CowStr<'a>,
    /// A timestamp without a date
    pub time: CowStr<'a>,
}