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
//! Library-wide error type.
//!
//! Per `~/Projects/nick.md` ("Library crates: `thiserror`"), cornichon uses an
//! explicit error enum so consumers can match on failure modes rather than
//! receiving an erased `Box<dyn Error>`.
//!
//! All errors are constructed from `MenuItem` boundary parsing — the rest of
//! the library is total (returns `Option` or `MenuAction::None` instead of
//! `Result`) so most consumers never need to handle [`Error`] at all.
use Error;
/// Result alias for the cornichon crate.
pub type Result<T> = Result;
/// Errors produced at value-object construction boundaries.
///
/// Per the parse-don't-validate standard, raw `&str` / `String` input is
/// converted into a [`MenuItem`](crate::domain::item::MenuItem) (or
/// [`AnnotatedItem`](crate::domain::item::AnnotatedItem)) once, at the
/// adapter boundary, and the validated type is what flows through the rest of
/// the system.