Rust基础工具库tor-basic-utils使用指南

tor-basic-utils是一个Rust基础工具库，提供了一系列高效实用的函数和基础功能扩展，旨在简化日常开发中的常见任务。

主要功能

1. 字符串处理：提供额外的字符串操作方法
2. 集合操作：增强Vec、HashMap等集合的功能
3. 错误处理：简化错误处理流程
4. 类型转换：提供便捷的类型转换方法
5. 日期时间处理：扩展时间日期操作功能

安装方法

在Cargo.toml中添加依赖：

[dependencies]
tor-basic-utils = "0.1"  # 请使用最新版本号

使用示例

1. 字符串处理

use tor_basic_utils::string_utils;

fn main() {
    let s = "hello world";
    
    // 字符串截取
    let substring = string_utils::substring(s, 0, 5);
    println!("{}", substring);  // 输出: hello
    
    // 字符串重复
    let repeated = string_utils::repeat(s, 3);
    println!("{}", repeated);  // 输出: hello worldhello worldhello world
}

2. 集合操作

use tor_basic_utils::collection_utils;

fn main() {
    let vec = vec![1, 2, 3, 4, 5];
    
    // 快速求和
    let sum = collection_utils::sum(&vec);
    println!("Sum: {}", sum);  // 输出: 15
    
    // 分块处理
    let chunks = collection_utils::chunk(&vec, 2);
    println!("{:?}", chunks);  // 输出: [[1, 2], [3, 4], [5]]
}

3. 错误处理

use tor_basic_utils::error_utils;

fn may_fail() -> Result<i32, String> {
    Err("Something went wrong".to_string())
}

fn main() {
    // 简化错误处理
    let result = error_utils::unwrap_or_default(may_fail(), 0);
    println!("{}", result);  // 输出: 0
    
    // 错误链式处理
    let err = error_utils::chain_err("Additional context", may_fail().err().unwrap());
    println!("{}", err);  // 输出: Additional context: Something went wrong
}

4. 类型转换

use tor_basic_utils::conversion_utils;

fn main() {
    // 安全转换
    let num_str = "123";
    let num: i32 = conversion_utils::parse_or_default(num_str, 0);
    println!("{}", num);  // 输出: 123
    
    let invalid_str = "abc";
    let default_num = conversion_utils::parse_or_default(invalid_str, 0);
    println!("{}", default_num);  // 输出: 0
}

5. 日期时间处理

use tor_basic_utils::datetime_utils;
use chrono::{Local, Duration};

fn main() {
    let now = Local::now();
    
    // 添加天数
    let future = datetime_utils::add_days(now, 7);
    println!("7天后: {}", future);
    
    // 格式化时间
    let formatted = datetime_utils::format_custom(now, "%Y-%m-%d %H:%M:%S");
    println!("格式化时间: {}", formatted);
}

高级用法

自定义扩展trait

tor-basic-utils提供了多种扩展trait，可以为原生类型添加方法：

use tor_basic_utils::extensions::VecExt;

fn main() {
    let mut vec = vec![1, 2, 3];
    
    // 使用扩展方法
    vec.insert_if_not_exists(4);
    vec.insert_if_not_exists(2);  // 不会重复插入
    
    println!("{:?}", vec);  // 输出: [1, 2, 3, 4]
}

组合使用

use tor_basic_utils::{string_utils, collection_utils};

fn process_data(input: &str) -> Vec<String> {
    let words = string_utils::split_whitespace_trimmed(input);
    collection_utils::unique(words)
}

fn main() {
    let text = "hello world hello rust";
    let result = process_data(text);
    println!("{:?}", result);  // 输出: ["hello", "world", "rust"]
}

性能提示

1. 大多数函数都针对性能进行了优化
2. 对于频繁调用的操作，考虑使用unsafe版本（如果存在）
3. 批量操作通常比单次操作更高效

贡献与反馈

该库是开源的，欢迎提交issue和PR来改进功能或报告问题。

完整示例demo

下面是一个结合多个功能的完整示例：

use tor_basic_utils::{
    string_utils,
    collection_utils,
    error_utils,
    conversion_utils,
    datetime_utils,
    extensions::VecExt
};
use chrono::Local;

fn main() {
    // 1. 字符串处理示例
    let text = "Rust编程很有趣";
    println!("截取字符串: {}", string_utils::substring(text, 0, 3));
    println!("重复字符串: {}", string_utils::repeat(text, 2));

    // 2. 集合操作示例
    let mut numbers = vec![1, 2, 3, 4, 5];
    println!("集合求和: {}", collection_utils::sum(&numbers));
    
    // 使用Vec扩展方法
    numbers.insert_if_not_exists(6);
    numbers.insert_if_not_exists(3); // 不会重复插入
    println!("去重后的集合: {:?}", numbers);

    // 3. 错误处理示例
    let result = error_utils::unwrap_or_default("123".parse::<i32>(), 0);
    println!("解析结果: {}", result);

    // 4. 类型转换示例
    let num = conversion_utils::parse_or_default("456", 0);
    println!("转换后的数字: {}", num);

    // 5. 日期时间处理示例
    let now = Local::now();
    let next_week = datetime_utils::add_days(now, 7);
    println!("下周日期: {}", datetime_utils::format_custom(next_week, "%Y-%m-%d"));

    // 组合使用示例
    let data = "apple, banana, apple, orange";
    let unique_items = collection_utils::unique(
        string_utils::split_whitespace_trimmed(data)
    );
    println!("去重后的水果列表: {:?}", unique_items);
}