BugFree.Core 1.2.2026.613-beta1539

BugFree.Core

📖 项目介绍

BugFree.Core 是 .NET 工具类库，提供编解码、枚举、集合、IP、路径安全、单位格式化等扩展方法，以及安全随机串生成、资源压力测试等工具，助力高效开发。

🎯 功能特性

扩展方法（Extensions）

特性（Attributes）

工具类（Tools）

🚀 快速开始

安装

通过 NuGet 安装：

dotnet add package BugFree.Core

或者通过包管理器控制台：

Install-Package BugFree.Core

使用示例

// 1. 编解码
using BugFree.Core.Extensions;

byte[] data = "Hello World".GetBytes();
string hex = data.ToHex();          // "48656c6c6f20576f726c64"
string base64 = data.ToBase64();    // "SGVsbG8gV29ybGQ="

// 2. 枚举描述
enum Status { [Description("正常")] Active, [Description("已禁用")] Disabled }
string desc = Status.Active.GetDescription(); // "正常"

// 3. 单位格式化
long fileSize = 2_147_483_648;
string formatted = fileSize.UnitFormatSize(UnitFormatExtensions.UnitKind.Storage);
// 输出: "2.00 GB"

// 4. 路径安全
string safePath = PathSecurityHelper.NormalizePart("user/avatar.png");
// 拒绝 "../etc/passwd" 等路径穿越输入

// 5. 随机字符串
var options = new RandomStringOptions
{
    Length = 8,
    Kind = RandomStringKind.Alphanumeric,
    ExcludeConfusingCharacters = true
};
string code = SecureRandomStringGenerator.Generate(options);

// 6. IP 地址转换
if ("192.168.1.1".TryToIpUInt32(out uint ipValue)) { }
var (network, mask) = "10.0.0.0/24".ToCidrNetwork();

// 7. 集合操作
new[] { 1, 2, 3 }.ForEach(x => Console.WriteLine(x));
list.AddRange(otherItems);

// 8. 特性获取
typeof(MyEnum).GetFieldAttribute<DescriptionAttribute>("FieldName");

📦 项目结构

BugFree.Core/
├── Attributes/          # 自定义特性
│   └── DisplayAttribute.cs
├── Extensions/          # 扩展方法
│   ├── AttributeExtensions.cs     # 字段特性扩展
│   ├── CodecExtensions.cs         # 编解码扩展
│   ├── CollectionExtensions.cs    # 集合扩展
│   ├── DictionaryExtensions.cs    # 字典扩展
│   ├── EnumExtensions.cs         # 枚举扩展
│   ├── IpConvertExtensions.cs    # IP 地址转换
│   ├── PathSecurityHelper.cs     # 路径安全防护
│   ├── TcpClientExtensions.cs    # TCP 连接检测
│   └── UnitFormatExtensions.cs   # 单位格式化
└── Tools/               # 工具类
    ├── ResourceStressController.cs    # 资源压力测试
    └── SecureRandomStringGenerator.cs # 安全随机字符串

🛠️ 技术要求

• .NET 8.0 / .NET 10.0
• C# 最新语言版本
• 支持 Windows / Linux 跨平台

🤝 参与贡献

1. Fork 本仓库
2. 新建特性分支 (git checkout -b feature/xxx)
3. 提交代码 (git commit -m '添加xxx功能')
4. 推送到分支 (git push origin feature/xxx)
5. 新建 Pull Request

📄 开源协议

本项目基于 MIT 协议开源，详见 LICENSE 文件。

📮 联系我们

• 作者：IoTHub开发团队
• Gitee：https://gitee.com/BugFree_1/BugFree.Core