FluentAssertions 8.0.0 版本深度解析：现代化断言库的重大升级

项目简介

FluentAssertions 是一个流行的 .NET 断言库，它通过流畅的接口（Fluent Interface）设计让单元测试中的断言语句更加易读和直观。这个库已经成为 .NET 开发者编写测试代码时的首选工具之一，因其优雅的语法和丰富的断言功能而广受好评。

重大变更概览

FluentAssertions 8.0.0 版本是一个重要的里程碑，包含了多项重大变更和新特性，反映了项目向现代化 .NET 生态系统的演进。

许可证变更

项目许可证已更新为 Xceed 社区许可证，这一变更确保了项目的可持续发展和社区参与的自由度。对于企业用户而言，需要仔细评估新许可证对现有项目的影响。

架构重构

1. 模块化拆分：将 DataSet、DataTable 和 DataRow 的支持功能迁移到了独立的 FluentAssertions.DataSets 项目中，这种模块化设计提高了核心库的专注度。

2. API 清理：

   • 移除了过时的 OrEqualTo 方法
   • 删除了 SpacesPerIndentionLevel 配置
   • 不再支持 .NET Core（专注于 .NET 5+）
   • 移除了 NSpec3 支持

3. 行为变更：

   • AllSatisfy 和 OnlyContain 现在对空集合返回成功
   • 移除了二进制格式化支持
   • 改进了 BeUpperCased/BeLowerCased 的语义

4. 命名优化：

   • EquivalencyAssertionOptions 更名为 EquivalencyOptions
   • RespectingRuntimeTypes 和 RespectingDeclaredTypes 重命名以更清晰表达用途
   • ExcludingNestedObjects 改为 WithoutRecursing

核心改进

1. 断言作用域重设计：全新的 AssertionScope 实现改进了在链式调用中的行为传递，使错误报告更加准确。

2. 配置系统重构：重新设计了配置、服务和断言选项的架构，提供了更灵活的自定义方式。

3. 等效性断言增强：

   • 支持通过匿名对象选择排除/包含字段和属性
   • 显式实现的属性现在可以被排除
   • 修复了严格排序中的崩溃问题

新增功能

1. 自定义断言标记：引入了新属性来标记包含自定义断言的程序集，便于组织和发现扩展功能。

2. 全局初始化：通过特性支持断言选项的全局初始化，简化了测试环境的配置。

3. 测试框架支持：

   • 新增对 NUnit4 的完整支持
   • 添加了 TUnit 框架支持
   • 为 xUnit.net v3 提供兼容性

4. 新断言方法：

   • 为 DateTime 添加了 NotBeIn(DateTimeKind) 断言
   • 新增 BeNaN 和 NotBeNaN 数值断言
   • 字符串断言支持指定 EquivalencyOptions

5. 作用域值格式化器：支持限定作用域的值格式化器，提供了更灵活的测试输出控制。

性能优化

1. 集合处理优化：BeEmpty() 现在只对 IEnumerable<T> 进行一次物化，即使在失败情况下也是如此。

2. 类型成员反射：优化了 TypeMemberReflector 的性能，减少了反射开销。

3. 内存分配减少：

   • 改进了链式上下文中的内存分配
   • 使用集合表达式和扩展运算符优化了多处实现

4. 异步处理改进：ThrowWithinAsync 现在正确处理取消的任务。

问题修复

1. 空值处理：

   • 修复了可空 DateTimeOffset 使用 BeWithin/Before 时的格式化错误
   • 修正了自定义比较器处理可空类型的问题

2. 等效性断言：

   • 修复了显式实现成员的发现机制
   • 解决了 ArraySegment 作为类成员时的处理问题
   • 修正了路径报告与自定义映射的兼容性

3. XML 断言：

   • 避免了 HaveElementWithValue 的无效操作异常
   • 新增了大量 XElement 和 XDocument 断言

4. 字符串处理：

   • 修复了 "\\r\\n" 被误认为换行符的问题
   • 添加了忽略换行样式的选项

开发者体验提升

1. 错误信息改进：

   • 为字符串相等断言提供了更清晰的失败消息
   • 改进了 NotBeOfType 和 BeReadable/BeWritable 的错误报告
   • 布尔值在错误消息中现在正确大写

2. 代码质量：

   • 添加了大量 [NotNull] 属性
   • 使用 C# 12 特性重构了多处代码
   • 提高了代码覆盖率，特别是格式化器部分

3. 文档完善：

   • 新增了日期/时间使用技巧
   • 修正了多处文档错误
   • 明确了 ContainEquivalentOf 的注意事项

技术生态适配

1. 构建系统：

   • 升级到 .NET 8 SDK 分析器
   • 使用 NUKE 9 构建系统
   • 支持 CodeQL 扫描

2. 依赖更新：

   • 移除了对旧版 .NET Core 的支持
   • 升级了所有测试框架适配器
   • 更新了分析器工具链

3. 现代化工具：

   • 从 yarn 切换到 npm
   • 使用最新的 Qodana 进行代码质量分析
   • 应用了最新的 C# 语言特性

升级建议

对于现有项目升级到 FluentAssertions 8.0.0，建议采取以下步骤：

1. 评估许可证变更：确认 Xceed 社区许可证符合项目要求。

2. 处理重大变更：

   • 迁移 DataSet 相关断言到 FluentAssertions.DataSets
   • 替换或移除已废弃的 API
   • 检查空集合断言的行为变化

3. 利用新特性：

   • 考虑使用全局初始化简化配置
   • 评估新的断言方法是否可简化现有测试
   • 尝试作用域值格式化器改进测试输出

4. 全面测试：由于核心架构变化，建议进行全面回归测试。

FluentAssertions 8.0.0 代表了该项目向现代化 .NET 生态系统迈进的重要一步，通过架构重构、性能优化和功能增强，为开发者提供了更强大、更可靠的测试工具。这次升级不仅提升了库的内在质量，也为未来的扩展奠定了坚实基础。