molframe_core/diagnostic/mod.rs
1//! Findings about data, accumulated and returned alongside success.
2//!
3//! A reader hands back the structure *and* the list of everything wrong with it.
4//! Stopping at the first problem makes real archive files unusable, and throwing
5//! warnings away on success makes their problems invisible — which is worse,
6//! because the caller then has a plausible result and no reason to doubt it.
7//!
8//! Findings are ordered before they are returned: worst first, then by position
9//! in the file, then by code. Two runs over the same input therefore produce the
10//! same list in the same order, which is what makes a result hashable and a
11//! regression test meaningful.
12
13mod code;
14mod convert;
15mod finding;
16mod findings;
17mod registry;
18mod render;
19
20pub use code::{Class, Code, Kind, Severity, Strictness};
21pub use finding::{ContextItem, Diagnostic, Diagnostics};
22pub use findings::Findings;
23pub use render::Rendered;