Skip to main content

wordval_utils/
lib.rs

1//! # wordval-utils
2//!
3//! Wordval 工具库:字符串、日期、脱敏、ID 生成、验证、加密、Web 辅助、集合、重试。
4//!
5//! ## 模块导览
6//!
7//! - [`crypto`] — AES/RSA 加解密、哈希
8//! - [`date`] — 日期时间格式化与计算
9//! - [`mask`] — 手机号、邮箱、身份证、API 密钥等脱敏
10//! - [`sid`] — UUID v4/v7、TSID、短 ID 生成
11//! - [mod@str] — 字符串扩展与清理
12//! - [`ua`] — User-Agent 轻量解析(浏览器 / 系统 / 设备 / 爬虫)
13//! - [`valid`] — 参数验证辅助
14//! - [`web`] — 客户端 IP 提取、URL 解析、Web 辅助
15//! - [`export`] — Excel/CSV 导入导出
16//! - [`collection`] — 集合工具:分组、去重、分块、查找
17//! - [`correctness`] — 设计契约式前置校验(类型化 Result 而非 panic)
18//! - [`backoff`] — 指数退避 + 抖动 + 重连风暴防护(滑动窗口节流)
19//! - [`retry`] — 同步重试(仅限同步上下文)与预算制异步 [`retry::RetryManager`]
20//! - [`atomic_map`] — RCU 无锁并发 Map(读多写少场景)
21//! - [`task_handle`] — 异步任务句柄托管(自动清理、统一 abort)
22//! - [`serde_utils`] — 序列化/反序列化工具
23//! - `xss` — XSS 净化(需启用 `xss` feature)
24
25pub mod atomic_map;
26pub mod backoff;
27pub mod collection;
28pub mod correctness;
29pub mod crypto;
30pub mod date;
31pub mod export;
32pub mod mask;
33pub mod retry;
34pub mod serde_utils;
35pub mod sid;
36pub mod str;
37pub mod task_handle;
38pub mod ua;
39pub mod valid;
40pub mod web;
41
42#[cfg(feature = "xss")]
43pub mod xss;
44
45pub use atomic_map::AtomicMap;
46pub use backoff::{ExponentialBackoff, ReconnectThrottle};
47pub use collection::CollectionExt;
48pub use crypto::Crypto;
49pub use date::Date;
50pub use export::{Export, ExportFormat, Import};
51pub use mask::Mask;
52pub use retry::{Retry, RetryConfig, RetryError, RetryManager};
53pub use sid::Sid;
54pub use str::StrExt;
55pub use str::{
56    clean_email, clean_password, clean_string_param, format_file_size, generate_invite_code,
57    generate_random_alphanum, generate_random_digits, parse_json_value, sanitize_filename,
58    InputCleaner,
59};
60pub use task_handle::TaskHandles;
61pub use ua::{Ua, UaDevice, UaInfo};
62pub use valid::Valid;
63pub use web::extract_client_ip;
64pub use web::WebExt;