3 releases (breaking)
0.3.0 | Nov 2, 2024 |
---|---|
0.2.0 | Nov 1, 2024 |
0.1.0 | Nov 1, 2024 |
#1575 in Rust patterns
383 downloads per month
6KB
derive(Description)
This library provides a trait and derive macro that is like std::fmt::Display
, but using compile-time strings.
The library is fully no_std
and no_alloc
, and is meant to provide user-facing text for enum-like status messages without code bloat.
[dependencies]
description = "0.3.0"
Example
use description::Description;
#[derive(Description)]
enum ChargerStatus {
#[description("Charger connected!")]
Connected,
#[description("Charger disconnected!")]
Disconnected,
}
fn main() {
let charger = ChargerStatus::Connected;
println!("Charger notification: {}", charger.description());
}
std::fmt::format!()
-like compile time formatting is also supported, thanks to const_format
use description::Description;
const SOME_CONSTANT: usize = 5;
#[derive(Description)]
enum SomeStatusEnum {
#[description("the constant is {SOME_CONSTANT}, and the max u32 is {}", u32::MAX)]
ShowConstant,
#[description("i'm not showing the constant")]
DontShowConstant,
}
fn main() {
let charger = SomeStatusEnum::ShowConstant;
println!("enum message: {}", charger.description());
}
Dependencies
~240–800KB
~18K SLoC