Enum CliError 

pub enum CliError {
    Io(Error),
    Json(Error),
    Wal(WalError),
    RulesDirNotFound(String),
    NoRulesFound(String),
    InvalidPayload(String),
    FactLogParse {
        line: usize,
        reason: String,
    },
    HashChain(String),
    Other(String),
}

CLI 错误

设计原则：

• 每个变体携带足够上下文（路径、行号、原因），便于用户定位问题
• #[from] 自动转换 std::io::Error / serde_json::Error / WalError
• Display 输出人类可读的中文/英文混合消息（与现有 CLI 风格一致）

Variants

Io(Error)

文件系统 I/O 错误

Json(Error)

JSON 序列化/反序列化错误

Wal(WalError)

tier1 WAL 序列化错误（fact_from_json 失败等）

RulesDirNotFound(String)

规则目录不存在

NoRulesFound(String)

规则目录中无 .json 文件

InvalidPayload(String)

初始 payload JSON 解析失败

FactLogParse

fact log 解析错误（指定行号和原因）

Fields

line: usize

出错的行号（1-based）

reason: String

错误原因

HashChain(String)

哈希链验证失败

Other(String)

通用错误（兜底）

Implementations

impl CliError

pub fn other(msg: impl Into<String>) -> Self

从任意字符串创建通用错误

示例

use evorule_cli::CliError;

let err = CliError::other("something went wrong");
assert_eq!(err.to_string(), "something went wrong");

impl CliError

退出码映射

约定：

• 0：成功
• 1：通用错误（默认）
• 2：规则加载错误（目录不存在、无 .json）

pub fn exit_code(&self) -> i32

返回该错误对应的退出码

约定

• 0：成功
• 1：通用错误（默认）
• 2：规则加载错误（目录不存在、无 .json）

示例

use evorule_cli::CliError;

// 规则目录缺失 → 退出码 2
let dir_err = CliError::RulesDirNotFound("/nonexistent".into());
assert_eq!(dir_err.exit_code(), 2);

// 通用错误 → 退出码 1
assert_eq!(CliError::other("boom").exit_code(), 1);

Trait Implementations

impl Debug for CliError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for CliError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for CliError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for CliError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CliError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<WalError> for CliError

fn from(source: WalError) -> Self

Converts to this type from the input type.