9 releases (4 breaking)
new 0.5.0 | Jun 1, 2024 |
---|---|
0.4.3 | May 27, 2024 |
0.4.1 | Apr 7, 2024 |
0.3.0 | Jan 25, 2024 |
0.1.2 | Jun 7, 2023 |
#8 in #documented
1,173 downloads per month
Used in 5 crates
(via documented)
21KB
348 lines
documented
Traits and derive macros for accessing your type's documentation at runtime
Quick start
use documented::{Documented, DocumentedFields, DocumentedVariants, Error};
/// Trying is the first step to failure.
#[derive(Documented, DocumentedFields, DocumentedVariants)]
enum AlwaysPlay {
Kb1,
/// But only if you are white.
F6,
}
// Documented
assert_eq!(AlwaysPlay::DOCS, "Trying is the first step to failure.");
// DocumentedFields
assert_eq!(
AlwaysPlay::FIELD_DOCS,
[None, Some("But only if you are white.")]
);
assert_eq!(
AlwaysPlay::get_field_docs("Kb1"),
Err(Error::NoDocComments("Kb1".to_string()))
);
assert_eq!(
AlwaysPlay::get_field_docs("F6"),
Ok("But only if you are white.")
);
assert_eq!(
AlwaysPlay::get_field_docs("Bf1"),
Err(Error::NoSuchField("Bf1".to_string()))
);
// DocumentedVariants
assert_eq!(
AlwaysPlay::Kb1.get_variant_docs(),
Err(Error::NoDocComments("Kb1".to_string()))
);
assert_eq!(
AlwaysPlay::F6.get_variant_docs(),
Ok("But only if you are white.")
);
Dependencies
~305–760KB
~18K SLoC