embassy-supervisor 0.3.3

A generic, HAL-agnostic task-lifecycle supervisor for the embassy async embedded framework: dependency-ordered bring-up/teardown, lifecycle modes, elastic task pools, and runtime start/stop/pause/resume control.
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

//! Logging macros that forward to [`defmt`] when the `defmt` feature is enabled
//! and expand to (argument-consuming) no-ops otherwise, so the supervisor can log
//! without forcing the `defmt` dependency on consumers. The no-op arms still
//! evaluate-and-discard their arguments (`let _ = &arg`) so enabling/disabling the
//! feature never introduces unused-variable warnings. Pattern adapted from
//! embassy's `fmt.rs` shim.

#![allow(unused_macros)]

#[cfg(feature = "defmt")]
macro_rules! info {
    ($($a:tt)*) => { ::defmt::info!($($a)*) };
}
#[cfg(not(feature = "defmt"))]
macro_rules! info {
    ($s:literal $(, $a:expr)* $(,)?) => {{ $( let _ = &$a; )* }};
}

#[cfg(feature = "defmt")]
macro_rules! warn {
    ($($a:tt)*) => { ::defmt::warn!($($a)*) };
}
#[cfg(not(feature = "defmt"))]
macro_rules! warn {
    ($s:literal $(, $a:expr)* $(,)?) => {{ $( let _ = &$a; )* }};
}

#[cfg(feature = "defmt")]
macro_rules! error {
    ($($a:tt)*) => { ::defmt::error!($($a)*) };
}
#[cfg(not(feature = "defmt"))]
macro_rules! error {
    ($s:literal $(, $a:expr)* $(,)?) => {{ $( let _ = &$a; )* }};
}

#[cfg(feature = "defmt")]
macro_rules! debug {
    ($($a:tt)*) => { ::defmt::debug!($($a)*) };
}
#[cfg(not(feature = "defmt"))]
macro_rules! debug {
    ($s:literal $(, $a:expr)* $(,)?) => {{ $( let _ = &$a; )* }};
}

#[cfg(feature = "defmt")]
macro_rules! trace {
    ($($a:tt)*) => { ::defmt::trace!($($a)*) };
}
#[cfg(not(feature = "defmt"))]
macro_rules! trace {
    ($s:literal $(, $a:expr)* $(,)?) => {{ $( let _ = &$a; )* }};
}

// Diverging: forwards to defmt's formatter or core's, but always panics.
#[cfg(feature = "defmt")]
macro_rules! panic {
    ($($a:tt)*) => { ::defmt::panic!($($a)*) };
}
#[cfg(not(feature = "defmt"))]
macro_rules! panic {
    ($($a:tt)*) => { ::core::panic!($($a)*) };
}