garrison 0.9.0

Garrison - 面向 Rust 生态的一站式身份认证鉴权框架
Documentation
// Copyright (c) 2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0

//! 密码策略错误类型:[`PolicyError`] 由规则 `validate` 返回,引擎收集为 `Vec<PolicyError>`。

use std::fmt;

/// 密码策略校验错误:触发规则名 + 可展示给用户的描述。
#[derive(Debug, Clone)]
pub struct PolicyError {
    /// 触发错误的规则名称。
    pub rule_name: String,
    /// 错误描述信息(可展示给用户)。
    pub message: String,
}

impl PolicyError {
    /// 创建 `PolicyError`。
    pub fn new(rule_name: impl Into<String>, message: impl Into<String>) -> Self {
        Self {
            rule_name: rule_name.into(),
            message: message.into(),
        }
    }
}

impl fmt::Display for PolicyError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "[{}] {}", self.rule_name, self.message)
    }
}

impl std::error::Error for PolicyError {}

#[cfg(test)]
mod tests {
    use super::*;

    /// `PolicyError::new` 构造正确字段。
    #[test]
    fn policy_error_new_sets_fields() {
        let err = PolicyError::new("length", "密码长度不足");
        assert_eq!(err.rule_name, "length");
        assert_eq!(err.message, "密码长度不足");
    }

    /// `PolicyError` 实现 `Display`,输出含 `rule_name` 与 `message`。
    #[test]
    fn policy_error_display_contains_rule_name_and_message() {
        let err = PolicyError::new("complexity", "需包含大写字母");
        let display = format!("{}", err);
        assert!(
            display.contains("complexity"),
            "Display 输出应含 rule_name: {}",
            display
        );
        assert!(
            display.contains("需包含大写字母"),
            "Display 输出应含 message: {}",
            display
        );
    }

    /// `PolicyError` Clone 后字段一致。
    #[test]
    fn policy_error_clone_preserves_fields() {
        let err = PolicyError::new("blacklist", "密码在黑名单中");
        let cloned = err.clone();
        assert_eq!(cloned.rule_name, err.rule_name);
        assert_eq!(cloned.message, err.message);
    }
}