Skip to main content

yang_base/plugin/
mod.rs

1//! 插件管理模块
2//!
3//! 提供插件注册、管理和生命周期控制功能。
4//!
5//! # 主要组件
6//!
7//! - `Plugin` trait:插件接口定义
8//! - `PluginManager`:插件管理器,负责插件的注册和查找
9//!
10//! # 示例
11//!
12//! ```rust,ignore
13//! use yang_base::plugin::{Plugin, PluginManager};
14//!
15//! // 定义插件
16//! struct MyPlugin;
17//!
18//! #[async_trait::async_trait]
19//! impl Plugin for MyPlugin {
20//!     fn name(&self) -> &str {
21//!         "my_plugin"
22//!     }
23//! }
24//!
25//! // 注册插件
26//! let manager = PluginManager::new();
27//! manager.register(MyPlugin).await?;
28//! ```
29
30mod builder;
31mod manager;
32mod registry;
33mod traits;
34
35#[cfg(test)]
36mod __tests__;
37
38pub use builder::PluginManagerBuilder;
39pub use manager::PluginManager;
40pub use registry::PluginRegistry;
41pub use traits::{Plugin, PluginError, PluginLifecycleStage};
42
43use crate::error::BaseError;
44
45fn normalize_plugin_name(name: &str) -> Result<&str, BaseError> {
46    let name = name.trim();
47    if name.is_empty() {
48        return Err(BaseError::PluginRegisterFailed(
49            "<empty>".to_string(),
50            "插件名称不能为空".to_string(),
51        ));
52    }
53
54    Ok(name)
55}
56
57fn normalize_plugin_lookup_name(name: &str) -> Option<&str> {
58    let name = name.trim();
59    (!name.is_empty()).then_some(name)
60}