扩展 xUnit.NET 以在处理类和定位测试方法时使用自定义代码

Question

我是 xUnit.NET 框架的忠实粉丝； 我发现它轻量、简单、干净且可扩展。

现在假设我有一个像这样的类：

public class AdditionSpecification
{
  static int result;

  public void Because()
  {
    result = 2 + 2;
  }

  public void Result_is_non_zero()
  {
    Assert.True(result <> 0);
  }

  public void Result_is_correct()
  {
    Assert.Equal(4, result);
  }
}

对于上面的测试类，我希望 xUnit.NET 查看 2 个测试用例并在每个测试用例之前运行because() 方法。

抛开您对我的类或方法名称、此测试/规范的结构、xUnit.NET 框架或 BDD 可能遇到的任何问题，这是我的问题：

我如何告诉 xUnit.NET 我想要自定义它如何识别并执行此类的测试方法而不在每个目标测试方法上使用自定义的类似[Fact]的属性？

我知道我可以从BeforeAfterAttribute派生来装饰每个测试执行前后具有自定义的方法。 我怎样才能在班级层面做到这一点？ 我必须编写自定义跑步者吗？

Answer 1

xUnit.net 的 IUseFixture 允许您对每个夹具进行设置。 因此，您可以定义自己的固定装置类：

public class AdditionFixture : IDisposable
{
  public int Because() 
  {
    return 2 + 2;
  }

  public void Dispose()
  {
   //test tear down code
  }      
}

然后您的测试类可以实现它（需要实现 setFixture）：

public class AdditionSpecification : IUseFixture<AdditionFixture>
{
  int result;

  public void SetFixture(AdditionFixture Fixture)
  {
   result = Fixture.Because();
  }

  [Fact]
  public void Result_is_non_zero()
  {
   Assert.True(result <> 0);
  }

  [Fact]
  public void Result_is_correct()
  {
   Assert.Equal(4, result);
  }
}

xUnit 运行程序将创建您的固定装置的单个实例，并在运行每个测试之前将其传递到 SetFixture。 运行所有测试后，如果夹具实现了 IDisposable，则运行器将处理该夹具。 我希望这有帮助！

codeplex 上的 xUnit wiki 有更多信息，包括如何实现 IUseFixture 来管理测试装置的数据库连接的一个很好的示例。

Answer 2

所以事实证明我正在寻找 ITestClassCommand.EnumerateTestMethods() 方法。

1. 默认的 xUnit.NET 测试运行器
   将迭代中的所有类
   您的测试组件。
2. 对于每一个，它都会检查 RunWithAttribute；
   这是你重写的机会
   ITestClassCommand 实现
   用于识别方法
   包含测试。 （RunWithNUnit 是一个很好的例子）
3. 调用 ITestClassCommand.EnumerateTestMethods() 来处理测试类并返回测试方法的 IEnumerable。
4. 然后将每个测试 IMethodInfo 传递给 ITestClassCommand.EnumerateTestCommands(IMethodInfo testMethod) 以获取 ITestCommands 的 IEnumerable，
5. 然后执行每个 ITestCommand 并有机会返回结果。

在上面的示例中，我需要类似的东西：

[AttributeUsage(AttributeTargets.Class, AllowMultiple = false)]
public class RunWithMyTestClassCommandAttribute : RunWithAttribute
{
   public RunWithMyTestClassCommandAttribute()
               : base(typeof(MyTestClassCommand)) {}
}

然后我可以用以下内容装饰上面的示例：

[RunWithMyTestClassCommand]
public class AdditionSpecification
{
  static int result;

  public void Because()
  {
    result = 2 + 2;
  }

  public void Result_is_non_zero()
  {
    Assert.True(result <> 0);
  }

  public void Result_is_correct()
  {
    Assert.Equal(4, result);
  }
}

最后，在 MyTestClassCommand 中，我有机会在 EnumerateTestMethods() 和 EnumerateTestCommands(IMethodInfo testMethod) 之间使用我想要查找的任何逻辑并构造作为单独测试执行的 ITestCommand 实例。

顺便说一句，在研究这个问题的过程中，我在 xUnit.NET 框架中遇到了一个小错误，其中由 EnumerateTestMethods() 生成的自定义 IMethodInfo 从未出现在 EnumerateTestCommands(..) 中，因为它被测试解开并重新包装跑步者或其工厂之一。

我向 codeplex 上的 xUnit 项目提交了此问题，它是已于 2009 年 5 月 30 日 更正 xUnit.NET 1.5 CTP 2