simple-fatfs 0.1.0-alpha.2

A simple-to-use FAT filesystem library for Rust (mainly targeted at embedded systems)
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

use core::fmt;

use time::{macros::date, PrimitiveDateTime};

/// The earliest [`datetime`](PrimitiveDateTime) that FAT can use
/// as a creation, access or modification time
pub const EPOCH: PrimitiveDateTime = date!(1980 - 01 - 01).midnight();

/// An object that can measure and return the current time
pub trait Clock: fmt::Debug {
    /// Returns the current date and time in your local timezone
    /// (<https://learn.microsoft.com/en-us/windows/win32/sysinfo/file-times>)
    fn now(&self) -> PrimitiveDateTime;
}

/// The default [`Clock`] component
///
/// Returns the current local time in a `std` environment.
/// In a `no-std` environment, it just returns the [`EPOCH`]
#[derive(Debug, Default)]
#[allow(missing_copy_implementations)]
pub struct DefaultClock;

impl Clock for DefaultClock {
    fn now(&self) -> PrimitiveDateTime {
        #[cfg(feature = "std")]
        {
            use time::OffsetDateTime;

            // https://stackoverflow.com/a/76149536/

            // TODO: make the trait return an error to handle such cases
            let now_odt = OffsetDateTime::now_local().unwrap_or(OffsetDateTime::now_utc());

            PrimitiveDateTime::new(now_odt.date(), now_odt.time())
        }
        #[cfg(not(feature = "std"))]
        EPOCH
    }
}

impl Clock for &DefaultClock {
    fn now(&self) -> PrimitiveDateTime {
        (*self).now()
    }
}