littlefs-rust-core 0.1.0

Port of LittleFS to unsafe rust
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

//! LittleFS macros: assertions (debug_assert) and logging (log crate when feature enabled).

/// Assert condition; active in debug builds, stripped in release.
#[macro_export]
macro_rules! lfs_assert {
    ($cond:expr) => {
        debug_assert!($cond)
    };
    ($cond:expr, $($arg:tt)+) => {
        debug_assert!($cond, $($arg)+)
    };
}

/// Debug-level log. No-op when `log` feature is disabled.
#[cfg(feature = "log")]
#[macro_export]
macro_rules! lfs_debug {
    ($($arg:tt)*) => {
        log::debug!($($arg)*)
    };
}

#[cfg(not(feature = "log"))]
#[macro_export]
macro_rules! lfs_debug {
    ($($_:tt)*) => {};
}

/// Error-level log. No-op when `log` feature is disabled.
#[cfg(feature = "log")]
#[macro_export]
macro_rules! lfs_error {
    ($($arg:tt)*) => {
        log::error!($($arg)*)
    };
}

#[cfg(not(feature = "log"))]
#[macro_export]
macro_rules! lfs_error {
    ($($_:tt)*) => {};
}

/// Trace-level log. No-op when `log` feature is disabled.
#[cfg(feature = "log")]
#[macro_export]
macro_rules! lfs_trace {
    ($($arg:tt)*) => {
        log::trace!($($arg)*)
    };
}

#[cfg(not(feature = "log"))]
#[macro_export]
macro_rules! lfs_trace {
    ($($_:tt)*) => {};
}

/// Produce an error value for return. When `log` feature is enabled, logs at trace level
/// (file, line, error code) before producing the value. Use as `return lfs_err!(LFS_ERR_NOSPC)`
/// or with context: `return lfs_err!(LFS_ERR_NOSPC, "off={} end={}", off, end)`.
#[cfg(feature = "log")]
#[macro_export]
macro_rules! lfs_err {
    ($e:expr) => {{
        $crate::lfs_trace!("lfs_err {} at {}:{}", $e, file!(), line!());
        $e
    }};
    ($e:expr, $fmt:expr, $($arg:tt)*) => {{
        $crate::lfs_trace!(concat!("lfs_err {} at ", file!(), ":", line!(), " ", $fmt), $e, $($arg)*);
        $e
    }};
}

#[cfg(not(feature = "log"))]
#[macro_export]
macro_rules! lfs_err {
    ($e:expr) => {
        $e
    };
    ($e:expr, $($arg:tt)+) => {
        $e
    };
}

/// Propagate an error value on return. When `log` feature is enabled, logs at trace level
/// (file, line, error code) so call chain is visible. Use as `return lfs_pass_err!(err)` or
/// with context: `return lfs_pass_err!(err, "after lfs_dir_commit")`.
#[cfg(feature = "log")]
#[macro_export]
macro_rules! lfs_pass_err {
    ($e:expr) => {{
        $crate::lfs_trace!("lfs_pass_err {} at {}:{}", $e, file!(), line!());
        $e
    }};
    ($e:expr, $fmt:expr, $($arg:tt)*) => {{
        $crate::lfs_trace!(concat!("lfs_pass_err {} at ", file!(), ":", line!(), " ", $fmt), $e, $($arg)*);
        $e
    }};
}

#[cfg(not(feature = "log"))]
#[macro_export]
macro_rules! lfs_pass_err {
    ($e:expr) => {
        $e
    };
    ($e:expr, $($arg:tt)+) => {
        $e
    };
}