1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
//! yang-base - YANG 基础库
//!
//! 提供插件管理、数据库访问、HTTP 客户端和 JWT Token 管理等核心功能。
//!
//! # 模块
//!
//! - `plugin`:插件管理模块
//! - `database`:数据库管理模块(支持 MySQL 和 Redis)
//! - `http`:HTTP 客户端模块(需启用 `http` feature)
//! - `token`:JWT Token 管理模块(需启用 `token` feature)
//! - `error`:错误处理模块
//! - `table`:表配置系统模块
//! - `action`:Action 系统模块
//!
//! # Feature Gates
//!
//! - `token`:启用 JWT Token 管理功能(依赖 `jsonwebtoken`)
//! - `http`:启用 HTTP 客户端功能(依赖 `reqwest`、`serde_urlencoded`)
//! - `mysql`:启用 MySQL 数据库查询执行功能(依赖 `sqlx`)
//! - `redis`:启用 Redis 全局访问功能(`token` 会自动启用它)
//! - `validator`:启用正则表达式校验器(依赖 `regex`)
//! - `plugin-schema`:启用插件 JSON Schema 配置验证(依赖 `jsonschema`)
//! - `admin-metadata`:启用独立后台展示描述(不新增依赖、不改变 dispatch)
//!
//! # 快速开始
//!
//! ```rust,ignore
//! use yang_base::plugin::{Plugin, PluginManager};
//! use yang_base::database::{GlobalDatabase, GlobalRedis};
//! use yang_base::http::HttpClient;
//! use yang_base::token::TokenManager;
//! use yang_db::{DatabaseConfig, redis::RedisConfig};
//!
//! #[tokio::main]
//! async fn main() -> Result<(), Box<dyn std::error::Error>> {
//! // 初始化插件管理器
//! let plugin_manager = PluginManager::new();
//!
//! // 初始化全局 MySQL 数据库
//! GlobalDatabase::init("mysql://user:pass@localhost/db", DatabaseConfig::default()).await?;
//!
//! // 初始化全局 Redis
//! GlobalRedis::init("redis://127.0.0.1:6379", RedisConfig::default()).await?;
//!
//! // 初始化 HTTP 客户端
//! HttpClient::init_global(30)?;
//!
//! // 使用 MySQL
//! let users = GlobalDatabase::table("users")?
//! .select::<User>()
//! .await?;
//!
//! // 使用 Redis
//! GlobalRedis::set("key", "value", None).await?;
//! let value = GlobalRedis::get("key").await?;
//!
//! Ok(())
//! }
//! ```
// 强制公开 API 文档覆盖率检查:所有公开项必须有文档注释
/// 当前 yang-base crate 版本。
pub const VERSION: &str = env!;
// 让派生宏内部的 `::yang_base::...` 路径在 yang-base 自身的测试中正常解析。
extern crate self as yang_base;
// 重新导出插件系统的核心类型,方便用户直接使用
pub use ;
// 重新导出统一错误类型与 Result 别名,下游可直接写 yang_base::Result<T>
pub use ;
// 重新导出派生宏
pub use ;