NFluent 开源项目教程

NFluent 开源项目教程

NFluent Smooth your .NET TDD experience with NFluent! NFluent is an ergonomic assertion library which aims to fluent your .NET TDD experience (based on simple Check.That() assertion statements). NFluent aims your tests to be fluent to write (with a super-duper-happy 'dot' auto-completion experience), fluent to read (i.e. as close as possible to plain English expression), but also fluent to troubleshoot, in a less-error-prone way comparing to the classical .NET test frameworks. NFluent is also directly inspired by the awesome Java FEST Fluent assertion/reflection library (http://fest.easytesting.org/) 项目地址: https://gitcode.com/gh_mirrors/nf/NFluent

1. 项目介绍

NFluent 是一个旨在提升 .NET TDD（测试驱动开发）体验的人机工程学断言库。它基于简单的 Check.That() 断言语句，旨在使您的测试编写流畅、阅读流畅，并且在故障排除时更加流畅。NFluent 的设计灵感来自于 Java 的 FEST Fluent 断言/反射库，致力于成为最流畅的 .NET 断言库。

2. 项目快速启动

安装 NFluent

首先，您需要通过 NuGet 安装 NFluent：

dotnet add package NFluent

编写第一个测试

以下是一个简单的示例，展示了如何使用 NFluent 编写测试：

using NFluent;
using NUnit.Framework;

public class ExampleTests
{
    [Test]
    public void TestArrayContains()
    {
        var integers = new int[] { 1, 2, 3, 4, 5, 666 };
        Check.That(integers).Contains(3, 5, 666);
    }

    [Test]
    public void TestArrayIsOnlyMadeOf()
    {
        var integers = new int[] { 1, 2, 3 };
        Check.That(integers).IsOnlyMadeOf(3, 2, 1);
    }

    [Test]
    public void TestArrayContainsExactly()
    {
        var guitarHeroes = new[] { "Hendrix", "Paco de Lucia", "Django Reinhardt", "Baden Powell" };
        Check.That(guitarHeroes).ContainsExactly("Hendrix", "Paco de Lucia", "Django Reinhardt", "Baden Powell");
    }
}

3. 应用案例和最佳实践

应用案例

NFluent 可以广泛应用于各种 .NET 项目中，特别是在需要编写大量单元测试的场景中。例如，在开发一个复杂的业务逻辑模块时，使用 NFluent 可以确保每个逻辑分支都被正确测试，并且错误消息清晰易懂。

最佳实践

1. 保持测试代码简洁：使用 NFluent 的流畅 API 可以使测试代码更加简洁和易读。
2. 充分利用错误消息：NFluent 的错误消息设计得非常友好，可以帮助您快速定位问题。
3. 扩展 NFluent：如果您需要自定义断言，NFluent 提供了扩展机制，允许您添加自定义的断言方法。

4. 典型生态项目

NFluent 通常与其他 .NET 测试框架（如 NUnit、xUnit 等）一起使用。以下是一些典型的生态项目：

• NUnit：一个广泛使用的 .NET 测试框架，与 NFluent 结合使用可以提供强大的测试能力。
• xUnit：另一个流行的 .NET 测试框架，支持并行测试，与 NFluent 结合使用可以提高测试效率。
• Moq：一个用于模拟对象的库，常用于单元测试中，与 NFluent 结合使用可以更好地测试依赖注入的组件。

通过这些生态项目的结合使用，NFluent 可以帮助您构建一个强大且易于维护的测试套件。

NFluent Smooth your .NET TDD experience with NFluent! NFluent is an ergonomic assertion library which aims to fluent your .NET TDD experience (based on simple Check.That() assertion statements). NFluent aims your tests to be fluent to write (with a super-duper-happy 'dot' auto-completion experience), fluent to read (i.e. as close as possible to plain English expression), but also fluent to troubleshoot, in a less-error-prone way comparing to the classical .NET test frameworks. NFluent is also directly inspired by the awesome Java FEST Fluent assertion/reflection library (http://fest.easytesting.org/) 项目地址: https://gitcode.com/gh_mirrors/nf/NFluent