Chet.Utils 1.5.0

Chet.Utils

概述

Chet.Utils 是一个为 .NET 开发提供全面辅助工具的类库。该项目旨在简化代码编写过程中的常见操作，提高开发效率，减少重复代码。所有扩展方法和帮助类都经过精心设计，遵循 .NET 最佳实践，提供完整的 XML 文档注释。

特性

• 🚀 高性能 - 经过优化的实现，减少不必要的内存分配
• 🔒 安全可靠 - 完善的空值检查和异常处理
• 📖 完整文档 - 所有方法都有详细的 XML 注释和使用示例
• 🧪 单元测试 - 核心功能都有对应的单元测试覆盖
• 🎯 易于使用 - 直观的 API 设计，符合 .NET 命名规范

主要功能

扩展方法

帮助类

安装

NuGet 包管理器

Install-Package Chet.Utils

.NET CLI

dotnet add package Chet.Utils

PackageReference

<PackageReference Include="Chet.Utils" Version="1.5.0" />

快速开始

使用扩展方法

using Chet.Utils;

// 字符串扩展
string email = "test@example.com";
bool isValid = email.IsEmail(); // true

// 日期扩展
DateTime date = DateTime.Now;
bool isWeekend = date.IsWeekend(); // 判断是否周末
string formatted = date.ToChineseDateString(); // "二〇二四年一月一日"

// 集合扩展
var list = new List<int> { 1, 2, 3, 4, 5 };
var page = list.GetPage(1, 2); // 分页获取数据
bool isEmpty = list.IsNullOrEmpty(); // 判断是否为空

// 数值扩展
int value = 12345;
string thousands = value.ToThousandsString(); // "12,345"
string chinese = value.ToChineseNumber(); // "一万二千三百四十五"

使用帮助类

using Chet.Utils.Helpers;

// HTTP 客户端
var httpHelper = new HttpClientHelper();
var response = await httpHelper.GetAsync<string>("https://api.example.com/data");

// 正则表达式
bool isPhone = RegexHelper.IsMobilePhone("13800138000");
var emails = RegexHelper.ExtractEmails("联系邮箱: test@example.com");

// 计时器
var elapsed = StopwatchHelper.Measure(() => 
{
    // 要测试的代码
});
Console.WriteLine($"执行时间: {elapsed.TotalMilliseconds}ms");

// WebSocket 客户端
var wsClient = new WebSocketHelper();
wsClient.OnMessageReceived += (sender, e) => Console.WriteLine(e.Message);
await wsClient.ConnectAsync(new Uri("ws://localhost:8080"));
await wsClient.SendMessageAsync("Hello, World!");

系统要求

• .NET 8.0 或更高版本
• .NET Standard 2.0（部分功能）

版本更新

v1.5.0 (当前版本)

新功能

重构所有扩展类和帮助类，使其更通用、更易用

v1.4.0

新增功能

• ✨ 添加 WebSocket 帮助类，包含客户端和服务端实现
  • 支持连接管理、消息收发、心跳检测、自动重连
  • 支持消息队列、广播、组播等功能
• ✨ StringExtensions 类扩展了部分方法

改进

• 📝 完善所有扩展类和帮助类的 XML 文档注释
• 📝 更新所有功能文档，添加详细的使用示例
• 🔧 优化代码结构，提高代码可读性

v1.3.0

新增功能

• ✨ 添加 ApplicationHelper 应用程序帮助类
• ✨ 添加 ReflectHelper 反射帮助类
• ✨ 添加 StopwatchHelper 计时帮助类
• ✨ 添加 TaskHelper 任务帮助类
• ✨ 添加 UnitHelper 单位帮助类

v1.2.0

新增功能

• ✨ 添加 DataTableHelper 数据表帮助类
• ✨ 添加 FileHelper 文件帮助类
• ✨ 添加 RegexHelper 正则表达式帮助类

v1.1.0

新增功能

• ✨ 添加 HttpClientHelper HTTP 客户端帮助类
• ✨ 完善扩展方法类

v1.0.0

初始版本

• 🎉 基础扩展方法类（Bool、DateTime、Decimal、Double、Float、Int、String、Enumerable）
• 🎉 基础帮助类

贡献指南

欢迎提交 Issue 和 Pull Request 来帮助改进这个项目。

许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

联系方式

如有问题或建议，请通过以下方式联系：

• 提交 GitHub Issue
• 发送邮件至：support@example.com