garrison 0.7.2

Garrison - 面向 Rust 生态的一站式身份认证鉴权框架
Documentation
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.

//! 插件层测试 mock 实现。
//!
//! 本模块仅在 `cfg(test)` 下编译(通过 `mod.rs` 中的 `#[cfg(test)] mod mock;` 声明),
//! 提供 `OkPlugin` / `ErrPlugin` 两个 GarrisonPlugin mock(通过 `inventory` 编译期注册),
//! 供 `plugin::tests` 钩子调用与插件管理测试复用。

use super::{GarrisonPlugin, GarrisonPluginEntry};
use crate::error::{GarrisonError, GarrisonResult};
use std::sync::atomic::{AtomicUsize, Ordering};
use std::sync::Arc;

/// 计数器,记录钩子被调用次数。
pub static LOGIN_CALLS: AtomicUsize = AtomicUsize::new(0);
pub static LOGOUT_CALLS: AtomicUsize = AtomicUsize::new(0);
pub static PERM_CHECK_CALLS: AtomicUsize = AtomicUsize::new(0);

/// 成功插件,所有钩子返回 Ok(())。
pub struct OkPlugin;

impl GarrisonPlugin for OkPlugin {
    fn name(&self) -> &str {
        "ok-plugin"
    }
    fn on_login(&self, _login_id: &str, _token: &str) -> GarrisonResult<()> {
        LOGIN_CALLS.fetch_add(1, Ordering::SeqCst);
        Ok(())
    }
    fn on_logout(&self, _login_id: &str, _token: &str) -> GarrisonResult<()> {
        LOGOUT_CALLS.fetch_add(1, Ordering::SeqCst);
        Ok(())
    }
    fn on_permission_check(&self, _login_id: &str, _permission: &str) -> GarrisonResult<()> {
        PERM_CHECK_CALLS.fetch_add(1, Ordering::SeqCst);
        Ok(())
    }
}

/// 失败插件,所有钩子返回 Err。
pub struct ErrPlugin;

impl GarrisonPlugin for ErrPlugin {
    fn name(&self) -> &str {
        "err-plugin"
    }
    fn on_login(&self, _login_id: &str, _token: &str) -> GarrisonResult<()> {
        Err(GarrisonError::Internal(
            "plugin-on-login-failed".to_string(),
        ))
    }
    fn on_logout(&self, _login_id: &str, _token: &str) -> GarrisonResult<()> {
        Err(GarrisonError::Internal(
            "plugin-on-logout-failed".to_string(),
        ))
    }
    fn on_permission_check(&self, _login_id: &str, _permission: &str) -> GarrisonResult<()> {
        Err(GarrisonError::Internal(
            "on_permission_check 失败".to_string(),
        ))
    }
}

pub fn ok_plugin_factory() -> Arc<dyn GarrisonPlugin> {
    Arc::new(OkPlugin)
}

pub fn err_plugin_factory() -> Arc<dyn GarrisonPlugin> {
    Arc::new(ErrPlugin)
}

// 注册测试插件到 inventory
inventory::submit! {
    GarrisonPluginEntry { factory: ok_plugin_factory }
}
inventory::submit! {
    GarrisonPluginEntry { factory: err_plugin_factory }
}

/// 重置所有计数器。
pub fn reset_counters() {
    LOGIN_CALLS.store(0, Ordering::SeqCst);
    LOGOUT_CALLS.store(0, Ordering::SeqCst);
    PERM_CHECK_CALLS.store(0, Ordering::SeqCst);
}