salary_parser_jp/error.rs
1//! 解析エラー。精度優先(fail-closed)の方針により、確信の持てない入力は
2//! すべてエラーとして返し、呼び出し側の未処理キューへ回せるようにする。
3
4use crate::SalaryType;
5
6/// 給与テキスト解析のエラー。
7///
8/// どの変種も「解析失敗」であり、求人ソース全体の処理を止めるものではない。
9/// 呼び出し側はレコード単位で隔離・集計し、辞書やアダプタの改善材料にする。
10///
11/// [`Display`](std::fmt::Display) は日本語の診断文を返し、原因の特定に必要な
12/// 情報(正規化後テキスト・金額・種別)を含む。
13///
14/// ```
15/// use salary_parser_jp::{ParseError, SalaryParser};
16///
17/// // 種別語がなく、桁からも推定できない金額帯
18/// let error = ParseError::UnknownType { normalized: "55000円".to_string() };
19/// assert_eq!(SalaryParser::new().parse("55000円"), Err(error.clone()));
20/// assert_eq!(error.to_string(), "給与種別を特定できません: 55000円");
21/// ```
22#[derive(Debug, Clone, PartialEq, Eq, thiserror::Error)]
23pub enum ParseError {
24 /// 金額表現(数値+円)がテキスト中に存在しない(例: 「応相談」)。
25 #[error("金額表現がありません")]
26 NoAmount,
27 /// 金額はあるが給与種別を特定できない(種別語が無く金額からの推定も不能)。
28 /// `normalized` は判定に使った正規化後テキスト(デバッグ・監査用)。
29 #[error("給与種別を特定できません: {normalized}")]
30 UnknownType {
31 /// 正規化後のテキスト。
32 normalized: String,
33 },
34 /// 数値が大きすぎて解釈できない(破損データ)。
35 #[error("金額の桁が大きすぎます: {digits}")]
36 AmountTooLarge {
37 /// 解釈できなかった数字列。
38 digits: String,
39 },
40 /// 金額が給与種別ごとの妥当範囲外(例: 時給 90,000 円)。
41 #[error("{salary_type}として妥当範囲外の金額です: {amount}円")]
42 OutOfRange {
43 /// 判定された給与種別。
44 salary_type: SalaryType,
45 /// 範囲外だった金額(円)。
46 amount: u64,
47 },
48 /// 下限より上限が小さい(例: 26万円〜21万円)。
49 #[error("金額範囲が逆転しています: {min}円~{max}円")]
50 InvertedRange {
51 /// 下限(円)。
52 min: u64,
53 /// 上限(円)。
54 max: u64,
55 },
56 /// 呼び出し側が渡した妥当範囲が逆転している(解析対象ではなく設定の誤り)。
57 ///
58 /// 逆転した範囲は何も含まないため、放置すると全レコードが
59 /// [`OutOfRange`](Self::OutOfRange) になり、設定ミスだと気付けない。
60 #[error("{salary_type}の妥当範囲の指定が逆転しています: {min}円~{max}円")]
61 InvalidBounds {
62 /// 指定が逆転していた給与種別。
63 salary_type: SalaryType,
64 /// 指定された下限(円)。
65 min: u64,
66 /// 指定された上限(円)。
67 max: u64,
68 },
69}