backhand 0.25.3

Library for the reading, creating, and modification of SquashFS file 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
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

//! Macros that keep this library's text out of a compiled binary
//!
//! With the `error-strings` feature off, the log macros drop the call and
//! `err_text!` gives an empty string, so no format string reaches the binary.
//! A log call must have the shape `level!("literal" [, value]...)`, because the
//! disabled arms below do not accept `tracing` structured fields.

// No call site uses `debug!` or `warn!` today. The shim keeps all five levels so
// that a new call site does not have to add a level first.
#![allow(unused_macros)]

#[cfg(feature = "error-strings")]
macro_rules! trace {
    ($($arg:tt)*) => { ::tracing::trace!($($arg)*) };
}

#[cfg(feature = "error-strings")]
macro_rules! debug {
    ($($arg:tt)*) => { ::tracing::debug!($($arg)*) };
}

#[cfg(feature = "error-strings")]
macro_rules! info {
    ($($arg:tt)*) => { ::tracing::info!($($arg)*) };
}

#[cfg(feature = "error-strings")]
macro_rules! warn {
    ($($arg:tt)*) => { ::tracing::warn!($($arg)*) };
}

#[cfg(feature = "error-strings")]
macro_rules! error {
    ($($arg:tt)*) => { ::tracing::error!($($arg)*) };
}

// `let _ = &$arg` stops a value that a module reads only to log it from raising
// an unused-variable warning.
#[cfg(not(feature = "error-strings"))]
macro_rules! drop_record {
    ($fmt:literal $(,)?) => {{}};
    ($fmt:literal, $($arg:expr),+ $(,)?) => {{ $( let _ = &$arg; )+ }};
}

#[cfg(not(feature = "error-strings"))]
macro_rules! trace {
    ($($arg:tt)*) => { drop_record!($($arg)*) };
}

#[cfg(not(feature = "error-strings"))]
macro_rules! debug {
    ($($arg:tt)*) => { drop_record!($($arg)*) };
}

#[cfg(not(feature = "error-strings"))]
macro_rules! info {
    ($($arg:tt)*) => { drop_record!($($arg)*) };
}

#[cfg(not(feature = "error-strings"))]
macro_rules! warn {
    ($($arg:tt)*) => { drop_record!($($arg)*) };
}

#[cfg(not(feature = "error-strings"))]
macro_rules! error {
    ($($arg:tt)*) => { drop_record!($($arg)*) };
}

/// Build the text of an error message
///
/// Wrap every literal or `format!` that becomes error text, so that the format
/// string and the `{:?}` type names leave the binary with the feature off.
#[cfg(feature = "error-strings")]
macro_rules! err_text {
    ($($arg:tt)*) => { format!($($arg)*) };
}

#[cfg(not(feature = "error-strings"))]
macro_rules! err_text {
    ($fmt:literal $(,)?) => {{ ::std::string::String::new() }};
    ($fmt:literal, $($arg:expr),+ $(,)?) => {{
        $( let _ = &$arg; )+
        ::std::string::String::new()
    }};
}

// lib.rs takes these macros with `#[macro_use]`, not with a `pub(crate) use`
// re-export, because the re-exported name `warn` would clash with the built-in
// attribute.