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 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136
//! # What
//!
//! This crate provides an optional wrapper around the ["log" crate](https://crates.io/crates/log),
//! which allows you to provide an optional "log" feature for you crates easily.
//!
//! # How
//!
//! In your "Cargo.toml":
//!
//! ```toml
//! [dependencies]
//! log = { version = "0.4", optional = true }
//! optional-log = "0.1"
//!
//! [feature]
//! log = ["dep:log", "optional-log/log"]
//! ```
//!
//! Then use macros of "optional-log" crate instead of those of the ["log" crate](https://crates.io/crates/log).
//!
//! In this way, once the "log" feature of your crate is enabled by downstream, these macros will be expanded to
//! the corresponding macros of the ["log" crate](https://crates.io/crates/log), otherwise they do nothing.
//!
//! The [`log_enabled!`] macro will always return `false` if the "log" feature is not enabled.
#[macro_export]
#[cfg(feature = "log")]
macro_rules! log {
($($t:tt)*) => {
::log::log!($($t)*)
};
}
#[macro_export]
#[cfg(not(feature = "log"))]
macro_rules! log {
($($t:tt)*) => {
()
};
}
#[macro_export]
#[cfg(feature = "log")]
macro_rules! trace {
($($t:tt)*) => {
::log::trace!($($t)*)
};
}
#[macro_export]
#[cfg(not(feature = "log"))]
macro_rules! trace {
($($t:tt)*) => {
()
};
}
#[macro_export]
#[cfg(feature = "log")]
macro_rules! debug {
($($t:tt)*) => {
::log::debug!($($t)*)
};
}
#[macro_export]
#[cfg(not(feature = "log"))]
macro_rules! debug {
($($t:tt)*) => {
()
};
}
#[macro_export]
#[cfg(feature = "log")]
macro_rules! info {
($($t:tt)*) => {
::log::info!($($t)*)
};
}
#[macro_export]
#[cfg(not(feature = "log"))]
macro_rules! info {
($($t:tt)*) => {
()
};
}
#[macro_export]
#[cfg(feature = "log")]
macro_rules! warn {
($($t:tt)*) => {
::log::warn!($($t)*)
};
}
#[macro_export]
#[cfg(not(feature = "log"))]
macro_rules! warn {
($($t:tt)*) => {
()
};
}
#[macro_export]
#[cfg(feature = "log")]
macro_rules! error {
($($t:tt)*) => {
::log::error!($($t)*)
};
}
#[macro_export]
#[cfg(not(feature = "log"))]
macro_rules! error {
($($t:tt)*) => {
()
};
}
#[macro_export]
#[cfg(feature = "log")]
macro_rules! log_enabled {
($($t:tt)*) => {
::log::log_enabled!($($t)*)
};
}
#[macro_export]
#[cfg(not(feature = "log"))]
macro_rules! log_enabled {
($($t:tt)*) => {
false
};
}